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 — при написании индивидуальной задачи. Метод вызывается дизайнером SSIS, когда задача попадает на поверхность проектирования, а также снова, возможно несколько раз, когда устанавливаются Validate свойства. Однако в коде метод Validate для отдельных объектов используется редко, так как рекомендуется вызывать его Validate при Package проверке объектов. Однако метод доступен на отдельных объектах, если вы найдёте уникальную ситуацию, где он необходим.
Метод Validate переопределяется в пользовательских задачах — либо для проверки объекта при использовании в SSIS Designer, либо при вызове кодом. Для получения дополнительной информации о написании Validate метода для пользовательской задачи см. раздел Кодирование пользовательской задачи.