LogProviderBase.Validate(IDTSInfoEvents) 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í.
Se utiliza para confirmar que el proveedor de registro está configurado correctamente.
public:
virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events);public virtual Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events);abstract member Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
override this.Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResultPublic Overridable Function Validate (events As IDTSInfoEvents) As DTSExecResultParámetros
- events
- IDTSInfoEvents
Una interfaz IDTSInfoEvents que se utiliza para desencadenar los eventos de información durante la ejecución del paquete.
Devoluciones
Un valor de la estructura DTSExecResult que indica si la validación finalizó correctamente o no.
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 para detectar errores o configuraciones incorrectas. El método no toca los datos ni se conecta a los orígenes de datos para validar las conexiones. Sin embargo, garantiza que los campos obligatorios se rellenan y contienen los valores adecuados. Los campos validados difieren en función de qué objeto se valida. En el caso de los proveedores de registro, el Validate método comprueba que la ConfigString propiedad está configurada correctamente y cualquier otra propiedad o configuración necesaria para el proveedor de registro se establezca según lo previsto. Los proveedores de registro que requieren conexiones a orígenes de datos externos lo hacen mediante el uso de ConnectionManager objetos . La ConfigString propiedad se usa a menudo para contener el nombre o el identificador de un ConnectionManager elemento de la Connections colección.
En este caso, Validate debe comprobar que el ConnectionManager especificado en la ConfigString propiedad existe en el paquete.
Si Failure se devuelve , se cancela la ejecución del paquete.
El uso principal de Validate es al escribir una tarea personalizada. El Validate Diseñador de SSIS llama al método cuando se quita una tarea en la superficie de diseño y de nuevo, 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 encuentra una circunstancia única en la que se necesita.
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, consulte Codificación de una tarea personalizada.