言語

Application.UpdateObjects プロパティ

定義

名前空間:
Microsoft.SqlServer.Dts.Runtime
アセンブリ:
Microsoft.SqlServer.ManagedDTS.dll

メンバーは棄権しました;「注釈」を参照してください。 拡張可能なオブジェクトがパッケージロード時に更新可能かどうかを示すブール値を取得または設定します。

public:
 property bool UpdateObjects { bool get(); void set(bool value); };
public bool UpdateObjects { get; set; }
member this.UpdateObjects : bool with get, set
Public Property UpdateObjects As Boolean

プロパティ値

Boolean

拡張可能なオブジェクトがパッケージロード時に更新可能なバージョンが見つかった場合、そうでなければ、誤りです。

例

以下のコード例は、 UpdateObjects プロパティを切り替えて更新を有効または防止する方法を示しています。 UpdateObjectsをtrueに設定し、プロパティの値をfalseにして、再度値を出力します。

class ApplicationTests  
    {  
        static void Main(string[] args)  
        {  
            Application app = new Application();  

            Boolean updateObjs = true;  
            app.UpdateObjects = updateObjs;  
            Console.WriteLine(app.UpdateObjects);  

            updateObjs = false;  
            app.UpdateObjects = updateObjs;  
            Console.WriteLine(app.UpdateObjects);  
        }  
    }  

Class ApplicationTests  
        Shared  Sub Main(ByVal args() As String)  
            Dim app As Application =  New Application()   

            Dim updateObjs As Boolean =  True   
            app.UpdateObjects = updateObjs  
            Console.WriteLine(app.UpdateObjects)  

            updateObjs = False  
            app.UpdateObjects = updateObjs  
            Console.WriteLine(app.UpdateObjects)  
        End Sub  
End Class

出力例:

True

False

注釈

Note

このメンバーは将来のMicrosoftSQL Serverバージョンで削除される予定です。 新しい開発作業ではこのメンバーの使用を避け、現在このメンバーを使用しているアプリケーションを修正する計画を立ててください。

タスク、 Foreach 列挙器、ログプロバイダー、接続管理者などの拡張可能なオブジェクトの新しいバージョンが利用可能になると、既存のパッケージをロード時に更新して新しいオブジェクトを参照することができます。 パッケージを読み込む前に UpdateObjects を true に設定することでこれが可能です。

各拡張可能なオブジェクトは CanUpdate プロパティを実装しています。 ランタイムは既存のパッケージを読み込もうとし、古いオブジェクトへの参照を見つけた場合、そのパッケージは参照を更新しようとします。 まず、 Pipelineを除き含むすべての拡張可能なオブジェクトを列挙し、は別々かつ局所的に扱われます。そして各オブジェクトに対して、新しいオブジェクトに対して古いオブジェクトのIDを渡して CanUpdate を呼び出します。 新しいオブジェクトが古いオブジェクトを更新できる場合、古いオブジェクトは Update メソッドを通じて新しいオブジェクトに渡され、XMLはその場で変更されます。 デフォルトでは、すべての拡張可能オブジェクトはfalseを返すCanUpdateを実装しており、その場合Update渡されたXMLには何も影響しません。

適用対象