ScriptObjectModel 클래스

정의

네임스페이스:

Microsoft.SqlServer.Dts.Tasks.ScriptTask

어셈블리:

Microsoft.SqlServer.ScriptTask.dll

스크립트 태스크의 개발자에게 전역 Dts 개체를 통해 패키지에 정의된 개체에 프로그래밍 방식으로 액세스할 수 있도록 합니다. Dts 개체는 클래스의 ScriptObjectModel 인스턴스입니다.

public ref class ScriptObjectModel

public class ScriptObjectModel

type ScriptObjectModel = class

Public Class ScriptObjectModel

상속

Object

ScriptObjectModel

예제

스크립트 태스크 내에서 사용할 코드의 다음 샘플은 , Events및 TaskResult 속성의 Variables사용을 보여 줍니다. 자세한 내용은 스크립트 태스크를 사용하여 Active Directory 쿼리를 참조하세요.

Public Sub Main()  

    Dim directory As DirectoryServices.DirectorySearcher  
    Dim result As DirectoryServices.SearchResult  
    Dim email As String  

    email = Dts.Variables("email").Value.ToString  

    Try  
        directory = New _  
            DirectoryServices.DirectorySearcher("(mail=" & email & ")")  
        result = directory.FindOne  
        Dts.Variables("name").Value = _  
            result.Properties("displayname").ToString  
        Dts.Variables("title").Value = _  
            result.Properties("title").ToString  
        Dts.TaskResult = ScriptResults.Success  
    Catch ex As Exception  
        Dts.Events.FireError(0, _  
            "Script Task Example", _  
            ex.Message & ControlChars.CrLf & ex.StackTrace, _  
            String.Empty, 0)  
        Dts.TaskResult = ScriptResults.Failure  
    End Try  

End Sub  

설명

VSTA(Microsoft Visual Studio Tools for Applications) 스크립팅 환경 내에서 스크립트 태스크는 개발자가 클래스의 속성 및 메서드를 통해 연결, 변수 및 이벤트와 같은 패키지의 다른 곳에 정의된 개체에 프로그래밍 방식으로 액세스할 수 있는 전역 Dts 개체를 ScriptObjectModel 제공합니다. Dts 개체는 ScriptObjectModel 클래스의 인스턴스입니다.

속성

Connections	스크립트 태스크를 포함하는 패키지에 정의된 기존 연결의 Connections 컬렉션을 반환합니다.
Events	스크립트 태스크를 포함하는 패키지에 정의된 기존 이벤트의 IDTSComponentEvents 컬렉션을 반환합니다.
ExecutionValue	태스크 실행 결과에 대한 추가 정보를 제공하는 사용자 정의 개체를 가져오거나 설정합니다.
TaskResult	스크립트 태스크의 DTSExecResult를 반환합니다.
Transaction	스크립트 태스크의 컨테이너와 연결된 트랜잭션을 반환합니다.
VariableDispenser	기존 변수와 함께 작동하는 스크립트 태스크 내에서 사용할 수 있는 VariableDispenser를 반환합니다.
Variables	스크립트 태스크를 포함하는 패키지에 정의된 기존 변수의 Variables 컬렉션을 반환합니다.

메서드

Log(String, Int32, Byte[])

사용할 수 있는 모든 로그 공급자에 대한 항목을 로깅합니다.