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

如果找到更新版本時，可以在封裝載入時間更新可延伸的物件，則為 true。否則為 false。

範例

下列程式碼範例顯示如何切換 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

備註

注意

此成員將會在未來的版本中移除 Microsoft SQL Server 。 請避免在新的開發工作中使用這個成員，並規劃修改目前使用這個成員的應用程式。

當新版本的可延伸物件（例如工作、 Foreach 列舉值、記錄提供者和連線管理員）可供使用時，可以在載入時更新現有的封裝，以參考新的物件。 若要這麼做，您可以 UpdateObjects 在 true 載入封裝之前將設定為。

每個可延伸的物件都會實作為 CanUpdate 屬性。 執行時間會嘗試載入現有的封裝，如果找到較舊物件的參考，封裝就會嘗試更新其參考。 它會先列舉它包含的所有可延伸的物件，但 Pipeline 不包括（個別和本機處理），以及針對每個物件，會 CanUpdate 在傳遞舊物件的識別碼的新物件上呼叫。 如果新物件可以更新舊的物件，就會透過方法將舊的物件傳遞給新的物件， Update 而 XML 會就地變更。 依預設，所有可延伸的物件都會執行 CanUpdate false ，在這種情況下， Update 不會對傳遞的 XML 執行任何動作。

適用於