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 属性以启用或阻止更新。 它将 设置为 UpdateObjectstrue，打印属性值，设为 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 to true 来实现。

每个可扩展对象都实现了一个 CanUpdate 属性。 运行时尝试加载现有包，如果发现对较旧对象的引用，包会尝试更新其引用。 它首先枚举包含的所有可扩展对象，排除 Pipeline，后者被单独且局部处理，并对每个对象调用 CanUpdate 新对象，传递旧对象的 ID。 如果新对象能更新旧对象，旧对象通过该 Update 方法传递给新对象，XML 也会在原地更改。 默认情况下，所有可扩展对象都实现 CanUpdate 返回 false，此时 Update 对传递的 XML 不做任何处理。