ScriptObjectModel Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет разработчику задачи Script программный доступ к объектам, определённым в пакете, через глобальный объект Dts. Объект Dts является экземпляром класса ScriptObjectModel .
public ref class ScriptObjectModel
public class ScriptObjectModel
type ScriptObjectModel = class
Public Class ScriptObjectModel
- Наследование
-
ScriptObjectModel
Примеры
Следующий пример кода для использования внутри задачи Script демонстрирует использование Variablesсвойств , Events, и TaskResult свойств. Для получения дополнительной информации см. раздел «Запрос к 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
Комментарии
В среде скриптов Microsoft Visual Studio Tools for Applications (VSTA) задача Script предоставляет глобальный Dts объект, который даёт разработчику программный доступ к объектам, определённым в других местах пакета, таким как соединения, переменные и события, через свойства и методы ScriptObjectModel класса.
Dts Объект является экземпляром ScriptObjectModel класса.
Свойства
| Имя | Описание |
|---|---|
| Connections |
Возвращает Connections коллекцию существующих соединений, определённых в пакете, содержащем задачу Script. |
| Events |
Возвращает IDTSComponentEvents коллекцию существующих событий, определённых в пакете, содержащем задачу Script. |
| ExecutionValue |
Получает или устанавливает пользовательский объект, который предоставляет дополнительную информацию о результатах выполнения задачи. |
| TaskResult |
Возвращает DTSExecResult задачу Script. |
| Transaction |
Возвращает транзакцию, связанную с контейнером задачи Script. |
| VariableDispenser |
Возвращает то, VariableDispenser что можно использовать в задаче Script для работы с существующими переменными. |
| Variables |
Возвращает Variables коллекцию существующих переменных, определённых в пакете, содержащем задачу Script. |
Методы
| Имя | Описание |
|---|---|
| Log(String, Int32, Byte[]) |
Ведёт запись ко всем включённым провайдерам логов. |