XMLTask.Validate Metodo

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

Parametri

Valori restituiti

Valore dell'enumerazione DTSExecResult .

Esempio

Il seguente esempio di codice crea una XMLTask parte di un pacchetto as. Dopo la creazione del compito, imposta diverse proprietà e poi chiama il Validate metodo del Package.

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);  
        }  
    }  
}  

Output di esempio:

RESULTS: Success

Commenti

Questo metodo è disponibile per il XMLTask, indipendentemente dal valore OperationType .

Il Validate metodo controlla proprietà e impostazioni per individuare imprecisioni o impostazioni errate. Il metodo non tocca i dati né si collega alle fonti dati per validare le connessioni. Tuttavia, garantisce che i campi richiesti siano popolati e contengano valori appropriati. I campi validati differiscono a seconda dell'oggetto che viene convalidato.

L'uso principale Validate è quando scrivo un compito personalizzato. Il Validate metodo viene chiamato dal SSIS Designer quando un compito viene inserito sulla superficie di progettazione e, potenzialmente, più volte quando le proprietà vengono impostate. Tuttavia, nel codice, il Validate metodo su singoli oggetti non è comunemente usato, poiché si consiglia di chiamare il Validate metodo su quando Package è necessario validare gli oggetti. Tuttavia, il metodo è disponibile per singoli oggetti nel caso si trovi una circostanza unica in cui sia necessario.

Il Validate metodo viene sovrascritto nei compiti personalizzati, sia per la validazione dell'oggetto quando usato nel SSIS Designer, sia quando chiamato dal codice. Per maggiori informazioni sulla scrittura del Validate metodo per un compito personalizzato, vedi Coding a Custom Task.