XMLTask Classe

Definizione

Contiene i membri utilizzati per eseguire diverse attività XML, a seconda della proprietà OperationType che rappresenta 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 altre informazioni, vedere Attività XML.

Costruttori

XMLTask()

Inizializza una nuova istanza della classe XMLTask.

Proprietà

DebugMode

Valore booleano che indica se un'attività deve verificare se sono abilitati punti di interruzione.

Destination

Ottiene o imposta il nome della connessione o della variabile in cui l'attività XML salva i risultati dell'operazione.

DestinationType

Ottiene o imposta un valore dell'enumerazione DTSXMLSaveResultTo che indica il tipo di destinazione in cui l'attività XML salva il documento XML.

DiffAlgorithm

Ottiene o imposta l'algoritmo di confronto da utilizzare quando OperationType è Diff.

DiffGramDestination

Ottiene o imposta il nome della connessione o della variabile in cui l'attività XML salva il documento DiffGram.

DiffGramDestinationType

Ottiene o imposta un valore che indica il tipo di destinazione in cui l'attività XML salva il documento DiffGram.

DiffOptions

Ottiene o imposta un valore che indica le opzioni utilizzate dall'operazione durante il confronto di documenti.

ExecutionValue

Restituisce il risultato dell'esecuzione dell'attività.

FailOnDifference

Ottiene o imposta un valore booleano che indica se l'attività ha esito negativo se il documento XML non riesce a convalidare in base allo schema di convalida.

FailOnValidationFail

Ottiene o imposta un valore booleano che indica se l'operazione ha esito negativo quando una convalida ha esito negativo.

Namespaces

Ottiene o imposta la raccolta di spazi dei nomi per l'attività XML.

NodeList

Ottiene una classe ArrayList contenente una raccolta di nodi prodotti dall'operazione XPath.

OperationType

Ottiene o imposta un valore dell'enumerazione DTSXMLOperation che indica il tipo di operazione eseguita dall'attività, ad esempio convalida o unione.

OverwriteDestination

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

PutResultInOneNode

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

SaveDiffGram

Ottiene o imposta un valore booleano che indica se il risultato del confronto, un documento DiffGram, viene salvato.

SaveOperationResult

Ottiene o imposta un valore booleano che indica se l'attività XML salva l'output dell'operazione Diff.

SecondOperand

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

SecondOperandType

Ottiene o imposta un valore che indica il tipo di origine contenente il documento XML, DiffGram, XSLT, XPath o il documento di convalida individuato in SecondOperand.

Source

Ottiene o imposta il nome della connessione, della variabile o del testo fornito dall'utente che rappresenta l'origine utilizzata dall'operazione.

SourceType

Ottiene o imposta un valore dell'oggetto DTSXMLSourceType che indica il tipo di origine contenente il documento XML utilizzato dall'operazione.

SuspendRequired

Ottiene o imposta un valore booleano che indica se le attività devono essere sospese quando rilevano un punto di interruzione. Questo valore viene impostato dal motore di runtime per le attività e i contenitori quando viene rilevato un punto di interruzione.

TargetServerVersion

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

(Ereditato da Task)
ValidationDetails

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

ValidationType

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

Version

*** Membro deprecato; vedere la sezione Osservazioni. Restituisce la versione dell'attività. Questa proprietà è di sola lettura.

(Ereditato da Task)
XPathOperation

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

XPathStringSource

Ottiene o imposta l'origine dell'espressione XPath.

XPathStringSourceType

Ottiene o imposta un valore dell'enumerazione DTSXMLSourceType che indica il tipo dell'origine contenente l'espressione XPath nella proprietà XPathStringSource.

Metodi

AcceptBreakpointManager(BreakpointManager)

Passa un oggetto BreakpointManager a un'attività. L'attività utilizzerà la gestione punti di interruzione per creare, rimuovere e verificare lo stato dei punti di interruzione. Questo metodo viene chiamato dal runtime e non è utilizzato nel codice.

CanUpdate(String)

*** Membro deprecato; vedere la sezione Osservazioni. Valore booleano che indica se il nuovo xml del pacchetto può aggiornare il codice XML del pacchetto precedente.

(Ereditato da Task)
Equals(Object)

Determina se due istanze di un oggetto sono uguali.

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

Esegue l'attività.

GetConnectionID(Connections, String)

Ottiene una stringa contenente l'ID della connessione.

(Ereditato da Task)
GetConnectionName(Connections, String)

Ottiene una stringa contenente il nome della connessione.

(Ereditato da Task)
GetHashCode()

Restituisce il codice hash per l'istanza.

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

Inizializza le proprietà associate all'attività. Questo metodo viene chiamato dal runtime e non è utilizzato nel codice.

LoadFromXML(XmlElement, IDTSInfoEvents)

Non è possibile chiamare questo metodo dal codice dell'applicazione. Per caricare un pacchetto salvato come file con estensione xml, utilizzare il metodo LoadPackage(String, IDTSEvents).

ResumeExecution()

Riprende l'esecuzione dell'attività dopo la sospensione. L'attività o il contenitore viene ripreso dal motore di runtime.

SaveToXML(XmlDocument, IDTSInfoEvents)

Non è possibile chiamare questo metodo dal codice dell'applicazione. Per salvare un pacchetto come file con estensione xml, utilizzare il metodo SaveToXml(String, Package, IDTSEvents).

SuspendExecution()

Indica la necessità di sospendere l'eseguibile. Questo metodo viene chiamato dal motore di runtime.

Update(String)

*** Membro deprecato; vedere la sezione Osservazioni. Questo metodo aggiorna il codice XML del pacchetto precedente con il nuovo codice XML del pacchetto se CanUpdate(String) è impostato su true.

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

Verifica che il componente sia configurato correttamente.

Si applica a