다음을 통해 공유


ScriptTask 클래스

정의

개발자가 Integration Services에서 제공하는 기본 제공 작업에서 사용할 수 없는 함수를 수행하는 사용자 지정 코드를 작성할 수 있도록 스크립트 태스크에 대한 클래스를 정의합니다.

public ref class ScriptTask : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSBreakpointSite, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.scripttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ScriptTask.Localized), SamplesTag="SsisScriptTask", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptTaskUI, Microsoft.SqlServer.ScriptTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Runtime.InteropServices.Guid("04FAEAC9-FB98-4F21-8F96-0E857B739740")]
public class ScriptTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist
[System.Runtime.InteropServices.ComVisible(true)]
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.scripttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ScriptTask.Localized), SamplesTag="SsisScriptTask", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptTaskUI, Microsoft.SqlServer.ScriptTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("4DF420FB-D5C2-4357-8FBE-ECB5E15554F8")]
public class ScriptTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist
[System.Runtime.InteropServices.ComVisible(true)]
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.scripttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ScriptTask.Localized), SamplesTag="SsisScriptTask", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptTaskUI, Microsoft.SqlServer.ScriptTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("C2F3965A-3FE3-482B-A6F3-2514B78E149D")]
public class ScriptTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.scripttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ScriptTask.Localized), SamplesTag="SsisScriptTask", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptTaskUI, Microsoft.SqlServer.ScriptTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Runtime.InteropServices.Guid("04FAEAC9-FB98-4F21-8F96-0E857B739740")>]
type ScriptTask = class
    inherit Task
    interface IDTSBreakpointSite
    interface IDTSSuspend
    interface IDTSComponentPersist
[<System.Runtime.InteropServices.ComVisible(true)>]
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.scripttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ScriptTask.Localized), SamplesTag="SsisScriptTask", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptTaskUI, Microsoft.SqlServer.ScriptTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("4DF420FB-D5C2-4357-8FBE-ECB5E15554F8")>]
type ScriptTask = class
    inherit Task
    interface IDTSBreakpointSite
    interface IDTSSuspend
    interface IDTSComponentPersist
[<System.Runtime.InteropServices.ComVisible(true)>]
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.scripttask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.ScriptTask.Localized), SamplesTag="SsisScriptTask", TaskType="DTS90", UITypeName="Microsoft.SqlServer.Dts.Tasks.ScriptTask.ScriptTaskUI, Microsoft.SqlServer.ScriptTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("C2F3965A-3FE3-482B-A6F3-2514B78E149D")>]
type ScriptTask = class
    inherit Task
    interface IDTSBreakpointSite
    interface IDTSSuspend
    interface IDTSComponentPersist
Public Class ScriptTask
Inherits Task
Implements IDTSBreakpointSite, IDTSComponentPersist
상속
ScriptTask
특성
구현

예제

콘솔 애플리케이션 ScriptTask 에서 구현된 다음 코드 샘플은 패키지에 추가하고 일부 속성의 기본값을 표시합니다.

using System;  
using Microsoft.SqlServer.Dts.Runtime;  

namespace ScriptTaskCS  
{  
  class Program  
  {  
    static void Main(string[] args)  
    {  
      Package pkg = new Package();  
      string newLine = System.Environment.NewLine;  

      Executable exe = pkg.Executables.Add("STOCK:ScriptTask");  
      TaskHost thTask = (TaskHost)exe;  

      string taskInfo;  
      taskInfo =   

        "Entry point: " +   
        thTask.Properties["EntryPoint"].GetValue(thTask) + newLine +   
        "Script Language: " +   
        thTask.Properties["ScriptLanguage"].GetValue(thTask) + newLine +   
        "ReadOnlyVariables: " +   
        thTask.Properties["ReadOnlyVariables"].GetValue(thTask) + newLine +   
        "ReadWriteVariables: " +   
        thTask.Properties["ReadWriteVariables"].GetValue(thTask);  

      Console.WriteLine(taskInfo);  
      Console.Read();  
    }  
  }  
}  
Imports Microsoft.SqlServer.Dts.Runtime  

Module Module1  

  Sub Main()  

    Dim pkg As New Package  
    Dim newLine As String = System.Environment.NewLine  

    Dim exe As Executable = pkg.Executables.Add("STOCK:ScriptTask")  
    Dim thTask As TaskHost = CType(exe, TaskHost)  

    Dim taskInfo As String  
    taskInfo =   

      "Entry point: " & _  
      thTask.Properties("EntryPoint").GetValue(thTask) & newLine & _  
      "Script Language: " & _  
      thTask.Properties("ScriptLanguage").GetValue(thTask) & newLine & _  
      "ReadOnlyVariables: " & _  
      thTask.Properties("ReadOnlyVariables").GetValue(thTask) & newLine & _  
      "ReadWriteVariables: " & _  
      thTask.Properties("ReadWriteVariables").GetValue(thTask)  

    Console.WriteLine(taskInfo)  
    Console.Read()  

  End Sub  

End Module  

설명

이 클래스는 ScriptTask 스크립트 태스크를 정의하고 스크립트 태스크와 런타임 및 Visual Studio for Applications의 상호 작용을 처리합니다.

자세한 내용은 스크립트 태스크스크립트 태스크 코딩 및 디버깅을 참조하세요.

생성자

ScriptTask()

ScriptTask 클래스의 새 인스턴스를 초기화합니다.

속성

BreakpointManager

이 태스크에 대한 중단점을 제어하는 데 사용되는 BreakpointManager를 가져옵니다.

Breakpoints

이 태스크에 대해 설정된 중단점의 배열을 가져옵니다.

DebugMode

태스크가 디버그 모드에서 실행 중인지 여부와 이 태스크가 실행 중일 때 OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) 이벤트를 발생시켜야 할지 여부를 나타내는 값을 가져오거나 설정합니다.

DefaultActiveItem

기본 스크립트를 가져옵니다.

EntryPoint

진입점으로 실행되는 클래스의 이름을 가져오거나 설정합니다.

ExecutionValue

사용자 정의 개체를 가져옵니다. 이 필드는 읽기 전용입니다.

ProjectTemplatePath

지정한 프로젝트 템플릿의 경로를 가져옵니다.

ReadOnlyVariables

읽기 전용 액세스를 위해 사용자가 패키지에서 사용할 수 있도록 만든 기존 변수의 쉼표로 구분된 목록을 가져오거나 설정합니다.

ReadWriteVariables

읽기/쓰기 액세스를 위해 사용자가 패키지에서 사용할 수 있도록 만든 기존 변수의 쉼표로 구분된 목록을 가져오거나 설정합니다.

ScriptingEngine

VSTATaskScriptingEngine 클래스를 가져옵니다.

ScriptLanguage

스크립트를 작성하는 데 사용되는 프로그래밍 언어를 가져오거나 설정합니다.

ScriptLoaded

태스크에 사용자 지정 스크립트가 포함되었는지 여부를 나타내는 값을 가져옵니다.

ScriptProjectName

스크립트 프로젝트의 이름을 가져오거나 설정합니다.

ScriptStorage

스크립트에 대한 VSTAScriptProjectStorage를 가져옵니다.

SuspendRequired

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

TargetServerVersion

개발자가 Integration Services에서 제공하는 기본 제공 작업에서 사용할 수 없는 함수를 수행하는 사용자 지정 코드를 작성할 수 있도록 스크립트 태스크에 대한 클래스를 정의합니다.

(다음에서 상속됨 Task)
Version

멤버는 더 이상 사용되지 않습니다. 은 비고를 참조하세요. *** 태스크 버전을 반환합니다. 이 속성은 읽기 전용입니다.

(다음에서 상속됨 Task)

메서드

AcceptBreakpointManager(BreakpointManager)

BreakpointManager를 태스크에 전달합니다. 이 메서드는 런타임을 통해 호출되며 코드에 사용되지 않습니다.

CanUpdate(String)

멤버는 더 이상 사용되지 않습니다. 은 비고를 참조하세요. 새 패키지 XML이 이전 패키지 XML을 업데이트할 수 있는지 여부를 나타내는 부울입니다.

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

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

(다음에서 상속됨 DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

DTS 스크립트 태스크의 이 인스턴스에 포함된 스크립트를 실행합니다.

Finalize()

ScriptTask에서 사용하는 모든 리소스를 해제합니다.

GetConnectionID(Connections, String)

연결 ID를 포함하는 String을 가져옵니다.

(다음에서 상속됨 Task)
GetConnectionName(Connections, String)

연결 이름을 포함하는 String을 가져옵니다.

(다음에서 상속됨 Task)
GetHashCode()

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

(다음에서 상속됨 DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

스크립트 태스크와 연결된 속성을 초기화합니다. 이 메서드는 런타임을 통해 호출되며 코드에 사용되지 않습니다.

LoadFromXML(XmlElement, IDTSInfoEvents)

XML 문서에서 속성을 로드하는 기능을 구현합니다.

ReportBreakpointChanges()

태스크의 중단점 변경 내용을 보고합니다.

ResumeExecution()

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

SaveToXML(XmlDocument, IDTSInfoEvents)

XML 문서에 속성을 저장하는 기능을 구현합니다.

SetUniqueScriptProjectName()

스크립트 프로젝트의 고유 이름을 설정합니다.

SuspendExecution()

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

Update(String)

멤버는 더 이상 사용되지 않습니다. 은 비고를 참조하세요. 이 메서드는 true로 설정된 경우 CanUpdate(String) 이전 패키지 XML을 새 패키지 XML로 업데이트합니다.

(다음에서 상속됨 Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

구성 요소가 제대로 구성되었는지 확인합니다.

적용 대상