Condividi tramite


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. 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 DtsContainerOnBreakpointHit(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