XMLTask.Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Verifica che il componente sia configurato correttamente.
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
- connections
- Connections
Raccolta di oggetti Connections utilizzati dall'attività.
- variableDispenser
- VariableDispenser
Oggetto VariableDispenser per il blocco di variabili.
- events
- IDTSComponentEvents
Oggetto che implementa l'interfaccia IDTSComponentEvents.
- log
- IDTSLogging
Oggetto che implementa l'interfaccia IDTSLogging.
Restituisce
Valore ricavato dall'enumerazione DTSExecResult.
Esempio
Nell'esempio di codice seguente viene creato un oggetto XMLTask come parte di un pacchetto. Una volta creata l'attività, vengono impostate diverse proprietà, quindi viene chiamato 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);
}
}
}
Esempio di output:
RESULTS: Success
Commenti
Questo metodo è disponibile per l'oggetto XMLTask , indipendentemente dal OperationType valore.
Il Validate metodo esamina le proprietà e le impostazioni per le imprecisioni o le impostazioni non corrette. Il metodo non tocca i dati oppure si connette alle origini dati per convalidare le connessioni. Tuttavia, garantisce che i campi obbligatori vengano popolati e contengano valori appropriati. I campi convalidati variano a seconda dell'oggetto da convalidare.
L'utilizzo principale di Validate è quando si scrive un'attività personalizzata. Il Validate metodo viene chiamato da Progettazione SSIS quando un'attività viene rilasciata nell'area di progettazione e nuovamente, potenzialmente più volte, durante l'impostazione delle proprietà. Tuttavia, nel codice, il Validate metodo sui singoli oggetti non viene comunemente utilizzato, in quanto è consigliabile chiamare il Validate metodo su Package quando è necessario convalidare gli oggetti. Tuttavia, il metodo è disponibile nei singoli oggetti se è necessario trovare una circostanza univoca in cui è necessario.
Il Validate metodo viene sottoposto a override nelle attività personalizzate, per la convalida dell'oggetto quando viene utilizzato in Progettazione 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.