TaskHost Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

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.

Fornisce un contenitore che incapsula una singola attività. In Progettazione SSIS, l'oggetto TaskHost non viene configurato separatamente, bensì quando si impostano le proprietà dell'attività incapsulata.

public ref class TaskHost sealed : Microsoft::SqlServer::Dts::Runtime::EventsProvider, Microsoft::SqlServer::Dts::Runtime::IDTSExecutionPath, Microsoft::SqlServer::Dts::Runtime::IDTSObjectHost, Microsoft::SqlServer::Dts::Runtime::IDTSPackagePath, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProvider, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProviderEx

public sealed class TaskHost : Microsoft.SqlServer.Dts.Runtime.EventsProvider, Microsoft.SqlServer.Dts.Runtime.IDTSExecutionPath, Microsoft.SqlServer.Dts.Runtime.IDTSObjectHost, Microsoft.SqlServer.Dts.Runtime.IDTSPackagePath, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProvider, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProviderEx

type TaskHost = class
    inherit EventsProvider
    interface IDTSObjectHost
    interface IDTSPropertiesProvider
    interface IDTSPropertiesProviderEx
    interface IDTSPackagePath
    interface IDTSExecutionPath

Public NotInheritable Class TaskHost
Inherits EventsProvider
Implements IDTSExecutionPath, IDTSObjectHost, IDTSPackagePath, IDTSPropertiesProvider, IDTSPropertiesProviderEx

Ereditarietà: Object

DtsObject

Executable

DtsContainer

EventsProvider
TaskHost

Implementazioni: IDTSExecutionPath IDTSObjectHost IDTSPackagePath IDTSPropertiesProvider IDTSPropertiesProviderEx

Esempio

Nell'esempio di codice seguente viene illustrata la creazione di un pacchetto vuoto. Due attività vengono aggiunte al pacchetto e si esegue il cast in una TaskHost classe, quindi TaskHost i metodi e le proprietà possono essere usati in entrambe le attività, ad esempio il metodo, senza considerare il InnerObject tipo di attività che è.

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime;  
using Microsoft.SqlServer.Dts.Tasks.BulkInsertTask;  
using Microsoft.SqlServer.Dts.Tasks.FileSystemTask;  

namespace Microsoft.SqlServer.SSIS.Samples  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Package p = new Package();  
            // Add a File System task to the package.  
            Executable exec1 = p.Executables.Add("STOCK:FileSystemTask");  
            TaskHost thFileSystemTask = exec1 as TaskHost;  
            // Add a Bulk Insert task to the package.  
            Executable exec2 = p.Executables.Add("STOCK:BulkInsertTask");  
            TaskHost thBulkInsertTask = exec2 as TaskHost;  

            // Iterate through the package Executables collection.  
            Executables pExecs = p.Executables;  
            foreach (Executable pExec in pExecs)  
            {  
                TaskHost taskHost = (TaskHost)pExec;  
                Console.WriteLine("Type {0}", taskHost.InnerObject.ToString());  
            }  
        }  
    }  
}

Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime  
Imports Microsoft.SqlServer.Dts.Tasks.BulkInsertTask  
Imports Microsoft.SqlServer.Dts.Tasks.FileSystemTask  

Namespace Microsoft.SqlServer.SSIS.Samples  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim p As Package =  New Package()   
            ' Add a File System task to the package.  
            Dim exec1 As Executable =  p.Executables.Add("STOCK:FileSystemTask")   
            Dim thFileSystemTask As TaskHost =  exec1 as TaskHost   
            ' Add a Bulk Insert task to the package.  
            Dim exec2 As Executable =  p.Executables.Add("STOCK:BulkInsertTask")   
            Dim thBulkInsertTask As TaskHost =  exec2 as TaskHost   

            ' Iterate through the package Executables collection.  
            Dim pExecs As Executables =  p.Executables   
            Dim pExec As Executable  
            For Each pExec In pExecs  
                Dim taskHost As TaskHost = CType(pExec, TaskHost)  
                Console.WriteLine("Type {0}", taskHost.InnerObject.ToString())  
            Next  
        End Sub  
    End Class  
End Namespace

Esempio di output

Type Microsoft.SqlServer.Dts.Tasks.FileSystemTask.FileSystemTask

Type Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTask

Commenti

Integration Services offre diversi tipi di contenitori per la compilazione di pacchetti, con l'essere TaskHost uno di questi contenitori. Il TaskHost contenitore fornisce servizi a una singola attività. Non dispone di un elemento corrispondente nella casella degli strumenti di progettazione grafica. L'oggetto TaskHost è un oggetto wrapper per l'attività e viene creato in modo trasparente durante la creazione dell'attività. Viene restituito dal Add metodo come Executable oggetto ed è sottoposto a cast come .TaskHost Infine, l'istanza dell'attività è accessibile tramite la InnerObject proprietà . Per altre informazioni su tutti i contenitori SSIS, vedere Contenitori di Integration Services.

Campi

m_executable

Eseguibile.

(Ereditato da Executable)

Proprietà

ApartmentThreaded	Ottiene un valore che indica se l'attività è un oggetto con threading di tipo apartment.
CreationName	Restituisce la stringa utilizzata per creare un'istanza dell'oggetto DtsContainer. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
DebugMode	Ottiene o imposta un valore booleano che indica se l'oggetto è in modalità di debug e se deve generare l'evento durante l'esecuzione DtsContainer OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) . (Ereditato da DtsContainer)
DelayValidation	Ottiene o imposta un valore booleano che indica se la convalida dell'attività viene ritardata fino al momento dell'esecuzione. Il valore predefinito è false. (Ereditato da DtsContainer)
Description	Ottiene o imposta la descrizione dell'oggetto DtsContainer. (Ereditato da DtsContainer)
Disable	Valore booleano che indica se l'oggetto DtsContainer è disabilitato. (Ereditato da DtsContainer)
DisableEventHandlers	Ottiene o imposta un valore booleano che indica se i gestori eventi nell'attività sono disabilitati. (Ereditato da EventsProvider)
EventHandlers	Restituisce una raccolta di oggetti gestore evento. Questo campo è di sola lettura. (Ereditato da EventsProvider)
EventInfos	Restituisce una raccolta di oggetti EventInfo. Questo campo è di sola lettura. (Ereditato da EventsProvider)
ExecutionDuration	Restituisce un valore che indica l'intervallo di tempo in millisecondi impiegato per l'esecuzione del contenitore. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
ExecutionResult	Restituisce un valore che indica l'esito positivo o negativo dell'esecuzione dell'oggetto DtsContainer. (Ereditato da DtsContainer)
ExecutionStatus	Restituisce un valore che indica lo stato corrente dell'esecuzione dell'oggetto DtsContainer al momento della chiamata. (Ereditato da DtsContainer)
ExecutionValue	Ottiene il risultato dell'esecuzione dell'attività. Questa proprietà è di sola lettura.
ExecValueVariable	Ottiene o imposta un oggetto Variable personalizzato contenente i risultati dell'esecuzione dell'attività.
FailPackageOnFailure	Ottiene o imposta un valore booleano che indica se il pacchetto ha esito negativo quando un contenitore figlio ha esito negativo. Questa proprietà viene utilizzata per i contenitori, non per il pacchetto stesso. (Ereditato da DtsContainer)
FailParentOnFailure	Ottiene o imposta un valore `Boolean` che indica se l'esecuzione del contenitore padre avrà esito negativo quando l'esecuzione di uno dei contenitori figlio ha esito negativo. (Ereditato da DtsContainer)
ForcedExecutionValue	Se la ForceExecutionValue proprietà è impostata su True, ottiene o imposta un valore che specifica il valore di esecuzione facoltativo restituito dal pacchetto. (Ereditato da DtsContainer)
ForceExecutionResult	Ottiene o imposta un valore di enumerazione DTSForcedExecResult che specifica il risultato dell'esecuzione forzata del contenitore. (Ereditato da DtsContainer)
ForceExecutionValue	Ottiene o imposta un valore booleano che indica se il valore di esecuzione del contenitore deve essere forzato a contenere un valore specifico. (Ereditato da DtsContainer)
HasExpressions	Ottiene un valore che indica se nell'oggetto TaskHost sono presenti espressioni.
HostType	Ottiene un valore dell'enumerazione DTSObjectHostType che descrive l'host del contenitore. Questa proprietà è di sola lettura.
ID	Restituisce l'ID, ovvero un GUID, dell'oggetto DtsContainer. Questo valore è di sola lettura. (Ereditato da DtsContainer)
InnerObject	Ottiene il metodo utilizzato per accedere all'istanza dell'attività ospitata dall'oggetto TaskHost.
IsDefaultLocaleID	Valore booleano che indica se il contenitore usa le impostazioni locali predefinite. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
IsolationLevel	Ottiene o imposta il livello di isolamento della transazione nell'oggetto DtsContainer. (Ereditato da DtsContainer)
LocaleID	Ottiene o imposta un valore Integer che indica l'ID delle impostazioni locali di Microsoft Win32® da usare quando l'oggetto DtsContainer viene eseguito. (Ereditato da DtsContainer)
LogEntryInfos	Restituisce un oggetto LogEntryInfos. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
LoggingMode	Ottiene o imposta un valore valido dell'enumerazione DTSLoggingMode che indica la modalità di registrazione del contenitore. (Ereditato da DtsContainer)
LoggingOptions	Restituisce un oggetto contenente proprietà che specificano i filtri e la risorsa di registrazione per i contenitori. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
MaximumErrorCount	Ottiene o imposta un valore Integer che indica il numero massimo di errori che possono verificarsi prima che l'oggetto DtsContainer venga arrestato. (Ereditato da DtsContainer)
Name	Ottiene o imposta il nome di DtsContainer. (Ereditato da DtsContainer)
Parent	Restituisce il contenitore padre. Questo valore è di sola lettura. (Ereditato da DtsContainer)
Properties	Ottiene una raccolta DtsProperties che contiene le proprietà associate all'attività.
Site	Ottiene o imposta il sito per il contenitore. (Ereditato da DtsContainer)
StartTime	Restituisce l'ora di inizio esecuzione del contenitore. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
StopTime	Restituisce l'ora di fine esecuzione del contenitore. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)
SuspendRequired	Ottiene o imposta un valore booleano che indica se le attività devono essere sospese quando rilevano un punto di interruzione. Questo valore viene impostato dal motore di runtime per le attività e i contenitori quando viene rilevato un punto di interruzione. (Ereditato da DtsContainer)
TransactionOption	Ottiene o imposta un valore di enumerazione DTSTransactionOption che indica se il contenitore partecipa alle transazioni. (Ereditato da DtsContainer)
VariableDispenser	Restituisce un oggetto VariableDispenser per consentire di bloccare le variabili associate al contenitore. (Ereditato da DtsContainer)
Variables	Restituisce una raccolta contenente le variabili associate a questo contenitore. Questa proprietà è di sola lettura. (Ereditato da DtsContainer)

Metodi

AcceptBreakpointManager(BreakpointManager)	Questo metodo viene chiamato dal motore di runtime al momento della creazione di un'attività o di un contenitore, passando un gestore BreakpointManager come argomento per consentire all'attività di creare, rimuovere e verificare lo stato dei punti di interruzione. Questo metodo viene chiamato dal runtime e non è utilizzato nel codice. (Ereditato da DtsContainer)
ComputeExpressions(Boolean)	Calcola le espressioni dell'oggetto TaskHost.
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. (Ereditato da DtsContainer)
Equals(Object)	Determina se due istanze di un oggetto sono uguali. (Ereditato da DtsObject)
Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object)	Esegue l'applicazione, il contenitore o il pacchetto come parte del flusso di lavoro del pacchetto. (Ereditato da DtsContainer)
GetExecutionPath()	Restituisce il percorso di esecuzione dell'oggetto TaskHost corrente.
GetExpression(String)	Restituisce l'espressione per la proprietà specificata. Null significa che non viene assegnata alcuna espressione.
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da DtsObject)
GetPackagePath()	Restituisce il percorso alla posizione dell'attività.
LoadFromXML(XmlNode, IDTSEvents)	Non è possibile chiamare questo metodo dal codice dell'applicazione. Per caricare un pacchetto salvato come file con estensione xml, utilizzare il metodo LoadPackage(String, IDTSEvents). (Ereditato da DtsContainer)
ResumeExecution()	Riprende l'esecuzione dell'attività dopo la sospensione. L'attività o il contenitore viene ripreso dal motore di runtime. (Ereditato da DtsContainer)
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	Non è possibile chiamare questo metodo dal codice dell'applicazione. Per salvare un pacchetto come file con estensione xml, utilizzare il metodo SaveToXml(String, Package, IDTSEvents). (Ereditato da DtsContainer)
SetExpression(String, String)	Assegna l'espressione specificata alla proprietà. Specificare Null per rimuovere un'espressione esistente dalla proprietà.
SetWrappedExecutable(IDTSExecutable100)	Restituisce l'oggetto eseguibile di cui è stato eseguito il wrapping. (Ereditato da EventsProvider)
SuspendExecution()	Metodo richiamato quando è necessario sospendere l'eseguibile. Questo metodo viene chiamato dal motore di runtime. (Ereditato da DtsContainer)
Validate(Connections, Variables, IDTSEvents, IDTSLogging)	Consente al contenitore di determinare se contiene impostazioni non valide che ne impediranno l'esecuzione corretta. (Ereditato da DtsContainer)

Eventi

Disposed

Aggiunge un gestore evento per restare in attesa dell'evento Disposed sul componente.

(Ereditato da DtsContainer)

Si applica a