XMLTask.Validate Methode

public:
 override Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSComponentEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);

public override Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate(Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);

override this.Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult

Public Overrides Function Validate (connections As Connections, variableDispenser As VariableDispenser, events As IDTSComponentEvents, log As IDTSLogging) As DTSExecResult

Parameter

Gibt zurück

Ein Wert aus der DTSExecResult Enumeration.

Beispiele

Das folgende Codebeispiel erstellt ein XMLTask als Teil eines Pakets. Nachdem die Aufgabe erstellt wurde, setzt sie mehrere Eigenschaften und ruft dann die Methode Validate der Packageauf.

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;  
            XMLTask myTask = th.InnerObject as XMLTask;  

            // Create a FILE connection manager to books.xml.  
            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.  
            myTask.OperationType = DTSXMLOperation.Validate;  
            myTask.SourceType = DTSXMLSourceType.FileConnection;  
            myTask.Source = connMgr.Name;  

            DTSExecResult valResults = pkg.Validate(pkg.Connections, pkg.Variables, null, null);  
            Console.WriteLine("RESULTS: {0}", valResults);  
        }  
    }  
}  

Beispielausgabe:

RESULTS: Success

Hinweise

Diese Methode ist für die XMLTaskverfügbar, unabhängig vom Wert OperationType .

Die Methode Validate überprüft Eigenschaften und Einstellungen auf Ungenauigkeiten oder falsche Einstellungen. Die Methode berührt keine Daten und verbindet sich nicht mit Datenquellen, um Verbindungen zu validieren. Es stellt jedoch sicher, dass die erforderlichen Felder ausgefüllt werden und entsprechende Werte enthalten. Die validierten Felder unterscheiden sich je nachdem, welches Objekt validiert wird.

Der Hauptzweck Validate ist das Schreiben einer individuellen Aufgabe. Die Methode Validate wird vom SSIS-Designer aufgerufen, wenn eine Aufgabe auf die Designoberfläche gelegt wird, und erneut, möglicherweise mehrmals, wenn Eigenschaften gesetzt werden. Im Code wird die Methode Validate jedoch auf einzelnen Objekten nicht häufig verwendet, da empfohlen wird, die Validate Methode auf dem zu aufrufen Package , wenn Objekte validiert werden müssen. Die Methode ist jedoch bei einzelnen Objekten verfügbar, falls Sie eine besondere Situation finden, in der sie benötigt wird.

Die Methode Validate wird in benutzerdefinierten Aufgaben überschrieben, entweder zur Validierung des Objekts, wenn es im SSIS-Designer verwendet wird, oder wenn es vom Code aufgerufen wird. Für weitere Informationen zum Schreiben der Validate Methode für eine benutzerdefinierte Aufgabe siehe Coding a Custom Task.