다음을 통해 공유


TaskHost 클래스

정의

단일 태스크를 캡슐화하는 컨테이너를 제공합니다. SSIS 디자이너에서 TaskHost는 별도로 구성되지 않고 대신 캡슐화되는 태스크의 속성을 설정할 때 구성됩니다.

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
상속
구현

예제

다음 코드 예제에서는 빈 패키지의 생성을 보여 있습니다. 패키지에 두 개의 태스크가 추가되고 클래스로 TaskHost 캐스팅되므로 TaskHost 메서드와 같은 InnerObject 두 태스크에서 메서드와 속성을 사용할 수 있습니다. 이 작업은 어떤 종류의 작업인지에 관계없이 사용할 수 있습니다.

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  

샘플 출력:

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

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

설명

Integration Services는 패키지를 빌드하기 위한 여러 가지 유형의 컨테이너를 제공하며 TaskHost 이러한 컨테이너 중 하나입니다. 컨테이너는 TaskHost 단일 작업에 서비스를 제공합니다. 그래픽 디자이너 도구 상자에 일치하는 항목이 없습니다. 개체는 TaskHost 태스크에 대한 래퍼 개체이며 작업을 만드는 동안 투명하게 만들어집니다. 메서드에서 Add 개체로 Executable 반환되고 TaskHost. 마지막으로 작업 인스턴스는 속성을 통해 액세스됩니다 InnerObject . 모든 SSIS 컨테이너에 대한 자세한 내용은 Integration Services 컨테이너를 참조하세요.

필드

m_executable

실행 파일입니다.

(다음에서 상속됨 Executable)

속성

ApartmentThreaded

아파트 스레드 개체 태스크가 있는지 여부를 나타내는 값을 가져옵니다.

CreationName

DtsContainer 개체의 인스턴스를 만드는 데 사용되는 문자열을 반환합니다. 이 속성은 읽기 전용입니다.

(다음에서 상속됨 DtsContainer)
DebugMode

개체가 디버그 모드인지 여부 DtsContainer 와 실행하는 동안 이벤트를 발생 OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) 시켜야 하는지 여부를 나타내는 부울을 가져오거나 설정합니다.

(다음에서 상속됨 DtsContainer)
DelayValidation

작업의 유효성 검사가 런타임까지 지연되는지 여부를 나타내는 부울을 가져오거나 설정합니다. 기본값은 False입니다.

(다음에서 상속됨 DtsContainer)
Description

DtsContainer 개체에 대한 설명을 가져오거나 설정합니다.

(다음에서 상속됨 DtsContainer)
Disable

개체가 비활성화되었는지 여부를 DtsContainer 나타내는 부울입니다.

(다음에서 상속됨 DtsContainer)
DisableEventHandlers

태스크의 이벤트 처리기가 비활성화되었는지 여부를 나타내는 부울을 가져오거나 설정합니다.

(다음에서 상속됨 EventsProvider)
EventHandlers

이벤트 처리기 개체의 컬렉션을 반환합니다. 이 필드는 읽기 전용입니다.

(다음에서 상속됨 EventsProvider)
EventInfos

EventInfo 개체의 컬렉션을 반환합니다. 이 필드는 읽기 전용입니다.

(다음에서 상속됨 EventsProvider)
ExecutionDuration

컨테이너 실행에 걸린 시간(밀리초)을 나타내는 값을 반환합니다. 이 속성은 읽기 전용입니다.

(다음에서 상속됨 DtsContainer)
ExecutionResult

DtsContainer 개체 실행의 성공 또는 실패를 나타내는 값을 반환합니다.

(다음에서 상속됨 DtsContainer)
ExecutionStatus

호출 시 DtsContainer 개체 실행의 현재 상태를 나타내는 값을 반환합니다.

(다음에서 상속됨 DtsContainer)
ExecutionValue

태스크 실행 결과를 가져옵니다. 이 속성은 읽기 전용입니다.

ExecValueVariable

태스크의 실행 결과를 포함하는 사용자 지정 Variable을 가져오거나 설정합니다.

FailPackageOnFailure

자식 컨테이너가 실패할 때 패키지가 실패하는지 여부를 나타내는 부울을 가져오거나 설정합니다. 이 속성은 패키지 자체가 아닌 컨테이너에 사용됩니다.

(다음에서 상속됨 DtsContainer)
FailParentOnFailure

자식 컨테이너가 실패할 때 부모 컨테이너가 실패할지 여부를 정의하는 Boolean을 가져오거나 설정합니다.

(다음에서 상속됨 DtsContainer)
ForcedExecutionValue

속성이 ForceExecutionValue True로 설정된 경우 패키지에서 반환하는 선택적 실행 값을 지정하는 값을 가져오거나 설정합니다.

(다음에서 상속됨 DtsContainer)
ForceExecutionResult

컨테이너의 강제 실행 결과를 지정하는 DTSForcedExecResult 열거형 값을 가져오거나 설정합니다.

(다음에서 상속됨 DtsContainer)
ForceExecutionValue

컨테이너의 실행 값이 특정 값을 포함하도록 강제해야 하는지 여부를 나타내는 부울을 가져오거나 설정합니다.

(다음에서 상속됨 DtsContainer)
HasExpressions

TaskHost 개체에 식이 있는지 여부를 나타내는 값을 가져옵니다.

HostType

컨테이너의 호스트에 대해 설명하는 DTSObjectHostType 열거형의 값을 가져옵니다. 이 속성은 읽기 전용입니다.

ID

DtsContainer의 GUID인 ID를 반환합니다. 이 값은 읽기 전용입니다.

(다음에서 상속됨 DtsContainer)
InnerObject

TaskHost에서 호스팅되는 태스크 인스턴스에 액세스하는 데 사용되는 메서드를 가져옵니다.

IsDefaultLocaleID

컨테이너가 기본 로캘을 사용하는지 여부를 나타내는 부울입니다. 이 속성은 읽기 전용입니다.

(다음에서 상속됨 DtsContainer)
IsolationLevel

DtsContainer 개체의 트랜잭션에 대한 격리 수준을 가져오거나 설정합니다.

(다음에서 상속됨 DtsContainer)
LocaleID

개체가 실행될 때 사용할 Microsoft Win32® localeID를 나타내는 Integer를 DtsContainer 가져오거나 설정합니다.

(다음에서 상속됨 DtsContainer)
LogEntryInfos

LogEntryInfos 개체를 반환합니다. 이 속성은 읽기 전용입니다.

(다음에서 상속됨 DtsContainer)
LoggingMode

컨테이너의 로깅 모드를 나타내는 DTSLoggingMode 열거형의 올바른 값을 가져오거나 설정합니다.

(다음에서 상속됨 DtsContainer)
LoggingOptions

컨테이너에 대한 필터링 및 로깅 리소스를 나타내는 속성을 포함하는 개체를 반환합니다. 이 속성은 읽기 전용입니다.

(다음에서 상속됨 DtsContainer)
MaximumErrorCount

개체 실행을 중지하기 전에 DtsContainer 발생할 수 있는 최대 오류 수를 나타내는 정수 값을 가져오거나 설정합니다.

(다음에서 상속됨 DtsContainer)
Name

DtsContainer의 이름을 가져오거나 설정합니다.

(다음에서 상속됨 DtsContainer)
Parent

부모 컨테이너를 반환합니다. 이 값은 읽기 전용입니다.

(다음에서 상속됨 DtsContainer)
Properties

태스크와 연결된 속성을 포함하는 DtsProperties 컬렉션을 가져옵니다.

Site

컨테이너에 대한 사이트를 가져오거나 설정합니다.

(다음에서 상속됨 DtsContainer)
StartTime

컨테이너에서 실행을 시작한 시간을 반환합니다. 이 속성은 읽기 전용입니다.

(다음에서 상속됨 DtsContainer)
StopTime

컨테이너에서 실행을 끝낸 시간을 반환합니다. 이 속성은 읽기 전용입니다.

(다음에서 상속됨 DtsContainer)
SuspendRequired

태스크가 중단점을 발견할 때 일시 중단해야 하는지 여부를 나타내는 부울을 가져오거나 설정합니다. 이 값은 중단점에 도달할 때 태스크 및 컨테이너의 런타임 엔진에서 설정됩니다.

(다음에서 상속됨 DtsContainer)
TransactionOption

컨테이너에서 트랜잭션에 참여하는지 여부를 나타내는 DTSTransactionOption 열거형 값을 가져오거나 설정합니다.

(다음에서 상속됨 DtsContainer)
VariableDispenser

컨테이너와 연결된 변수를 잠글 수 있도록 VariableDispenser 개체를 반환합니다.

(다음에서 상속됨 DtsContainer)
Variables

이 컨테이너와 연결된 변수를 포함하는 컬렉션을 반환합니다. 이 속성은 읽기 전용입니다.

(다음에서 상속됨 DtsContainer)

메서드

AcceptBreakpointManager(BreakpointManager)

이 메서드는 태스크 또는 컨테이너가 만들어질 때 런타임 엔진에서 호출되고, 태스크에 BreakpointManager 관리자를 전달하여 태스크에서 중단점을 만들고 제거하며, 중단점 상태를 확인할 수 있도록 허용합니다. 이 메서드는 런타임을 통해 호출되며 코드에 사용되지 않습니다.

(다음에서 상속됨 DtsContainer)
ComputeExpressions(Boolean)

TaskHost 개체의 식을 계산합니다.

Dispose()

관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.

(다음에서 상속됨 DtsContainer)
Equals(Object)

두 개체 인스턴스가 같은지 확인합니다.

(다음에서 상속됨 DtsObject)
Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object)

애플리케이션, 컨테이너 또는 패키지를 패키지 워크플로의 일부분으로 실행합니다.

(다음에서 상속됨 DtsContainer)
GetExecutionPath()

현재 TaskHost의 실행 경로를 반환합니다.

GetExpression(String)

지정한 속성에 대한 식을 반환합니다. Null은 식이 할당되지 않음을 의미합니다.

GetHashCode()

이 인스턴스의 해시 코드를 반환합니다.

(다음에서 상속됨 DtsObject)
GetPackagePath()

태스크 위치에 대한 경로를 반환합니다.

LoadFromXML(XmlNode, IDTSEvents)

이 메서드는 애플리케이션 코드에서 호출할 수 없습니다. .xml로 저장된 패키지를 로드하려면 LoadPackage(String, IDTSEvents) 메서드를 사용합니다.

(다음에서 상속됨 DtsContainer)
ResumeExecution()

일시 중지 이후 태스크 실행을 다시 시작합니다. 태스크 또는 컨테이너는 런타임 엔진에 의해 다시 시작됩니다.

(다음에서 상속됨 DtsContainer)
SaveToXML(XmlDocument, XmlNode, IDTSEvents)

이 메서드는 애플리케이션 코드에서 호출할 수 없습니다. 패키지를 .xml로 저장하려면 SaveToXml(String, Package, IDTSEvents) 메서드를 사용합니다.

(다음에서 상속됨 DtsContainer)
SetExpression(String, String)

지정한 식을 속성에 할당합니다. 속성에서 기존 식을 제거하려면 null을 지정합니다.

SetWrappedExecutable(IDTSExecutable100)

래핑된 실행 개체를 반환합니다.

(다음에서 상속됨 EventsProvider)
SuspendExecution()

실행 파일을 일시 중지해야 할 때 호출됩니다. 이 메서드는 런타임 엔진을 통해 호출됩니다.

(다음에서 상속됨 DtsContainer)
Validate(Connections, Variables, IDTSEvents, IDTSLogging)

컨테이너에서 성공적인 실행을 방해하는 잘못된 설정이 포함되어 있는지 확인할 수 있도록 허용합니다.

(다음에서 상속됨 DtsContainer)

이벤트

Disposed

구성 요소의 Disposed 이벤트를 수신할 이벤트 처리기를 추가합니다.

(다음에서 상속됨 DtsContainer)

적용 대상