Compartilhar via


Classe XMLTask

Contains the members used to run several XML tasks, depending on the OperationType property, which is a value from the DTSXMLOperation enumeration. This class cannot be inherited.

Hierarquia de herança

System. . :: . .Object
  Microsoft.SqlServer.Dts.Runtime. . :: . .DtsObject
    Microsoft.SqlServer.Dts.Runtime. . :: . .Task
      Microsoft.SqlServer.Dts.Tasks.XMLTask..::..XMLTask

Namespace:  Microsoft.SqlServer.Dts.Tasks.XMLTask
Assembly:  Microsoft.SqlServer.XMLTask (em Microsoft.SqlServer.XMLTask.dll)

Sintaxe

'Declaração
<GuidAttribute("0656BAF4-02C2-4413-B57C-77852EA9B106")> _
Public NotInheritable Class XMLTask _
    Inherits Task _
    Implements IDTSXMLTask, IDTSBreakpointSite, IDTSSuspend, IDTSComponentPersist
'Uso
Dim instance As XMLTask
[GuidAttribute("0656BAF4-02C2-4413-B57C-77852EA9B106")]
public sealed class XMLTask : Task, 
    IDTSXMLTask, IDTSBreakpointSite, IDTSSuspend, IDTSComponentPersist
[GuidAttribute(L"0656BAF4-02C2-4413-B57C-77852EA9B106")]
public ref class XMLTask sealed : public Task, 
    IDTSXMLTask, IDTSBreakpointSite, IDTSSuspend, IDTSComponentPersist
[<SealedAttribute>]
[<GuidAttribute("0656BAF4-02C2-4413-B57C-77852EA9B106")>]
type XMLTask =  
    class
        inherit Task
        interface IDTSXMLTask
        interface IDTSBreakpointSite
        interface IDTSSuspend
        interface IDTSComponentPersist
    end
public final class XMLTask extends Task implements IDTSXMLTask, IDTSBreakpointSite, IDTSSuspend, IDTSComponentPersist

O tipo XMLTask expõe os membros a seguir.

Construtores

  Nome Descrição
Método público XMLTask Initializes a new instance of the XMLTask class.

Início

Propriedades

  Nome Descrição
Propriedade pública DebugMode A Boolean that indicates if a task should check if any breakpoints are enabled.
Propriedade pública Destination Gets or sets the name of the connection or the variable to which the XML task saves the results of the operation.
Propriedade pública DestinationType Gets or sets a DTSXMLSaveResultTo enumeration value that indicates the type of destination to which the XML task saves the XML document.
Propriedade pública DiffAlgorithm Gets or sets the comparison algorithm to use when the OperationType is Diff.
Propriedade pública DiffGramDestination Gets or sets the name of the connection or the variable to which the XML task saves the DiffGram document.
Propriedade pública DiffGramDestinationType Gets or sets a value that indicates the type of destination to which the XML task saves the DiffGram document.
Propriedade pública DiffOptions Gets or sets a value that indicates the options the operation uses when comparing documents.
Propriedade pública ExecutionValue Returns the result of the task execution. (Substitui Task. . :: . .ExecutionValue.)
Propriedade pública FailOnDifference Gets or sets a Boolean that indicates whether the task fails if the XML document fails to validate according to the validation schema.
Propriedade pública FailOnValidationFail Gets or sets a Boolean that indicates whether the operation fails when a validation fails.
Propriedade pública NodeList Gets an ArrayList class that contains a collection of nodes that the XPath operation produces.
Propriedade pública OperationType Gets or sets a DTSXMLOperation enumeration value that indicates the type of the operation that the task performs, such as validation or merging.
Propriedade pública OverwriteDestination Gets or sets a Boolean that indicates whether the operation overwrites existing destination files.
Propriedade pública PutResultInOneNode Gets or sets a Boolean that indicates whether the operation places the result in one node.
Propriedade pública SaveDiffGram Gets or sets a Boolean that indicates whether the comparison result, a DiffGram document, is saved.
Propriedade pública SaveOperationResult Gets or sets a Boolean that indicates whether the XML task saves the Diff operation output.
Propriedade pública SecondOperand Gets or sets the name of the connection, the variable, or the user-provided text that is the second operand in an operation that uses two operands. The second operand may be an XML document, a DiffGram, an XSLT, an XPath, or a validating document, depending on the operation.
Propriedade pública SecondOperandType Gets or sets a value that indicates the type of source that contains the XML document, the DiffGram, the XSLT, the XPath, or the validating document, found in the SecondOperand.
Propriedade pública Source Gets or sets the name of the connection, the variable, or the user-provided text that is the source the operation uses.
Propriedade pública SourceType Gets or sets a value from the DTSXMLSourceType enumeration that indicates the type of source that contains the XML document the operation uses.
Propriedade pública SuspendRequired Gets or sets a Boolean that indicates if tasks should suspend when they encounter a breakpoint. This value is set by the runtime engine for tasks and containers when a breakpoint is encountered.
Propriedade pública ValidationType Gets or sets a DTSXMLValidationType enumeration value that indicates the type of validation the operation uses.
Propriedade pública Version *** Member deprecated; see Remarks. ***    Returns the version of the task. This property is read-only. (Herdado de Task.)
Propriedade pública XPathOperation Gets or sets a DTSXMLXPathOperation enumeration value that indicates the XPath operation to perform.
Propriedade pública XPathStringSource Gets or sets the source of the XPath expression.
Propriedade pública XPathStringSourceType Gets or sets a value from the DTSXMLSourceType enumeration that indicates the type of the source that contains the XPath expression in the XPathStringSource property.

Início

Métodos

  Nome Descrição
Método público AcceptBreakpointManager Passes a BreakpointManager to a task. The task will use the breakpoint manager to create, remove, and check the status of breakpoints. This method is called by the runtime and is not used in code.
Método público CanUpdate *** Member deprecated; see Remarks. ***    A Boolean that indicates whether the new package XML can update the old package XML. (Herdado de Task.)
Método público Equals Determines whether two object instances are equal. (Herdado de DtsObject.)
Método público Execute Runs the task. (Substitui Task. . :: . .Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object).)
Método protegido Finalize (Herdado de Object.)
Método público GetConnectionID Gets a String containing the ID of the connection. (Herdado de Task.)
Método público GetConnectionName Gets a String containing the name of the connection. (Herdado de Task.)
Método público GetHashCode Returns the hash code for this instance. (Herdado de DtsObject.)
Método público GetType (Herdado de Object.)
Método público InitializeTask Initializes the properties associated with this task. This method is called by the runtime and is not used in code. (Substitui Task. . :: . .InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker).)
Método público LoadFromXML This method is not callable by your application code. To load a package saved as .xml, use the Application..::..LoadPackage method.
Método protegido MemberwiseClone (Herdado de Object.)
Método público ResumeExecution Resumes execution of the task after pausing. The task or container is resumed by the runtime engine.
Método público SaveToXML This method is not callable by your application code. To save a package as .xml, use the Application..::..SaveToXml method.
Método público SuspendExecution Indicates that the executable needs to suspend. This method is called by the runtime engine.
Método público ToString (Herdado de Object.)
Método público Update *** Member deprecated; see Remarks. ***    This method updates the old package XML with the new package XML if CanUpdate is set to true. (Herdado de Task.)
Método público Validate Verifies that the component is properly configured. (Substitui Task. . :: . .Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging).)

Início

Comentários

For more information, see Tarefa XML.

Segurança de thread

Qualquer membro público static (Shared no Visual Basic) desse tipo é seguro para threads. Não há garantia de que qualquer membro de instância seja seguro para threads.