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 . Он задает 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

Комментарии

Примечание

Этот элемент будет удален в будущей версии MicrosoftSQL Server. Избегайте использования этого члена в новой работе по разработке и планируйте изменение приложений, которые в настоящее время используют этот элемент.

Когда становятся доступны новые версии расширяемых объектов, таких как задачи, перечислители, Foreach поставщики журналов и диспетчеры соединений, существующие пакеты можно обновлять во время загрузки, чтобы ссылаться на новые объекты. Это можно сделать, задав UpdateObjects для этого значение true перед загрузкой пакета.

Каждый расширяемый CanUpdate объект реализует свойство. Среда выполнения пытается загрузить существующий пакет и, если он находит ссылку на старый объект, пакет пытается обновить его ссылки. Сначала он перечисляет все расширяемые объекты, которые он содержит, за исключением Pipelineобъектов, которые обрабатываются отдельно и локально, а для каждого объекта вызывают CanUpdate новый объект, передав идентификатор старого. Если новый объект может обновить старый объект, старый объект передается в новый Update через метод, и XML-код изменяется на месте. По умолчанию все расширяемые объекты реализуются CanUpdate для возврата false, в этом случае Update ничего не делает в переданном XML-коде.

Применяется к