ScriptObjectModel Classe

Referência

Definição

Namespace:: Microsoft.SqlServer.Dts.Tasks.ScriptTask

Assembly:: Microsoft.SqlServer.ScriptTask.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece ao desenvolvedor da tarefa Script acesso programático a objetos definidos no pacote por meio do objeto Dts global. O objeto Dts é uma instância da ScriptObjectModel classe.

public ref class ScriptObjectModel

public class ScriptObjectModel

type ScriptObjectModel = class

Public Class ScriptObjectModel

Herança: Object
ScriptObjectModel

Exemplos

O exemplo a seguir de código para uso dentro de uma tarefa Script demonstra o uso do , Eventse TaskResult das Variablespropriedades. Para obter mais informações, consulte Consultar o Active Directory com a Tarefa Script.

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

Comentários

Dentro do ambiente de script vsta (Microsoft Visual Studio Tools for Applications), a tarefa Script fornece o objeto globalDts, que fornece ao desenvolvedor acesso programático a objetos definidos em outro lugar no pacote, como conexões, variáveis e eventos, por meio das propriedades e métodos da ScriptObjectModel classe. O objeto Dts é uma instância da classe ScriptObjectModel.

Propriedades

Connections	Retorna a coleção Connections de conexões existentes definidas no pacote que contém a tarefa Script.
Events	Retorna a coleção IDTSComponentEvents de eventos existentes definidos no pacote que contém a tarefa Script.
ExecutionValue	Obtém ou define um objeto definido pelo usuário que fornece informações adicionais sobre os resultados da execução da tarefa.
TaskResult	Retorna o DTSExecResult da tarefa Script.
Transaction	Retorna a transação associada ao contêiner da tarefa Script.
VariableDispenser	Retorna o VariableDispenser que pode ser usado dentro da tarefa Script para funcionar com variáveis existentes.
Variables	Retorna a coleção Variables de variáveis existentes definidas no pacote que contém a tarefa Script.

Métodos

Log(String, Int32, Byte[])

Registra uma entrada em log para todos os provedores de log habilitados.

Aplica-se a