Compartilhar via


TaskHost Classe

Definição

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
Implementações

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