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

Restituisce

Valore ricavato dall'enumerazione DTSExecResult.

Esempio

Nell'esempio di codice seguente viene creato un XMLTask oggetto come parte di un pacchetto. Dopo aver creato l'attività, imposta diverse proprietà e quindi chiama il Validate metodo dell'oggetto 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 , XMLTaskindipendentemente dal OperationType valore.

Il Validate metodo esamina le proprietà e le impostazioni per le inesattezze o le impostazioni non corrette. Il metodo non tocca i dati o si connette alle origini dati per convalidare le connessioni. Assicura tuttavia che i campi obbligatori vengano popolati e contengano valori appropriati. I campi convalidati differiscono a seconda dell'oggetto convalidato.

L'uso principale di Validate è quando si scrive un'attività personalizzata. Il Validate metodo viene chiamato dal Designer SSIS quando un'attività viene eliminata nell'area di progettazione e di nuovo, potenzialmente più volte, quando vengono impostate le proprietà. Tuttavia, nel codice, il Validate metodo su singoli oggetti non viene comunemente usato, perché è consigliabile chiamare il Validate metodo su Package quando è necessario convalidare gli oggetti. Tuttavia, il metodo è disponibile su singoli oggetti deve trovare una circostanza unica in cui è necessario.

Il Validate metodo viene sottoposto a override nelle attività personalizzate, per la convalida dell'oggetto quando viene usato nella Designer SSIS o quando viene chiamato dal codice. Per altre informazioni sulla scrittura del Validate metodo per un'attività personalizzata, vedere Codifica di un'attività personalizzata.

Si applica a