DTSXMLOperation Enumeration
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.
Spezifiziert die Operationen, die bei der Arbeit mit XML-Dokumenten verwendet werden.
public enum class DTSXMLOperation
public enum DTSXMLOperation
type DTSXMLOperation =
Public Enum DTSXMLOperation
- Vererbung
-
DTSXMLOperation
Felder
| Name | Wert | Beschreibung |
|---|---|---|
| Validate | 0 | Validiert das XML-Dokument anhand einer Dokumenttypdefinition (DTD) oder XML-Schema-Definition (XSD). |
| XSLT | 1 | Führt XSL-Transformationen in XML-Dokumenten aus. |
| XPATH | 2 | Führt XPath-Abfragen und -Auswertungen aus. |
| Merge | 3 | Führt zwei XML-Dokumente zusammen. Indem das Quell-XML-Dokument als Basisdokument verwendet wird, wird ein zweites Dokument mit dem Basisdokument zusammengeführt. Die Operation kann im Dokument einen Merge-Standort angeben. |
| Diff | 4 | Vergleicht zwei XML-Dokumente miteinander. Indem das Quell-XML-Dokument als Basisdokument verwendet wird, vergleicht die Diff-Operation es mit einem anderen XML-Dokument, erkennt die Unterschiede und schreibt die Unterschiede dann in ein XML-DiffGram-Dokument. Dieser Vorgang schließt Eigenschaften zum Anpassen des Vergleichs ein. |
| Patch | 5 | Wendet die Ausgabe der Diff-Operation (einem DiffGram-Dokument) auf ein XML-Dokument an, um ein neues übergeordnetes Dokument zu erstellen, das Inhalte aus dem DiffGram-Dokument enthalten kann. |
Beispiele
Das folgende Codebeispiel zeigt, dass diese Aufzählung verwendet wird, um das OperationType Recht nach der Erstellung der Aufgabe festzulegen.
using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SqlServer.Dts.Runtime;
using Microsoft.SqlServer.Dts.Tasks.XMLTask;
namespace XMLTask_API
{
class Program
{
static void Main(string[] args)
{
// Set up the objects and tasks.
Package pkg = new Package();
Executable exec1 = pkg.Executables.Add("STOCK:XMLTask");
TaskHost th = exec1 as TaskHost;
// You can cast the InnerObject to the XmlTask, but it is advised
// that you work with tasks through the TaskHost and its Properties.
// XMLTask myTask = th.InnerObject as XMLTask;
// Create a variable and a FILE connection manager to books.xml.
Variable resultVar = pkg.Variables.Add("resultVariable", false, "", "Variable for the result");
ConnectionManager connMgr = pkg.Connections.Add("FILE");
connMgr.Name = "XMLConnectionManager";
// The file, Books.xml, is stored on the C:\ drive.
connMgr.ConnectionString = @"c:\books.xml";
// Set the XMLTask properties.
// The first property to set is the OperationType. Depending on the
// OperationType, different properties are valid.
// The operation type in this example is VALIDATE.
th.Properties["OperationType"].SetValue(th, DTSXMLOperation.Validate);
th.Properties["SourceType"].SetValue(th, DTSXMLSourceType.FileConnection);
th.Properties["Source"].SetValue(th, connMgr.Name);
th.Properties["OverwriteDestination"].SetValue(th, true);
th.Properties["SaveOperationResult"].SetValue(th, true);
th.Properties["DestinationType"].SetValue(th, DTSXMLSaveResultTo.Variable);
th.Properties["Destination"].SetValue(th, resultVar.Name);
th.Properties["SecondOperandType"].SetValue(th, DTSXMLSourceType.DirectInput);
th.Properties["SecondOperand"].SetValue(th, "<x></x>");
th.Properties["ValidationType"].SetValue(th, DTSXMLValidationType.DTD);
th.Properties["FailOnValidationFaile"].SetValue(th, true);
DTSExecResult valResults = pkg.Validate(pkg.Connections, pkg.Variables, null, null);
Console.WriteLine("RESULTS: {0}", valResults);
}
}
}
Beispielausgabe:
ERGEBNISSE: Erfolg
Hinweise
Diese Operation bestimmt, welche anderen Eigenschaften in der Klasse XMLTask gültig sind. Zum Beispiel, wenn die gewählte Operation ist XPATH, dann werden die Eigenschaften PutResultInOneNode und XPathOperation verwendet. Wenn die Operation ist Validate, ist FailOnValidationFail die Flag verfügbar. Das ist normalerweise die erste Eigenschaftsmenge im Code, damit du sofort sehen kannst, welche Aufgabe ausgeführt wird XMLTask .