FileSystemTask.Validate Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Проверяет, правильно ли настроена задача.
public:
override Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSComponentEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);
public override Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);
override this.Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
Public Overrides Function Validate (connections As Connections, variableDispenser As VariableDispenser, events As IDTSComponentEvents, log As IDTSLogging) As DTSExecResult
Параметры
- connections
- Connections
Коллекция соединений, используемых задачей.
- variableDispenser
- VariableDispenser
Объект VariableDispenser для блокировки переменных.
- events
- IDTSComponentEvents
Объект, реализующий интерфейс IDTSComponentEvents.
- log
- IDTSLogging
Объект, реализующий интерфейс IDTSComponentEvents.
Возвращаемое значение
Значение из перечисления 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
метода для пользовательской задачи см. в разделе "Написание пользовательской задачи".