Executable.Validate(Connections, Variables, IDTSEvents, IDTSLogging) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Проверяет возможность успешного выполнения исполняемого объекта, проверив все его зависимости и другие элементы перед выполнением. Компонент, который реализует этот метод, является проверяемым компонентом.
public:
abstract Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::Variables ^ variables, Microsoft::SqlServer::Dts::Runtime::IDTSEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);
public abstract Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.Variables variables, Microsoft.SqlServer.Dts.Runtime.IDTSEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);
abstract member Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.Variables * Microsoft.SqlServer.Dts.Runtime.IDTSEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
Public MustOverride Function Validate (connections As Connections, variables As Variables, events As IDTSEvents, log As IDTSLogging) As DTSExecResult
Параметры
- connections
- Connections
Коллекция Connections.
- events
- IDTSEvents
Интерфейс IDTSEvents для формирования событий.
- log
- IDTSLogging
Интерфейс IDTSLogging.
Возвращаемое значение
Возвращает значение из перечисления DTSExecResult, которое обозначает успех, неудачное завершение или другое состояние, ставшее результатом проверки исполняемого объекта.
Примеры
В следующем примере кода показано, как проверить объекты с помощью Validate
метода Package объекта.
DTSExecResult myresult = pkg.Validate(myPkgConnections, myPkgVariables, myIDTSEvents, myIDTSLogging);
Dim myresult As DTSExecResult = pkg.Validate(myPkgConnections,myPkgVariables,myIDTSEvents, myIDTSLogging)
Комментарии
Метод Validate
проверяет свойства и параметры на наличие неточностей или неверных параметров. Метод не касается данных или не подключается к источникам данных для проверки подключений. Однако это гарантирует, что обязательные поля заполняются и содержат соответствующие значения. Проверяемые поля различаются в зависимости от проверяемого объекта.
Основное использование заключается в написании Validate
пользовательской задачи. Метод Validate
вызывается конструктором служб SSIS, когда задача удаляется в область конструктора и снова, потенциально несколько раз, когда задаются свойства. Однако в коде Validate
метод для отдельных объектов часто не используется, так как рекомендуется вызывать Validate
метод для Package проверки объектов. Однако метод доступен для отдельных объектов, если он необходим.
Метод Validate
переопределяется в пользовательских задачах для проверки объекта при использовании в конструкторе служб SSIS или при вызове по коду. Дополнительные сведения о написании Validate
метода для пользовательской задачи см. в разделе "Написание пользовательской задачи".