ForEachEnumeratorHost.Validate Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Permite al host determinar si hay valores de configuración no válidos que impedirán al ForEachEnumerator ejecutarse correctamente.
public:
virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ infoEvents, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);public Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents infoEvents, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);abstract member Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
override this.Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResultPublic Function Validate (connections As Connections, variableDispenser As VariableDispenser, infoEvents As IDTSInfoEvents, log As IDTSLogging) As DTSExecResultParámetros
- connections
- Connections
Una colección de conexiones utilizadas por ForEachEnumerator.
- variableDispenser
- VariableDispenser
Un objeto VariableDispenser para bloquear variables.
- infoEvents
- IDTSInfoEvents
Objeto que implementa la interfaz IDTSInfoEvents.
- log
- IDTSLogging
Objeto que implementa la interfaz IDTSLogging.
Devoluciones
Una enumeración DTSExecResult que indica el resultado de la validación.
Implementaciones
Ejemplos
En el ejemplo de código siguiente se muestra cómo validar objetos mediante el Validate método del Package objeto .
DTSExecResult myresult = pkg.Validate(myPkgConnections, myPkgVariables, myIDTSEvents, myIDTSLogging);
Dim myresult As DTSExecResult = pkg.Validate(myPkgConnections,myPkgVariables,myIDTSEvents, myIDTSLogging)
Comentarios
El Validate método revisa las propiedades y la configuración en busca de imprecisiones o configuraciones incorrectas. El método no toca los datos ni se conecta a orígenes de datos para validar las conexiones. Sin embargo, garantiza que los campos obligatorios se rellenan y contienen los valores adecuados. Los campos que se validan difieren en función de qué objeto se valida.
El uso principal de Validate es al escribir una tarea personalizada. El Validate Diseñador de SSIS llama al método cuando una tarea se coloca en la superficie de diseño y, potencialmente, varias veces, cuando se establecen propiedades. Sin embargo, en el código, el Validate método en objetos individuales no se usa normalmente, ya que se recomienda llamar al Validate método en Package cuando necesite validar objetos. Sin embargo, el método está disponible en objetos individuales si se encuentra una circunstancia única en la que es necesario.
El Validate método se invalida en tareas personalizadas, ya sea para la validación del objeto cuando se usa en el Diseñador de SSIS o cuando se llama por código. Para obtener más información sobre cómo escribir el Validate método para una tarea personalizada, vea Codificación de una tarea personalizada.