XMLTask Classe

Definizione

Contiene i membri utilizzati per eseguire diversi compiti XML, a seconda della OperationType proprietà, che è un valore dell'enumerazione DTSXMLOperation . La classe non può essere ereditata.

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
Ereditarietà
Attributi
Implementazioni

Commenti

Per ulteriori informazioni, vedi XML Task.

Costruttori

Nome Descrizione
XMLTask()

Inizializza una nuova istanza della classe XMLTask.

Proprietà

Nome Descrizione
DebugMode

Un booleano che indica se un compito deve controllare se ci sono punti di interruzione abilitati.

Destination

Ottiene o imposta il nome della connessione o della variabile a cui il compito XML salva i risultati dell'operazione.

DestinationType

Ottiene o imposta un DTSXMLSaveResultTo valore di enumerazione che indica il tipo di destinazione in cui il compito XML salva il documento XML.

DiffAlgorithm

Ottiene o imposta l'algoritmo di confronto per usare quando è Diff.OperationType

DiffGramDestination

Ottiene o imposta il nome della connessione o della variabile a cui il compito XML salva il documento DiffGram.

DiffGramDestinationType

Ottiene o imposta un valore che indica il tipo di destinazione a cui il compito XML salva il documento DiffGram.

DiffOptions

Ottiene o imposta un valore che indica le opzioni che l'operazione utilizza nel confronto dei documenti.

ExecutionValue

Restituisce il risultato dell'esecuzione del compito.

FailOnDifference

Ottiene o imposta un Booleano che indica se il compito fallisce se il documento XML non si convalida secondo lo schema di validazione.

FailOnValidationFail

Ottiene o imposta un booleano che indica se l'operazione fallisce quando una validazione fallisce.

Namespaces

Ottiene o imposta la collezione di namespace per il compito XML.

NodeList

Ottiene una classe ArrayList che contiene una collezione di nodi prodotti dall'operazione XPath.

OperationType

Ottiene o imposta un DTSXMLOperation valore di enumerazione che indica il tipo di operazione che il compito esegue, come la validazione o la fusione.

OverwriteDestination

Ottiene o imposta un Booleano che indica se l'operazione sovrascrive i file di destinazione esistenti.

PutResultInOneNode

Ottiene o imposta un booleano che indica se l'operazione colloca il risultato in un nodo.

SaveDiffGram

Ottiene o imposta un Booleano che indica se il risultato del confronto, un documento DiffGram, è salvato.

SaveOperationResult

Ottiene o imposta un Boolean che indica se il task XML salva l'output dell'operazione Diff.

SecondOperand

Ottiene o imposta il nome della connessione, della variabile o del testo fornito dall'utente che è il secondo operando in un'operazione che utilizza due operandi. Il secondo operando può essere un documento XML, un DiffGram, un XSLT, un XPath o un documento di validazione, a seconda dell'operazione.

SecondOperandType

Ottiene o imposta un valore che indica il tipo di sorgente che contiene il documento XML, il DiffGram, l'XSLT, l'XPath o il documento di validazione, trovato nel SecondOperand.

Source

Ottiene o imposta il nome della connessione, della variabile o del testo fornito dall'utente che è la sorgente utilizzata dall'operazione.

SourceType

Ottiene o imposta un valore dall'enumerazione DTSXMLSourceType che indica il tipo di sorgente che contiene il documento XML utilizzato dall'operazione.

SuspendRequired

Ottiene o imposta un Booleano che indica se i compiti devono sospendere quando incontrano un punto di interruzione. Questo valore viene impostato dal motore di esecuzione per compiti e container quando si incontra un punto di interruzione.

TargetServerVersion

Contiene i membri utilizzati per eseguire diversi compiti XML, a seconda della OperationType proprietà, che è un valore dell'enumerazione DTSXMLOperation . La classe non può essere ereditata.

(Ereditato da Task)
ValidationDetails

Contiene i membri utilizzati per eseguire diversi compiti XML, a seconda della OperationType proprietà, che è un valore dell'enumerazione DTSXMLOperation . La classe non può essere ereditata.

ValidationType

Ottiene o imposta un DTSXMLValidationType valore di enumerazione che indica il tipo di validazione utilizzata dall'operazione.

Version

Membro deprecato; vedi Osservazioni. Restituisce la versione del compito. Questa proprietà è di sola lettura.

(Ereditato da Task)
XPathOperation

Ottiene o imposta un DTSXMLXPathOperation valore di enumerazione che indica l'operazione XPath da eseguire.

XPathStringSource

Ottiene o imposta la sorgente dell'espressione XPath.

XPathStringSourceType

Ottiene o imposta un valore dall'enumerazione DTSXMLSourceType che indica il tipo della sorgente che contiene l'espressione XPath nella XPathStringSource proprietà.

Metodi

Nome Descrizione
AcceptBreakpointManager(BreakpointManager)

Passa a BreakpointManager un compito. Il compito utilizzerà il gestore dei punti interruzioni per creare, rimuovere e controllare lo stato dei punti di interruzione. Questo metodo è chiamato dal runtime e non viene utilizzato nel codice.

CanUpdate(String)

Membro deprecato; vedi Osservazioni. Un Booleano che indica se il nuovo XML del pacchetto può aggiornare il vecchio XML del pacchetto.

(Ereditato da Task)
Equals(Object)

Determina se due istanze dell'oggetto sono uguali.

(Ereditato da DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

Gestisce il compito.

GetConnectionID(Connections, String)

Ottiene una stringa contenente l'ID della connessione.

(Ereditato da Task)
GetConnectionName(Connections, String)

Ottiene una stringa che contiene il nome della connessione.

(Ereditato da Task)
GetHashCode()

Restituisce il codice hash per questa istanza.

(Ereditato da DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

Inizializza le proprietà associate a questo compito. Questo metodo è chiamato dal runtime e non viene utilizzato nel codice.

LoadFromXML(XmlElement, IDTSInfoEvents)

Questo metodo non è richiamabile dal codice applicativo. Per caricare un pacco salvato come .xml, usa il LoadPackage(String, IDTSEvents) metodo.

ResumeExecution()

Riprende l'esecuzione del compito dopo la pausa. Il compito o il contenitore viene ripreso dal motore di runtime.

SaveToXML(XmlDocument, IDTSInfoEvents)

Questo metodo non è richiamabile dal codice applicativo. Per salvare un pacchetto come .xml, usa il SaveToXml(String, Package, IDTSEvents) metodo.

SuspendExecution()

Indica che l'eseguibile deve essere sospeso. Questo metodo è chiamato dal motore di runtime.

Update(String)

Membro deprecato; vedi Osservazioni. Questo metodo aggiorna il vecchio pacchetto XML con il nuovo pacchetto XML se CanUpdate(String) è impostato su true.

(Ereditato da Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

Verifica che il componente sia configurato correttamente.

Si applica a