WmiDataReaderTask.Execute 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.
Gestisce il compito.
public:
override Microsoft::SqlServer::Dts::Runtime::DTSExecResult Execute(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSComponentEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log, System::Object ^ transaction);
public override Microsoft.SqlServer.Dts.Runtime.DTSExecResult Execute(Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log, object transaction);
override this.Execute : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging * obj -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
Public Overrides Function Execute (connections As Connections, variableDispenser As VariableDispenser, events As IDTSComponentEvents, log As IDTSLogging, transaction As Object) As DTSExecResult
Parametri
- connections
- Connections
Una Connections collezione per il compito.
- variableDispenser
- VariableDispenser
Una Variables collezione per il compito.
- events
- IDTSComponentEvents
Un riferimento a un oggetto che implementa IDTSComponentEvents per generare eventi.
- log
- IDTSLogging
Un riferimento a un oggetto che implementa IDTSLogging.
- transaction
- Object
L'oggetto transazione di cui fa parte il compito, a seconda del valore trovato nella proprietà TransactionOption. Questo valore può essere impostato a un riferimento nullo (Nothing in Visual Basic).
Valori restituiti
A indica DTSExecResult l'esito dell'esecuzione.
Esempio
Il seguente esempio di codice mostra come eseguire un pacchetto contenente una BulkInsertTask dopo che alcune proprietà del compito sono state impostate. Il compito Inserimento in massa è un esempio per questo esempio di codice; Qualsiasi compito può essere creato al suo posto.
using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SqlServer.Dts.Runtime;
using Microsoft.SqlServer.Dts.Tasks.BulkInsertTask
namespace Microsoft.SqlServer.SSIS.Samples
{
class Program
{
static void Main(string[] args)
{
Package p = new Package();
p.InteractiveMode = true;
p.OfflineMode = true;
Executable exec1 = pkg.Executables.Add("STOCK:BulkInsertTask");
TaskHost th = exec1 as TaskHost;
// Set the CheckConstraints and DataFileType properties.
th.Properties["CheckConstraints"].SetValue(th, true);
th.Properties["DataFileType"].SetValue(th, DTSBulkInsert_DataFileType.DTSBulkInsert_DataFileType_Native);
// Run the package that contains the task.
pkg.Execute();
// Review the results of the run.
if (taskH.ExecutionResult == DTSExecResult.Failure || taskH.ExecutionStatus == DTSExecStatus.Abend)
Console.WriteLine("Task failed or abended");
else
Console.WriteLine("Task ran successfully");
}
}
}
Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
Imports Microsoft.SqlServer.Dts.Tasks.BulkInsertTask
Namespace Microsoft.SqlServer.SSIS.Samples
Class Program
Shared Sub Main(ByVal args() As String)
Dim p As Package = New Package()
p.InteractiveMode = True
p.OfflineMode = True
Dim exec1 As Executable = pkg.Executables.Add("STOCK:BulkInsertTask")
Dim th As TaskHost = exec1 as TaskHost
' Set the CheckConstraints and DataFileType properties.
th.Properties("CheckConstraints").SetValue(th, True)
th.Properties("DataFileType").SetValue(th, DTSBulkInsert_DataFileType.DTSBulkInsert_DataFileType_Native)
' Run the package that contains the task.
pkg.Execute()
' Review the results of the run.
If taskH.ExecutionResult = DTSExecResult.Failure Or taskH.ExecutionStatus = DTSExecStatus.Abend Then
Console.WriteLine("Task failed or abended")
Else
Console.WriteLine("Task ran successfully")
End If
End Sub
End Class
End Namespace
Commenti
Il Execute metodo viene ereditato dagli host di task e da altri oggetti della Executable classe astratta, attraverso la DtsContainer classe, e permette che gli oggetti ereditanti vengano eseguiti dal motore di runtime. Il Execute metodo ereditato dai singoli oggetti non è comunemente usato nel codice, e si consiglia di chiamare il Execute metodo se è necessario eseguire uno qualsiasi dei task o dei contenitori nel pacchetto. Tuttavia, il Execute metodo è disponibile per singoli oggetti nel caso si trovi una circostanza unica in cui sia necessario.
L'uso principale del Execute metodo è che venga ereditato e sovrascritto quando crei un compito personalizzato. Per maggiori informazioni su come sovrascrivere il metodo Esegui, vedi Coding a Custom Task.
Il Execute metodo chiama il Validate metodo implicitamente prima che il pacchetto venga eseguito. Tutte le attività nel pacchetto vengono esaminate per le impostazioni appropriate durante la validazione e tutti gli oggetti nel pacchetto vengono esaminati, inclusi il pacchetto, i contenitori e gli altri componenti del pacchetto.
Se non si riscontrano problemi nella fase di validazione che possano causare il fallimento del pacchetto, l'oggetto package procede a chiamare il Execute metodo per ogni compito e oggetto nel package.
Passa null per il transaction parametro quando la TransactionOption proprietà è false. Se la TransactionOption proprietà è vera, puoi inviare null il transaction parametro per indicare che il container supporta transazioni ma non partecipa.