Visión general del modo de desarrollar aplicaciones ADO.NET utilizando el DB2 Everyplace .NET Data Provider

Los espacios de nombres para el DB2 Everyplace .NET Data Provider son los siguientes:

Ejecución en el .NET Compact Framework: IBM.Data.DB2.DB2e.CF
Ejecución en el .NET Framework: IBM.Data.DB2.DB2e

El DB2 Everyplace .NET Data Provider proporciona funciones para conectarse a una fuente de datos de DB2 Everyplace, la ejecución de mandatos y la recuperación de mandatos. Dichos resultados puede procesarse directamente o ubicarse en un Archivo ADO.NET para proseguir el proceso mientras se está en estado de desconexión. Mientras están en el Archivo, los datos pueden revelarse al usuario, combinados con otros datos procedentes de varias fuentes o pasarse de modo remoto entre niveles. Los procesos que se realicen en los datos mientras estén en el Archivo podrán reconciliarse posteriormente con la fuente de datos.

El diseño de DB2 Everyplace .NET Data Provider es sencillo. Consta de una mínima capa entre DB2 Everyplace y el código que amplía las funciones sin sacrificar el rendimiento.

Las clases de DB2 Everyplace .NET Data Provider heredan o implantan miembros de otras interfaces o clases de .NET Framework. La documentación de este proveedor incluye un resumen de los miembros soportados en cada una de estas clases. Para obtener una información más detallada sobre un miembro heredado específico, consulte el tema apropiado de Microsoft^(R) .NET Framework SDK.

Requisito previo

Tabla 6. Requisitos previos para utilizar el DB2 Everyplace .NET Data Provider

Componente	Requisito mínimo
Microsoft.NET Framework	Microsoft.NET Framework 1.0 Debe instalarse antes que el DB2 Everyplace .NET Data Provider para el desarrollo de la aplicación
Microsoft Visual Studio.NET 2003	Microsoft Visual Studio.NET 2003 para desarrollo de aplicaciones portátiles
Microsoft.NET Compact Framework	Microsoft .NET Compact Framework 1.0 para desarrollo de portátiles Debe instalarse en el dispositivo antes de instalar el DB2 Everyplace .NET Data Provider para el desarrollo de aplicaciones portátiles.
Producto DB2 Everyplace	`DB2e.dll` de la versión 8.1.4 o posterior `AgentProxy.dll` de la versión 8.1.4 o posterior que requiere la llamada al procedimiento almacenado remoto. `wbxmllib.dll` de la versión 8.1.4 o posterior que requiere la llamada al procedimiento almacenado remoto. DB2 Everyplace Sync Server de la versión 8.1.4 o posterior que requiere la llamada al procedimiento almacenado remoto. `DB2e.dll`, `AgentProxy.dll` y `wbxmllib.dll` son bibliotecas nativas y por tanto dependen del procesador; por tanto, el sistema operativo ha de localizar estas bibliotecas nativas (estableciendo la variable de entorno PATH, por ejemplo) para que DB2 Everyplace .NET Data Provider funcione adecuadamente.

Restricciones

Limitaciones del proveedor

En DB2 Everyplace no se permite actualmente la actualización de columnas clave primarias.
La recuperación del conjunto de resultados utilizando un procedimiento almacenado remoto tiene una limitación sobre el tamaño del conjunto de resultados.
No se da soporte a las llamadas de procedimiento almacenado locales.
Para los métodos o propiedades que no estén soportadas, se emitirá una System.NotSupportedException.

Seguridad de hebra

Los miembros públicos no de instancia de este proveedor resultan seguros para las operaciones de varias hebras. No se garantiza que los miembros de instancia tengan seguridad de hebra.

Procedimiento

Hay cuatro objetos de núcleo que constituyen el DB2 Everyplace .NET Data Provider. La tabla siguiente describe estos objetos y su función.

Tabla 7. DB2 Everyplace .NET Data Provider, objetos de núcleo

Objeto	Descripción
DB2eConnection	Establece una conexión para una fuente de datos de DB2 Everyplace y puede comenzar por `Transacción`.
DB2eCommand	Ejecuta un mandato en un servidor de DB2 Everyplace y revela `Parámetros`.
DB2eDataAdapter	Puebla un `Archivo` y resuelve actualizaciones en la fuente de datos de DB2 Everyplace.
DB2eDataReader	Revela y lee una corriente de datos sólo de avance desde una fuente de datos de DB2 Everyplace.

Junto con las clases de núcleo listadas en la tabla precedente, el DB2 .NET Data Provider contiene asimismo las clases listadas en la tabla siguiente.

Tabla 8. DB2 Everyplace .NET Data Provider, clases adicionales

Objeto	Descripción
DB2eCommandBuilder	Objeto de ayuda que generará automáticamente propiedades de mandato del `DB2eDataAdapter` o derivará información de parámetro de un procedimiento almacenado y poblará la colección de `DB2eParameters` de un objeto de `DB2eCommand`. Nota: La utilización del `DB2eCommandBuilder` no se recomienda ya que puede generar sentencias SQL muy ineficaces y, en algunos casos, no válidas.
DB2eError	Revela la información de un aviso o error devuelto por una fuente de datos de DB2 Everyplace.
DB2eException	Se devuelve cuando se encuentra un error en la fuente de datos de DB2 Everyplace. Para los errores encontrados en el cliente, los proveedores de datos de .NET emiten una excepción de .NET Framework.
DB2eParameter	Define parámetros de valor de retorno, salida y entrada para mandatos y procedimientos almacenados.
DB2eTransaction	Le permite reclutar mandatos en las transacciones de la fuente de datos de DB2 Everyplace.

Para utilizar el DB2 Everyplace .NET Data Provider, deberá añadir una sentencia de importación o utilización para el IBM.Data.DB2.DB2e o espacio de nombre al .DLL de la aplicación, tal y como ilustra el código siguiente:

[Visual Basic]: Imports IBM.Data.DB2.DB2e
[C#]: using IBM.Data.DB2.DB2e;

También debe incluir una referencia al .DLL al compilar el código. Por ejemplo, si está compilando un programa Microsoft^(R) Visual C#^(TM), la línea de mandatos debería incluir:

csc /r:IBM.Data.DB2.DB2e.dll

Para el .NET Compact Framework, el espacio de nombres es IBM.Data.DB2.DB2e.CF y la aplicación ha de hacer referencia al conjunto IBM.Data.DB2.DB2e.CF.dll.

Para obtener información sobre el mejor modo de utilizar este espacio de nombre, consulte la documentación sobre las siguientes clases de DB2 Everyplace.NET Data Provider:

Para obtener más información sobre el modo en el que el DB2 Everyplace .NET Data Provider funciona en el .NET Framework, consulte IBM.Data.DB2.DB2e Hierarchy.

Tabla 9. Clases

Objeto	Descripción
DB2eCommand	Representa el procedimiento almacenado o la sentencia SQL que ha de ejecutarse frente a la fuente de datos. Esta clase no puede heredarse.
DB2eCommandBuilder	Genera automáticamente mandatos de una sola tabla utilizada para reconciliar los cambios efectuados en un `Archivo` con la fuente de datos asociada. Esta clase no puede heredarse.
DB2eConnection	Representa una conexión abierta con una fuente de datos.
DB2eDataAdapter	Representa un conjunto de mandatos de datos y una conexión con una fuente de datos que se utilizan para rellenar el `Archivo` y actualizar la fuente de datos. Esta clase no puede heredarse.
DB2eDataReader	Proporciona un modo de leer una corriente de filas de datos sólo de avance a partir de una fuente de datos. Esta clase no puede heredarse.
DB2eError	Colecciona información relevante para un aviso o error devueltos por la fuente de datos. Esta clase no puede heredarse.
DB2eException	La excepción que se genera cuando la fuente de datos de DB2 Everyplace devuelve un aviso o error. Esta clase no puede heredarse.
DB2eParameter	Representa un parámetro para `DB2eCommand` y, opcionalmente, su correlación con una `DataColumn`. Esta clase no puede heredarse.
DB2eTransaction	Representa una transacción de SQL que ha de efectuarse en una fuente de datos. Esta clase no puede heredarse.

Tabla 10. Delegados

Delegado	Descripción
DB2eInfoMessageEventHandler	Representa el método que manejará el suceso de InfoMessage de una DB2eConnection.
DB2eRowUpdatedEventHandler	Representa el método que manejará el suceso de RowUpdated de un DB2eDataAdapter.
DB2eRowUpdatingEventHandler	Representa el método que manejará el suceso de RowUpdating de un DB2eDataAdapter.

Tabla 11. Enumeraciones

Enumeración	Descripción
DB2eType	Especifica el tipo de datos de un campo, propiedad o DB2eParameter.

Tabla 12. Palabras clave de serie de conexión de DB2 Everyplace .NET Provider

Palabra clave	Descripción
Database	Ubicación de la base de datos. Por ejemplo: `C:\data1\`
UID	ID de usuario
PWD	Contraseña

C# Example

string connString = @"Database=C:\data1\; UID=user; PWD=userpwd";

Conceptos relacionados

Tareas relacionadas