XMLTask Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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. |