TaskHost Classe

Definizione

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à
Implementazioni

Esempio

Nell'esempio di codice seguente viene illustrata la creazione di un pacchetto vuoto. Vengono aggiunte due attività al pacchetto ed eseguite il cast in una TaskHost classe, quindi TaskHost i metodi e le proprietà possono essere usati in entrambe le attività, ad esempio il InnerObject metodo, indipendentemente dal tipo di attività.

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 in sono disponibili diversi tipi di contenitori per la compilazione di pacchetti, TaskHost che sono uno di questi contenitori. Il TaskHost contenitore fornisce servizi a una singola attività. Non dispone di un elemento corrispondente nella casella degli strumenti della finestra di progettazione grafica. L' TaskHost oggetto è 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 e viene eseguito il cast come TaskHost . Infine, è possibile accedere all'istanza dell'attività tramite la InnerObject Proprietà. Per ulteriori informazioni su tutti i contenitori SSIS, vedere Integration Services contenitori.

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' DtsContainer oggetto è in modalità di debug e se deve generare l' OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) evento durante l'esecuzione.

(Ereditato da DtsContainer)
DelayValidation

Ottiene o imposta un valore booleano che indica se la convalida dell'attività viene posticipata fino alla fase di 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' DtsContainer oggetto è 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 utilizza 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'oggetto localeID® Microsoft Win32 da utilizzare quando DtsContainer viene eseguito l'oggetto.

(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' DtsContainer esecuzione dell'oggetto venga arrestata.

(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 viene rilevato 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 indica che non è 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