Partilhar via


XMLTask Classe

Definição

Contém os membros usados para executar várias tarefas XML, dependendo da propriedade OperationType que é um valor da enumeração DTSXMLOperation. Essa classe não pode ser herdada.

public ref class XMLTask sealed : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSBreakpointSite, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::XMLTask::IDTSXMLTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("BE19D629-EC49-455C-9708-27E3849F3C2A")]
public sealed class XMLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.XMLTask.IDTSXMLTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("935AC7BD-FEBE-4104-9E92-0D04136FFA27")]
public sealed class XMLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.XMLTask.IDTSXMLTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("3A8B754B-0C03-4159-88DA-E3578D25A20B")]
public sealed class XMLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.XMLTask.IDTSXMLTask
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("BE19D629-EC49-455C-9708-27E3849F3C2A")>]
type XMLTask = class
    inherit Task
    interface IDTSXMLTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("935AC7BD-FEBE-4104-9E92-0D04136FFA27")>]
type XMLTask = class
    inherit Task
    interface IDTSXMLTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("3A8B754B-0C03-4159-88DA-E3578D25A20B")>]
type XMLTask = class
    inherit Task
    interface IDTSXMLTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
    interface IDTSComponentPersist
Public NotInheritable Class XMLTask
Inherits Task
Implements IDTSBreakpointSite, IDTSComponentPersist, IDTSXMLTask
Herança
Atributos
Implementações

Comentários

Para obter mais informações, consulte a Tarefa XML.

Construtores

XMLTask()

Inicializa uma nova instância da classe XMLTask.

Propriedades

DebugMode

Um booliano que indica se uma tarefa deve verificar se algum ponto de interrupção está habilitado.

Destination

Obtém ou define o nome da conexão ou a variável na qual a tarefa XML salva os resultados da operação.

DestinationType

Obtém ou define um valor de enumeração DTSXMLSaveResultTo que indica o tipo de destino no qual a tarefa XML salva o documento XML.

DiffAlgorithm

Obtém ou define o algoritmo de comparação a ser usado quando o OperationType é Diff.

DiffGramDestination

Obtém ou define o nome da conexão ou a variável na qual a tarefa XML salva o documento DiffGram.

DiffGramDestinationType

Obtém ou define um valor que indica o tipo de destino no qual a tarefa XML salva o documento DiffGram.

DiffOptions

Obtém ou define um valor que indica as opções que a operação usa ao comparar documentos.

ExecutionValue

Retorna o resultado da execução da tarefa.

FailOnDifference

Obtém ou define um booliano que indica se a tarefa falha se o documento XML não for validado de acordo com o esquema de validação.

FailOnValidationFail

Obtém ou define um booliano que indica se a operação falha quando uma validação falha.

Namespaces

Obtém ou define a coleção de namespaces para a tarefa XML.

NodeList

Obtém uma classe ArrayList que contém uma coleção de nós gerados pela operação XPath.

OperationType

Obtém ou define um valor de enumeração DTSXMLOperation que indica o tipo da operação executada pela tarefa, como validação ou mesclagem.

OverwriteDestination

Obtém ou define um Boolean que indica se a operação substitui os arquivos de destino existentes.

PutResultInOneNode

Obtém ou define um booliano que indica se a operação coloca o resultado em um nó.

SaveDiffGram

Obtém ou define um booliano que indica se o resultado da comparação, um documento DiffGram, é salvo.

SaveOperationResult

Obtém ou define um booliano que indica se a tarefa XML salva a saída da operação Diff.

SecondOperand

Obtém ou define o nome da conexão, a variável ou o texto fornecido pelo usuário que é o segundo operando em uma operação que usa dois operandos. O segundo operando pode ser um documento XML, um DiffGram, um XSLT, um XPath ou um documento de validação, dependendo da operação.

SecondOperandType

Obtém ou define um valor que indica o tipo de origem que contém o documento XML, o DiffGram, o XSLT, o XPath ou o documento de validação, localizado no SecondOperand.

Source

Obtém ou define o nome da conexão, a variável ou o texto fornecido pelo usuário que é a origem usada pela operação.

SourceType

Obtém ou define um valor da enumeração DTSXMLSourceType que indica o tipo da origem que contém o documento XML usado pela operação.

SuspendRequired

Obtém ou define um booliano que indica se as tarefas devem ser suspensas quando encontram um ponto de interrupção. Esse valor é definido pelo mecanismo de runtime para tarefas e contêineres quando um ponto de interrupção é encontrado.

TargetServerVersion

Contém os membros usados para executar várias tarefas XML, dependendo da propriedade OperationType que é um valor da enumeração DTSXMLOperation. Essa classe não pode ser herdada.

(Herdado de Task)
ValidationDetails

Contém os membros usados para executar várias tarefas XML, dependendo da propriedade OperationType que é um valor da enumeração DTSXMLOperation. Essa classe não pode ser herdada.

ValidationType

Obtém ou define um valor da enumeração DTSXMLValidationType que indica o tipo de validação usado pela operação.

Version

Membro preterido; consulte Comentários. *** Retorna a versão da tarefa. Esta propriedade é somente para leitura.

(Herdado de Task)
XPathOperation

Obtém ou define um valor da enumeração DTSXMLXPathOperation que indica a operação XPath a ser executada.

XPathStringSource

Obtém ou define a origem da expressão XPath.

XPathStringSourceType

Obtém ou define um valor da enumeração DTSXMLSourceType que indica o tipo da origem que indica a expressão XPath na propriedade XPathStringSource.

Métodos

AcceptBreakpointManager(BreakpointManager)

Passa um BreakpointManager para uma tarefa. A tarefa usará o gerenciador de ponto de interrupção para criar, remover e verificar o status de pontos de interrupção. Esse método é chamado pelo runtime e não é usado em código.

CanUpdate(String)

Membro preterido; consulte Comentários. Um booliano que indica se o novo XML do pacote pode atualizar o XML do pacote antigo.

(Herdado de Task)
Equals(Object)

Determina se duas instâncias de objeto são iguais.

(Herdado de DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

Executa a tarefa.

GetConnectionID(Connections, String)

Obtém uma cadeia de caracteres que contém a ID da conexão.

(Herdado de Task)
GetConnectionName(Connections, String)

Obtém uma cadeia de caracteres que contém o nome da conexão.

(Herdado de Task)
GetHashCode()

Retorna o código hash para a instância.

(Herdado de DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

Inicializa as propriedades associadas a esta tarefa. Esse método é chamado pelo runtime e não é usado em código.

LoadFromXML(XmlElement, IDTSInfoEvents)

Esse método não pode ser chamado por seu código de aplicativo. Para carregar um pacote salvo como .xml, use o método LoadPackage(String, IDTSEvents).

ResumeExecution()

Retoma a execução da tarefa depois de pausar. A tarefa ou o contêiner é retomado pelo mecanismo de runtime.

SaveToXML(XmlDocument, IDTSInfoEvents)

Esse método não pode ser chamado por seu código de aplicativo. Para salvar um pacote como .xml, use o método SaveToXml(String, Package, IDTSEvents).

SuspendExecution()

Indica se o executável precisa ser suspenso. Esse método é chamado pelo mecanismo de runtime.

Update(String)

Membro preterido; consulte Comentários. Esse método atualiza o XML do pacote antigo com o novo XML do pacote se CanUpdate(String) for definido como true.

(Herdado de Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

Verifica se o componente foi configurado corretamente.

Aplica-se a