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, который обрабатывается отдельно и локально, и для каждого объекта вызывает CanUpdate новый объект, передающий ID старого. Если новый объект может обновить старый объект, старый объект передаётся новому через метод Update , и XML меняется на месте. По умолчанию все расширяемые объекты реализуют CanUpdate для возврата false, в этом случае Update ничего не делают с переданным XML.