TaskHost Clase

Definición

Espacio de nombres:

Microsoft.SqlServer.Dts.Runtime

Ensamblado:

Microsoft.SqlServer.ManagedDTS.dll

Proporciona un contenedor que encapsula una tarea única. En el Diseñador SSIS, el objeto TaskHost no se configura independientemente; en su lugar, se configura al establecer las propiedades de la tarea que 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

Herencia

Object

DtsObject

Executable

DtsContainer

EventsProvider

TaskHost

Implementaciones

IDTSExecutionPath IDTSObjectHost IDTSPackagePath IDTSPropertiesProvider IDTSPropertiesProviderEx

Ejemplos

En el ejemplo de código siguiente se muestra la creación de un paquete vacío. Se agregan dos tareas al paquete y se convierten en una TaskHost clase, por lo que TaskHost se pueden usar métodos y propiedades en cualquiera de las tareas , como el InnerObject método , sin tener en cuenta el tipo de tarea que es.

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  

Salida del ejemplo:

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

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

Comentarios

Integration Services proporciona varios tipos diferentes de contenedores para compilar paquetes, siendo TaskHost uno de esos contenedores. El TaskHost contenedor proporciona servicios a una sola tarea. No tiene un elemento coincidente en el cuadro de herramientas del diseñador gráfico. El TaskHost objeto es un objeto contenedor para la tarea y se crea de forma transparente durante la creación de la tarea. Se devuelve del Add método como un Executable objeto y se convierte como .TaskHost Por último, se obtiene acceso a la instancia de tarea a través de la InnerObject propiedad . Para más información sobre todos los contenedores de SSIS, consulte Contenedores de Integration Services.

Campos

m_executable

El ejecutable. (Heredado de Executable)

Propiedades

ApartmentThreaded	Obtiene un valor que indica si la tarea es un objeto de subproceso controlado.
CreationName	Devuelve la cadena que se utiliza para crear una instancia del objeto DtsContainer. Esta propiedad es de solo lectura. (Heredado de DtsContainer)
DebugMode	Obtiene o establece un valor booleano que indica si el DtsContainer objeto está en modo de depuración y si se debe activar el OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) evento mientras se ejecuta. (Heredado de DtsContainer)
DelayValidation	Obtiene o establece un valor booleano que indica si la validación de la tarea se retrasa hasta el tiempo de ejecución. El valor predeterminado es false. (Heredado de DtsContainer)
Description	Obtiene o establece la descripción del objeto DtsContainer. (Heredado de DtsContainer)
Disable	Valor booleano que indica si el DtsContainer objeto está deshabilitado. (Heredado de DtsContainer)
DisableEventHandlers	Obtiene o establece un valor booleano que indica si los controladores de eventos de la tarea están deshabilitados. (Heredado de EventsProvider)
EventHandlers	Devuelve una colección de objetos controladores de eventos. Este campo es de solo lectura. (Heredado de EventsProvider)
EventInfos	Devuelve una colección de objetos EventInfo. Este campo es de solo lectura. (Heredado de EventsProvider)
ExecutionDuration	Devuelve un valor que indica la cantidad de tiempo, en milisegundos, que el contenedor invirtió en la ejecución. Esta propiedad es de solo lectura. (Heredado de DtsContainer)
ExecutionResult	Devuelve un valor que indica si la ejecución del objeto DtsContainer finalizó correctamente o no. (Heredado de DtsContainer)
ExecutionStatus	Devuelve un valor que indica el estado actual de la ejecución del objeto DtsContainer en el momento de la llamada. (Heredado de DtsContainer)
ExecutionValue	Obtiene el resultado de la ejecución de la tarea. Esta propiedad es de solo lectura.
ExecValueVariable	Obtiene o establece el objeto Variable personalizado que contiene los resultados de ejecución de la tarea.
FailPackageOnFailure	Obtiene o establece un valor booleano que indica si se produce un error en el paquete cuando se produce un error en un contenedor secundario. Esta propiedad se utiliza en los contenedores, no en el propio paquete. (Heredado de DtsContainer)
FailParentOnFailure	Obtiene o establece un valor de tipo Boolean que define si el contenedor primario da error cuando se produce un error en un contenedor secundario. (Heredado de DtsContainer)
ForcedExecutionValue	Si la ForceExecutionValue propiedad se establece en True, obtiene o establece un valor que especifica el valor de ejecución opcional que devuelve el paquete. (Heredado de DtsContainer)
ForceExecutionResult	Obtiene o establece un valor de enumeración DTSForcedExecResult que especifica el resultado de la ejecución forzada del contenedor. (Heredado de DtsContainer)
ForceExecutionValue	Obtiene o establece un valor booleano que indica si se debe forzar el valor de ejecución del contenedor para que contenga un valor determinado. (Heredado de DtsContainer)
HasExpressions	Obtiene un valor que indica si el objeto TaskHost tiene expresiones.
HostType	Recibe un valor de la enumeración DTSObjectHostType que describe el host del contenedor. Esta propiedad es de solo lectura.
ID	Devuelve el identificador GUID de DtsContainer. El valor es de solo lectura. (Heredado de DtsContainer)
InnerObject	Obtiene el método utilizado para obtener acceso a la instancia de la tarea hospedada por el TaskHost.
IsDefaultLocaleID	Valor booleano que indica si el contenedor usa la configuración regional predeterminada. Esta propiedad es de solo lectura. (Heredado de DtsContainer)
IsolationLevel	Obtiene o establece el nivel de aislamiento de la transacción en el objeto DtsContainer. (Heredado de DtsContainer)
LocaleID	Obtiene o establece un valor integer que indica el identificador de configuración regional de Microsoft Win32® que se va a usar cuando se ejecuta el DtsContainer objeto. (Heredado de DtsContainer)
LogEntryInfos	Devuelve un objeto LogEntryInfos. Esta propiedad es de solo lectura. (Heredado de DtsContainer)
LoggingMode	Obtiene o establece un valor válido de la enumeración DTSLoggingMode que indica el modo de registro del contenedor. (Heredado de DtsContainer)
LoggingOptions	Devuelve un objeto que contiene propiedades que indican el recurso de filtrado y registro para los contenedores. Esta propiedad es de solo lectura. (Heredado de DtsContainer)
MaximumErrorCount	Obtiene o establece un valor entero que indica el número máximo de errores que pueden producirse antes de que el DtsContainer objeto deje de ejecutarse. (Heredado de DtsContainer)
Name	Obtiene o establece el nombre de DtsContainer. (Heredado de DtsContainer)
Parent	Devuelve el contenedor primario. El valor es de solo lectura. (Heredado de DtsContainer)
Properties	Obtiene una colección DtsProperties que contiene las propiedades asociadas a la tarea.
Site	Obtiene o establece el sitio del contenedor. (Heredado de DtsContainer)
StartTime	Devuelve la hora en la que el contenedor comenzó su ejecución. Esta propiedad es de solo lectura. (Heredado de DtsContainer)
StopTime	Devuelve la hora en la que el contenedor finalizó su ejecución. Esta propiedad es de solo lectura. (Heredado de DtsContainer)
SuspendRequired	Obtiene o establece un valor booleano que indica si las tareas deben suspenderse cuando encuentran un punto de interrupción. El motor en tiempo de ejecución establece este valor para tareas y contenedores cuando se encuentra un punto de interrupción. (Heredado de DtsContainer)
TransactionOption	Obtiene o establece un valor de enumeración DTSTransactionOption que indica si el contenedor participa en transacciones. (Heredado de DtsContainer)
VariableDispenser	Devuelve un objeto VariableDispenser para poder bloquear las variables asociadas al contenedor. (Heredado de DtsContainer)
Variables	Devuelve una colección que contiene las variables asociadas a este contenedor. Esta propiedad es de solo lectura. (Heredado de DtsContainer)

Métodos

AcceptBreakpointManager(BreakpointManager)	El motor de tiempo de ejecución llama a este método cuando se crea una tarea o un contenedor, y le pasa un administrador BreakpointManager para permitir a la tarea crear, quitar y comprobar el estado de los puntos de interrupción. El motor en tiempo de ejecución llama a este método, que no se usa en el código. (Heredado de DtsContainer)
ComputeExpressions(Boolean)	Calcula las expresiones del objeto TaskHost.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Heredado de DtsContainer)
Equals(Object)	Determina si dos instancias de objeto son iguales. (Heredado de DtsObject)
Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object)	Ejecuta la aplicación, el contenedor o el paquete como parte de un flujo de trabajo de paquetes. (Heredado de DtsContainer)
GetExecutionPath()	Devuelve la ruta de acceso de ejecución del objeto TaskHost actual.
GetExpression(String)	Devuelve la expresión para la propiedad especificada. Null significa que no se asigna ninguna expresión.
GetHashCode()	Devuelve el código hash de esta instancia. (Heredado de DtsObject)
GetPackagePath()	Devuelve la ruta de acceso a la ubicación de la tarea.
LoadFromXML(XmlNode, IDTSEvents)	No se pueden realizar llamadas a este método desde el código de la aplicación. Para cargar un paquete guardado como .xml, utilice el método LoadPackage(String, IDTSEvents). (Heredado de DtsContainer)
ResumeExecution()	Reanuda la ejecución de la tarea después de una pausa. El motor de ejecución se encarga de reanudar la tarea o el contenedor. (Heredado de DtsContainer)
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	No se pueden realizar llamadas a este método desde el código de la aplicación. Para guardar un paquete como .xml, utilice el método SaveToXml(String, Package, IDTSEvents). (Heredado de DtsContainer)
SetExpression(String, String)	Asigna la expresión especificada a la propiedad. Especifique null para quitar una expresión existente de la propiedad .
SetWrappedExecutable(IDTSExecutable100)	Devuelve el objeto ejecutable encapsulado. (Heredado de EventsProvider)
SuspendExecution()	Se utiliza cuando es necesario suspender el ejecutable. El motor de ejecución llama a este método. (Heredado de DtsContainer)
Validate(Connections, Variables, IDTSEvents, IDTSLogging)	Permite al contenedor determinar si contiene valores de configuración no válidos que no permitirán su ejecución correcta. (Heredado de DtsContainer)

Eventos

Disposed

Agrega un controlador de eventos para escuchar el evento Disposed sobre el componente. (Heredado de DtsContainer)