ScriptObjectModel Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Donne au développeur de la tâche de script l’accès par programme aux objets définis dans le package via l’objet Dts global. L’objet Dts est une instance de la ScriptObjectModel classe.
public ref class ScriptObjectModel
public class ScriptObjectModel
type ScriptObjectModel = class
Public Class ScriptObjectModel
- Héritage
-
ScriptObjectModel
Exemples
L’exemple de code suivant à utiliser à l’intérieur d’une tâche de script illustre l’utilisation des propriétés et TaskResult des VariablesEventspropriétés. Pour plus d’informations, consultez Interroger Active Directory avec la tâche de 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
Remarques
Dans l’environnement de script VSTA (Microsoft® Visual Studio® Tools for Applications), la tâche script fournit l’objet globalDts
, qui permet au développeur d’accéder par programme aux objets définis ailleurs dans le package, tels que les connexions, les variables et les événements, par le biais des propriétés et des méthodes de la ScriptObjectModel classe. L'objet Dts
est une instance de la classe ScriptObjectModel.
Propriétés
Connections |
Retourne la collection Connections des connexions existantes, définies dans le package qui contient la tâche de script. |
Events |
Retourne la collection IDTSComponentEvents des événements existants, définis dans le package qui contient la tâche de script. |
ExecutionValue |
Obtient ou définit un objet défini par l'utilisateur qui fournit des informations supplémentaires sur les résultats de l'exécution des tâches. |
TaskResult |
Retourne l'objet DTSExecResult de la tâche de script. |
Transaction |
Retourne la transaction associée au conteneur de la tâche de script. |
VariableDispenser |
Retourne l'objet VariableDispenser qui peut être utilisé dans la tâche de script pour travailler avec des variables existantes. |
Variables |
Retourne la collection Variables des variables existantes, définies dans le package qui contient la tâche de script. |
Méthodes
Log(String, Int32, Byte[]) |
Enregistre une entrée de journal dans tous les modules fournisseurs d'informations activés. |