Application.UpdateObjects Propriedade

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Membro preterido; ver Comentários. Obtém ou define um Boolean que indica se objetos extensíveis podem ser atualizados no tempo de carregamento do pacote se uma versão atualizada for encontrada.

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

Valor da propriedade

Boolean

true se objetos extensíveis podem ser atualizados no tempo de carregamento do pacote quando uma versão atualizada é encontrada; caso contrário, false.

Exemplos

O exemplo de código a seguir mostra como alternar a UpdateObjects propriedade para habilitar ou impedir atualizações. Ele define como UpdateObjectstrue, imprime o valor da propriedade, define-o falsee imprime o valor novamente.

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  

Saída de exemplo:

True

False

Comentários

Observação

Esse membro será removido em uma versão futura do MicrosoftSQL Server. Evite usar esse membro em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse membro.

Quando novas versões de objetos extensíveis, como as tarefas, Foreach enumeradores, provedores de log e gerenciadores de conexões ficam disponíveis, os pacotes existentes podem ser atualizados no tempo de carga para fazer referência aos novos objetos. Você pode fazer isso definindo o UpdateObjects para true antes de carregar o pacote.

Cada objeto extensível implementa uma CanUpdate propriedade. O runtime tenta carregar o pacote existente e, se encontrar uma referência a um objeto mais antigo, o pacote tentará atualizar suas referências. Ele primeiro enumera todos os objetos extensíveis que contém, excluindo o Pipeline, que é tratado separadamente e localmente, e para cada objeto, chama CanUpdate o novo objeto passando a ID do antigo. Se o novo objeto puder atualizar o objeto antigo, o objeto antigo será passado para o novo por meio do Update método e o XML será alterado no local. Por padrão, todos os objetos extensíveis são implementados CanUpdate para retornar false, nesse caso Update , não fazem nada para o XML que é passado.