XMLTask Klasse

Definition

Namespace:

Microsoft.SqlServer.Dts.Tasks.XMLTask

Assembly:

Microsoft.SqlServer.XMLTask.dll

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 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 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

Object

DtsObject

Task

XMLTask

Attribute

DtsTaskAttribute GuidAttribute

Implementiert

IDTSBreakpointSite IDTSComponentPersist IDTSSuspend IDTSXMLTask

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.