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 to 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

注解

注意

此成员将在 MicrosoftSQL Server 的未来版本中删除。 避免在新开发工作中使用此成员，并计划修改当前使用此成员的应用程序。

当新版本的可扩展对象（如任务、枚举器、 Foreach 日志提供程序和连接管理器）可用时，可以在加载时更新现有包来引用新对象。 可以通过在加载包之前设置 UpdateObjects to true 来执行此操作。

每个可扩展对象实现一个 CanUpdate 属性。 运行时尝试加载现有包，如果它找到对较旧对象的引用，包会尝试更新其引用。 它首先枚举它包含的所有可扩展对象，不包括 Pipeline单独处理和本地处理的对象，以及对于每个对象，对传递旧对象 ID 的新对象调用 CanUpdate 。 如果新对象可以更新旧对象，则旧对象将通过 Update 该方法传递到新对象，并就地更改 XML。 默认情况下，所有可扩展对象实现CanUpdate返回，在这种情况下Update，不会对false传递的 XML 执行任何操作。