Application.UpdatePackage Property

更新バージョンが検出されたときにパッケージを更新できるかどうかを示す Boolean を取得します。値の設定も可能です。

名前空間: Microsoft.SqlServer.Dts.Runtime
アセンブリ: Microsoft.SqlServer.ManagedDTS (microsoft.sqlserver.manageddts.dll 内)

構文

'宣言
Public Property UpdatePackage As Boolean

public bool UpdatePackage { get; set; }

public:
property bool UpdatePackage {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_UpdatePackage ()

/** @property */
public void set_UpdatePackage (boolean value)

public function get UpdatePackage () : boolean

public function set UpdatePackage (value : boolean)

プロパティ値

更新バージョンが検出されたときにパッケージを更新できる場合は true です。それ以外の場合は false です。既定値は false です。

解説

タスク、Foreach 列挙子、ログ プロバイダ、および接続マネージャなどの拡張可能なオブジェクトが更新される場合、古いパッケージは読み込み時に更新できます。このような処理が行われるようにするには、読み込み前にアプリケーション オブジェクトで UpdatePackage と UpdateObjects という 2 つのプロパティを true に設定する必要があります。

また、拡張可能な各オブジェクトは CanUpdate プロパティも実装する必要があります。

ランタイムは、古いパッケージの読み込みを試みます。古いオブジェクトを検出した場合は、更新を試みます。まず、(個別にローカルに扱われる Pipeline を除外して) このランタイムに含まれているすべての拡張可能なオブジェクトを列挙します。次に、オブジェクトごとに、新しいオブジェクトで古いオブジェクトの ID を渡しながら CanUpdate を呼び出します。新しいオブジェクトが古いオブジェクトを更新できる場合、古いオブジェクトが Update メソッドによって新しいオブジェクトに渡され、そのオブジェクトの XML が適切な場所に変更されます。既定では、すべての拡張可能なオブジェクトが CanUpdate を実装して false を返します。このため、渡される XML は更新されません。

使用例

次のコード例では、更新を有効および無効にします。UpdatePackage を true に設定し、値を出力してから、このプロパティの値を false にリセットして、この値を再度出力します。

class ApplicationTests
    {
        static void Main(string[] args)
        {
            Application app = new Application();
           
            Boolean updatePkg = true;
            app.UpdatePackage = updatePkg;
            Console.WriteLine(app.UpdatePackage);

            updatePkg = false;
            app.UpdatePackage = updatePkg;
            Console.WriteLine(app.UpdatePackage);
        }
    }

Class ApplicationTests
        Shared  Sub Main(ByVal args() As String)
            Dim app As Application = New Application() 
 
            Dim updatePkg As Boolean = True 
            app.UpdatePackage = updatePkg
            Console.WriteLine(app.UpdatePackage)
 
            updatePkg = False
            app.UpdatePackage = updatePkg
            Console.WriteLine(app.UpdatePackage)
        End Sub
End Class

サンプルの出力 :

True

False

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

Application Class
Application Members
Microsoft.SqlServer.Dts.Runtime Namespace