Application.UpdateObjects Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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 false
e 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.