Freigeben über


XMLTask Klasse

Definition

Enthält je nach OperationType-Eigenschaft, bei der es sich um einen Wert aus der DTSXMLOperation-Enumeration handelt, die Elemente, mit denen mehrere XML-Tasks ausgeführt werden. Diese Klasse kann nicht vererbt werden.

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
Vererbung
Attribute
Implementiert

Hinweise

Weitere Informationen finden Sie unter XML-Aufgabe.

Konstruktoren

XMLTask()

Initialisiert eine neue Instanz der XMLTask-Klasse.

Eigenschaften

DebugMode

Ein boolescher Wert, der angibt, ob eine Aufgabe überprüfen soll, ob Haltepunkte aktiviert sind.

Destination

Ruft den Namen der Verbindung oder Variablen ab, in der die Ergebnisse des Vorgangs vom XML-Task gespeichert werden, oder legt ihn fest.

DestinationType

Ruft einen DTSXMLSaveResultTo-Enumerationswert ab, der den Typ des Ziels angibt, in dem das XML-Dokument vom XML-Task gespeichert wird, oder legt ihn fest.

DiffAlgorithm

Ruft den Vergleichsalgorithmus ab, der verwendet werden soll, wenn OperationType auf Diff festgelegt ist, oder legt ihn fest.

DiffGramDestination

Ruft den Namen der Verbindung oder Variablen ab, in der das DiffGram-Dokument vom XML-Task gespeichert wird, oder legt ihn fest.

DiffGramDestinationType

Ruft einen Wert ab, der den Typ des Ziels angibt, in dem das DiffGram-Dokument vom XML-Task gespeichert wird, oder legt ihn fest.

DiffOptions

Ruft einen Wert ab, der die Optionen angibt, die vom Vorgang beim Dokumentvergleich verwendet werden, oder legt ihn fest.

ExecutionValue

Gibt das Ergebnis der Taskausführung zurück.

FailOnDifference

Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob die Aufgabe fehlschlägt, wenn das XML-Dokument nicht gemäß dem Überprüfungsschema überprüft werden kann.

FailOnValidationFail

Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob der Vorgang fehlschlägt, wenn eine Überprüfung fehlschlägt.

Namespaces

Ruft die Namespace-Auflistung für den XML-Task ab oder legt sie fest.

NodeList

Ruft eine ArrayList-Klasse ab, die eine Auflistung der durch den XPath-Vorgang erzeugten Knoten enthält.

OperationType

Ruft einen DTSXMLOperation-Enumerationswert ab, der den Typ des vom Task ausgeführten Vorgangs angibt (z. B. Überprüfung oder Zusammenführen), oder legt ihn fest.

OverwriteDestination

Dient zum Abrufen oder Festlegen eines Booleschen Werts, der angibt, ob der Vorgang vorhandene Zieldateien überschreibt.

PutResultInOneNode

Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob der Vorgang das Ergebnis in einem Knoten platziert.

SaveDiffGram

Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob das Vergleichsergebnis, ein DiffGram-Dokument, gespeichert wird.

SaveOperationResult

Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob die XML-Aufgabe die Diff-Vorgangsausgabe speichert.

SecondOperand

Ruft den Namen der Verbindung, die Variable oder den vom Benutzer bereitgestellten Text ab, wobei es sich um den zweiten Operanden in einem Vorgang mit zwei Operanden handelt, oder legt ihn fest. Der zweite Operand kann je nach Vorgang Folgendes darstellen: XML-Dokument, DiffGram, XSLT, XPath oder Dokument für eine Überprüfung.

SecondOperandType

Ruft einen Wert ab, der den Typ der Quelle angibt, in der das XML-Dokument, das DiffGram-, XSLT- oder XPath-Objekt bzw. das Dokument für die Überprüfung enthalten ist, das sich in SecondOperand befindet, oder legt ihn fest.

Source

Ruft den Namen der Verbindung, der Variablen oder den vom Benutzer bereitgestellten Text ab, die bzw. der die vom Vorgang verwendete Quelle darstellt, oder legt ihn fest.

SourceType

Ruft einen Wert aus der DTSXMLSourceType-Enumeration ab, der den Typ der Quelle angibt, die das vom Vorgang verwendete XML-Dokument enthält, oder legt ihn fest.

SuspendRequired

Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob Vorgänge angehalten werden sollen, wenn ein Haltepunkt auftritt. Dieser Wert wird von der Runtime-Engine für Tasks und Container festgelegt, wenn ein Breakpoint erreicht wird.

TargetServerVersion

Enthält je nach OperationType-Eigenschaft, bei der es sich um einen Wert aus der DTSXMLOperation-Enumeration handelt, die Elemente, mit denen mehrere XML-Tasks ausgeführt werden. Diese Klasse kann nicht vererbt werden.

(Geerbt von Task)
ValidationDetails

Enthält je nach OperationType-Eigenschaft, bei der es sich um einen Wert aus der DTSXMLOperation-Enumeration handelt, die Elemente, mit denen mehrere XML-Tasks ausgeführt werden. Diese Klasse kann nicht vererbt werden.

ValidationType

Ruft einen DTSXMLValidationType-Enumerationswert ab, der den vom Vorgang verwendeten Überprüfungstyp angibt, oder legt ihn fest.

Version

Mitglied veraltet; siehe Hinweise. *** Gibt die Version des Tasks zurück. Diese Eigenschaft ist schreibgeschützt.

(Geerbt von Task)
XPathOperation

Ruft einen DTSXMLXPathOperation-Enumerationswert ab, der den auszuführenden XPath-Vorgang angibt, oder legt ihn fest.

XPathStringSource

Ruft die Quelle des XPath-Ausdrucks ab oder legt sie fest.

XPathStringSourceType

Ruft einen Wert aus der DTSXMLSourceType-Enumeration ab, der den Typ der Quelle angibt, die den XPath-Ausdruck in der XPathStringSource-Eigenschaft enthält, oder legt ihn fest.

Methoden

AcceptBreakpointManager(BreakpointManager)

Übergibt BreakpointManager an einen Task. Der Task verwendet den Breakpoint-Manager, um Breakpoints zu erstellen, zu entfernen und um deren Status zu überprüfen. Diese Methode wird von der Laufzeit aufgerufen und wird nicht in Code verwendet.

CanUpdate(String)

Mitglied veraltet; siehe Hinweise. Ein boolescher Wert, der angibt, ob der neue Paket-XML-Code das alte Paket-XML aktualisieren kann.

(Geerbt von Task)
Equals(Object)

Stellt fest, ob zwei Objektinstanzen gleich sind.

(Geerbt von DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

Führt die Aufgabe aus.

GetConnectionID(Connections, String)

Ruft eine Zeichenfolge ab, die die ID der Verbindung enthält.

(Geerbt von Task)
GetConnectionName(Connections, String)

Ruft eine Zeichenfolge ab, die den Namen der Verbindung enthält.

(Geerbt von Task)
GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

(Geerbt von DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

Initialisiert die diesem Task zugeordneten Eigenschaften. Diese Methode wird von der Laufzeit aufgerufen und wird nicht in Code verwendet.

LoadFromXML(XmlElement, IDTSInfoEvents)

Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein im XML-Format gespeichertes Paket zu laden, verwenden Sie die LoadPackage(String, IDTSEvents)-Methode.

ResumeExecution()

Setzt die Taskausführung nach einer Unterbrechung fort. Die Runtime-Engine setzt die Ausführung des Tasks oder Containers fort.

SaveToXML(XmlDocument, IDTSInfoEvents)

Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein Paket als XML-Datei zu speichern, verwenden Sie die SaveToXml(String, Package, IDTSEvents)-Methode.

SuspendExecution()

Gibt an, dass das ausführbare Element angehalten werden muss. Diese Methode wird von der Runtime-Engine aufgerufen.

Update(String)

Mitglied veraltet; siehe Hinweise. Diese Methode aktualisiert den alten Paket-XML-Code mit dem neuen Paket-XML, wenn CanUpdate(String) er auf "true" festgelegt ist.

(Geerbt von Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

Überprüft, ob die Komponente ordnungsgemäß konfiguriert ist.

Gilt für: