TaskHost Classe

Referência

Definição

Namespace:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece um contêiner que encapsula uma única tarefa. No Designer SSIS, o TaskHost não é configurado separadamente, ele é configurado quando você define as propriedades da tarefa que ele encapsula.

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

Herança: Object

DtsObject

Executable

DtsContainer

EventsProvider
TaskHost

Implementações: IDTSExecutionPath IDTSObjectHost IDTSPackagePath IDTSPropertiesProvider IDTSPropertiesProviderEx

Exemplos

O exemplo de código a seguir mostra a criação de um pacote vazio. Duas tarefas são adicionadas ao pacote e convertidas em uma TaskHost classe, portanto TaskHost , métodos e propriedades podem ser usados em qualquer tarefa, como o InnerObject método, sem levar em conta o tipo de tarefa que ele é.

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

Saída de exemplo:

Tipo Microsoft.SqlServer.Dts.Tasks.FileSystemTask.FileSystemTask

Tipo Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTask

Comentários

O Integration Services fornece vários tipos diferentes de contêineres para a criação de pacotes, sendo um TaskHost desses contêineres. O TaskHost contêiner fornece serviços para uma única tarefa. Ele não tem um item correspondente na caixa de ferramentas do designer gráfico. O TaskHost objeto é um objeto wrapper para a tarefa e é criado de forma transparente durante a criação da tarefa. Ele é retornado do Add método como um Executable objeto e é convertido como um TaskHost. Por fim, a instância da tarefa é acessada por meio da InnerObject propriedade. Para obter mais informações sobre todos os contêineres do SSIS, consulte Contêineres do Integration Services.

Campos

m_executable

O executável.

(Herdado de Executable)

Propriedades

ApartmentThreaded	Obtém um valor que indica se a tarefa é um objeto apartment-threaded.
CreationName	Retorna a cadeia de caracteres usada para criar uma instância do objeto DtsContainer. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
DebugMode	Obtém ou define um Boolean que indica se o DtsContainer objeto está no modo de depuração e se ele deve disparar o evento durante a OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) execução. (Herdado de DtsContainer)
DelayValidation	Obtém ou define um Boolean que indica se a validação da tarefa está atrasada até o tempo de execução. O valor padrão é false. (Herdado de DtsContainer)
Description	Obtém ou define a descrição do objeto DtsContainer. (Herdado de DtsContainer)
Disable	Um booliano que indica se o DtsContainer objeto está desabilitado. (Herdado de DtsContainer)
DisableEventHandlers	Obtém ou define um Boolean que indica se os manipuladores de eventos na tarefa estão desabilitados. (Herdado de EventsProvider)
EventHandlers	Retorna uma coleção de objetos de manipulador de eventos. Este campo é somente leitura. (Herdado de EventsProvider)
EventInfos	Retorna uma coleção de objetos EventInfo. Este campo é somente leitura. (Herdado de EventsProvider)
ExecutionDuration	Retorna um valor que indica a quantidade de tempo gasta pelo contêiner na execução, em milissegundos. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
ExecutionResult	Retorna um valor que indica o êxito ou a falha da execução do objeto DtsContainer. (Herdado de DtsContainer)
ExecutionStatus	Retorna um valor que indica o status atual da execução do objeto DtsContainer na hora da chamada. (Herdado de DtsContainer)
ExecutionValue	Obtém o resultado da execução da tarefa. Esta propriedade é somente para leitura.
ExecValueVariable	Obtém ou define o Variable personalizado que contém os resultados da execução da tarefa.
FailPackageOnFailure	Obtém ou define um Boolean que indica se o pacote falha quando um contêiner filho falha. Essa propriedade é usada em contêineres, não no próprio pacote. (Herdado de DtsContainer)
FailParentOnFailure	Obtém ou define um `Boolean` que define se há falha no contêiner pai quando há falha em um contêiner filho. (Herdado de DtsContainer)
ForcedExecutionValue	Se a ForceExecutionValue propriedade for definida como True, obterá ou definirá um valor que especifica o valor de execução opcional que o pacote retorna. (Herdado de DtsContainer)
ForceExecutionResult	Obtém ou define um valor de enumeração DTSForcedExecResult que especifica o resultado da execução forçada do contêiner. (Herdado de DtsContainer)
ForceExecutionValue	Obtém ou define um booliano que indica se o valor de execução do contêiner deve ser forçado a conter um valor específico. (Herdado de DtsContainer)
HasExpressions	Obtém um valor que indica se o objeto TaskHost tem expressões.
HostType	Obtém um valor da enumeração DTSObjectHostType que descreve o host do contêiner. Esta propriedade é somente para leitura.
ID	Retorna a ID que é um GUID do DtsContainer. O valor é somente leitura. (Herdado de DtsContainer)
InnerObject	Obtém o método usado para acessar a instância da tarefa hospedada pelo TaskHost.
IsDefaultLocaleID	Um booliano que indica se o contêiner usa a localidade padrão. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
IsolationLevel	Obtém ou define o nível de isolamento da transação no objeto DtsContainer. (Herdado de DtsContainer)
LocaleID	Obtém ou define um Inteiro que indica a localidade do Microsoft Win32® a ser usada quando o DtsContainer objeto é executado. (Herdado de DtsContainer)
LogEntryInfos	Retorna um objeto LogEntryInfos. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
LoggingMode	Obtém ou define um valor válido da enumeração DTSLoggingMode que indica o modo de log do contêiner. (Herdado de DtsContainer)
LoggingOptions	Retorna um objeto que contém propriedades que indicam a filtragem e o recurso de log para contêineres. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
MaximumErrorCount	Obtém ou define um valor inteiro que indica o número máximo de erros que podem ocorrer antes que o DtsContainer objeto pare de ser executado. (Herdado de DtsContainer)
Name	Obtém ou define o nome de DtsContainer. (Herdado de DtsContainer)
Parent	Retorna o contêiner pai. O valor é somente leitura. (Herdado de DtsContainer)
Properties	Obtém uma coleção DtsProperties que contém as propriedades associadas à tarefa.
Site	Obtém ou define o local do contêiner. (Herdado de DtsContainer)
StartTime	Retorna a hora em que o contêiner começou execução. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
StopTime	Retorna a hora em que o contêiner encerrou a execução. Esta propriedade é somente para leitura. (Herdado de DtsContainer)
SuspendRequired	Obtém ou define um booliano que indica se as tarefas devem ser suspensas quando encontram um ponto de interrupção. Esse valor é definido pelo mecanismo de runtime para tarefas e contêineres quando um ponto de interrupção é encontrado. (Herdado de DtsContainer)
TransactionOption	Obtém ou define um valor de enumeração DTSTransactionOption que indica se o contêiner participa de transações. (Herdado de DtsContainer)
VariableDispenser	Retorna um objeto VariableDispenser de forma que as variáveis associadas ao contêiner possam ser bloqueadas. (Herdado de DtsContainer)
Variables	Retorna uma coleção que contém as variáveis associadas a este contêiner. Esta propriedade é somente para leitura. (Herdado de DtsContainer)

Métodos

AcceptBreakpointManager(BreakpointManager)	Este método é chamado pelo mecanismo de tempo de execução quando uma tarefa ou um contêiner é criado e o transmite para um gerenciador de BreakpointManager para permitir que a tarefa crie, remova e verifique o status dos pontos de interrupção. Esse método é chamado pelo runtime e não é usado em código. (Herdado de DtsContainer)
ComputeExpressions(Boolean)	Computa as expressões do objeto TaskHost.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. (Herdado de DtsContainer)
Equals(Object)	Determina se duas instâncias de objeto são iguais. (Herdado de DtsObject)
Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object)	Executa o aplicativo, o contêiner ou o pacote como parte de um fluxo de trabalho de pacote. (Herdado de DtsContainer)
GetExecutionPath()	Retorna o caminho de execução do TaskHost atual.
GetExpression(String)	Retorna a expressão para a propriedade especificada. Nulo significa que nenhuma expressão é atribuída.
GetHashCode()	Retorna o código hash para a instância. (Herdado de DtsObject)
GetPackagePath()	Retorna o caminho para o local da tarefa.
LoadFromXML(XmlNode, IDTSEvents)	Esse método não pode ser chamado por seu código de aplicativo. Para carregar um pacote salvo como .xml, use o método LoadPackage(String, IDTSEvents). (Herdado de DtsContainer)
ResumeExecution()	Retoma a execução da tarefa depois de pausar. A tarefa ou o contêiner é retomado pelo mecanismo de runtime. (Herdado de DtsContainer)
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	Esse método não pode ser chamado por seu código de aplicativo. Para salvar um pacote como .xml, use o método SaveToXml(String, Package, IDTSEvents). (Herdado de DtsContainer)
SetExpression(String, String)	Atribui a expressão especificada à propriedade. Especifique nulo para remover uma expressão existente da propriedade.
SetWrappedExecutable(IDTSExecutable100)	Retorna o objeto executável encapsulado. (Herdado de EventsProvider)
SuspendExecution()	Chamado quando o executável precisa ser suspenso. Esse método é chamado pelo mecanismo de runtime. (Herdado de DtsContainer)
Validate(Connections, Variables, IDTSEvents, IDTSLogging)	Permite que o contêiner determine se ele contém configurações inválidas que o impedirão de ser executado com êxito. (Herdado de DtsContainer)

Eventos

Disposed

Adiciona um manipulador de eventos para escutar o evento Disposed no componente.

(Herdado de DtsContainer)

Aplica-se a

Compartilhar via