XMLTask Klasse

Definition

Namespace:
Microsoft.SqlServer.Dts.Tasks.XMLTask
Assembly:
Microsoft.SqlServer.XMLTask.dll

Enthält die Mitglieder, die je nach Eigenschaft OperationType verwendet werden, um mehrere XML-Aufgaben auszuführen, die ein Wert aus der DTSXMLOperation Aufzählung ist. 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
Object
DtsObject
Task
XMLTask
Attribute
DtsTaskAttribute GuidAttribute
Implementiert
IDTSBreakpointSite IDTSComponentPersist IDTSSuspend IDTSXMLTask

Hinweise

Weitere Informationen finden Sie unter XML Task.

Konstruktoren

Name Beschreibung
XMLTask()

Initialisiert eine neue Instanz der XMLTask-Klasse.

Eigenschaften

Name Beschreibung
DebugMode

Ein Boolean, der anzeigt, ob eine Aufgabe prüfen sollte, ob Breakpoints aktiviert sind.
Destination

Erhält oder setzt den Namen der Verbindung oder der Variable, in die die XML-Aufgabe speichert, die Ergebnisse der Operation speichert.
DestinationType

Erhält oder setzt einen DTSXMLSaveResultTo Aufzählungswert, der den Typ des Ziels angibt, an den die XML-Aufgabe das XML-Dokument speichert.
DiffAlgorithm

Erhält oder setzt den Vergleichsalgorithmus so, dass er verwendet, wenn der OperationType ist Diff.
DiffGramDestination

Erhält oder setzt den Namen der Verbindung oder der Variable, in die die XML-Aufgabe das DiffGram-Dokument speichert.
DiffGramDestinationType

Erhält oder setzt einen Wert, der den Typ der Zielgruppe angibt, für die die XML-Aufgabe das DiffGram-Dokument speichert.
DiffOptions

Erhält oder setzt einen Wert, der die Optionen angibt, die die Operation beim Vergleich von Dokumenten verwendet.
ExecutionValue

Gibt das Ergebnis der Aufgabenausführung zurück.
FailOnDifference

Erhält oder setzt eine boolesche Funktion, die anzeigt, ob die Aufgabe fehlschlägt, wenn das XML-Dokument gemäß dem Validierungsschema nicht validiert.
FailOnValidationFail

Erhält oder setzt einen Boolean, der anzeigt, ob die Operation fehlschlägt, wenn eine Validierung fehlfällt.
Namespaces

Erhält oder setzt die Sammlung der Namensräume für die XML-Aufgabe.
NodeList

Erhält eine ArrayList-Klasse, die eine Sammlung von Knoten enthält, die durch die XPath-Operation erzeugt werden.
OperationType

Erhält oder setzt einen DTSXMLOperation Aufzählungswert, der den Typ der Operation angibt, die die Aufgabe ausführt, wie z. B. Validierung oder Zusammenführung.
OverwriteDestination

Erhält oder setzt einen Boolean, der angibt, ob die Operation bestehende Zieldateien überschreibt.
PutResultInOneNode

Erhält oder setzt einen Boolean, der angibt, ob die Operation das Ergebnis in einem Knoten platziert.
SaveDiffGram

Erhält oder setzt einen Boolean, der angibt, ob das Vergleichsergebnis, ein DiffGram-Dokument, gespeichert wird.
SaveOperationResult

Erhält oder setzt einen Boolean, der angibt, ob die XML-Aufgabe die Diff-Operation-Ausgabe speichert.
SecondOperand

Erhält oder setzt den Namen der Verbindung, der Variablen oder des vom Benutzer bereitgestellten Textes, der der zweite Operanden in einer Operation ist, die zwei Operanden verwendet. Der zweite Operand kann ein XML-Dokument, ein DiffGram, ein XSLT, ein XPath oder ein Validierungsdokument sein, je nach Operation.
SecondOperandType

Erhält oder setzt einen Wert, der den Quelltyp angibt, der das XML-Dokument, das DiffGram, das XSLT, das XPath oder das validierende Dokument enthält, das im SecondOperand.
Source

Erhält oder setzt den Namen der Verbindung, die Variable oder den vom Benutzer bereitgestellten Text, der die Quelle ist, die die Operation verwendet.
SourceType

Erhält oder setzt einen Wert aus der DTSXMLSourceType Aufzählung, der den Quelltyp angibt, der das XML-Dokument enthält, das die Operation verwendet.
SuspendRequired

Erhält oder setzt einen Boolean, der anzeigt, ob Aufgaben ausgesetzt werden sollten, wenn sie auf einen Breakpoint stoßen. Dieser Wert wird von der Laufzeit-Engine für Aufgaben und Container festgelegt, wenn ein Breakpoint erreicht wird.
TargetServerVersion

Enthält die Mitglieder, die je nach Eigenschaft OperationType verwendet werden, um mehrere XML-Aufgaben auszuführen, die ein Wert aus der DTSXMLOperation Aufzählung ist. Diese Klasse kann nicht vererbt werden.

(Geerbt von Task)
ValidationDetails

Enthält die Mitglieder, die je nach Eigenschaft OperationType verwendet werden, um mehrere XML-Aufgaben auszuführen, die ein Wert aus der DTSXMLOperation Aufzählung ist. Diese Klasse kann nicht vererbt werden.
ValidationType

Erhält oder setzt einen DTSXMLValidationType Aufzählungswert, der die Art der Validierung angibt, die die Operation verwendet.
Version

Mitglied veraltet; siehe Bemerkungen. Gibt die Version der Aufgabe zurück. Diese Eigenschaft ist schreibgeschützt.

(Geerbt von Task)
XPathOperation

Erhält oder setzt einen DTSXMLXPathOperation Aufzählungswert, der die auszuführende XPath-Operation angibt.
XPathStringSource

Erhält oder setzt die Quelle des XPath-Ausdrucks.
XPathStringSourceType

Erhält oder setzt einen Wert aus der DTSXMLSourceType Aufzählung, der den Typ der Quelle angibt, der den XPath-Ausdruck in der Eigenschaft XPathStringSource enthält.

Methoden

Name Beschreibung
AcceptBreakpointManager(BreakpointManager)

Gibt ein BreakpointManager A an eine Aufgabe weiter. Die Aufgabe verwendet den Breakpoint-Manager, um Breakpoints zu erstellen, zu entfernen und den Status zu überprüfen. Diese Methode wird von der Laufzeit aufgerufen und im Code nicht verwendet.
CanUpdate(String)

Mitglied veraltet; siehe Bemerkungen. Ein Boolesche Bereich, der angibt, ob das neue Paket-XML das alte Paket-XML aktualisieren kann.

(Geerbt von Task)
Equals(Object)

Bestimmt, ob zwei Objektinstanzen gleich sind.

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

Führt die Aufgabe aus.
GetConnectionID(Connections, String)

Erhält einen String, der die ID der Verbindung enthält.

(Geerbt von Task)
GetConnectionName(Connections, String)

Erhält eine Zeichenkette, die den Namen der Verbindung enthält.

(Geerbt von Task)
GetHashCode()

Gibt den Hashcode für diesen instance zurück.

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

Initialisiert die mit dieser Aufgabe verbundenen Eigenschaften. Diese Methode wird von der Laufzeit aufgerufen und im Code nicht verwendet.
LoadFromXML(XmlElement, IDTSInfoEvents)

Diese Methode kann von deinem Anwendungscode nicht aufgerufen werden. Um ein als .xmlgespeichertes Paket zu laden, verwenden Sie die Methode LoadPackage(String, IDTSEvents) .
ResumeExecution()

Setzt die Ausführung der Aufgabe nach der Pause fort. Die Aufgabe oder der Container wird von der Laufzeit-Engine fortgesetzt.
SaveToXML(XmlDocument, IDTSInfoEvents)

Diese Methode kann von deinem Anwendungscode nicht aufgerufen werden. Um ein Paket als .xmlzu speichern, verwenden Sie die Methode SaveToXml(String, Package, IDTSEvents) .
SuspendExecution()

Zeigt an, dass die ausführbare Datei suspendiert werden muss. Diese Methode wird von der Laufzeit-Engine aufgerufen.
Update(String)

Mitglied veraltet; siehe Bemerkungen. Diese Methode aktualisiert das alte Paket XML mit dem neuen Paket XML, wenn CanUpdate(String) auf true gesetzt ist.

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

Überprüft, ob die Komponente korrekt konfiguriert ist.

Gilt für: