Informix Vbnet Drivers 9

IBM
Versin 9.5
Data Server Provider for .NET para Informix Dynamic Server
SC11-3674-00
IBM
Versin 9.5
Data Server Provider for .NET para Informix Dynamic Server
SC11-3674-00
Nota: Antes de utilizar esta informacin y el producto al que da soporte, lea la informacin contenida en el apartado Avisos en la pgina B-1.
Esta publicacin es la traduccin del original ingls IBM Data Server Provider for .NET for Informix Dynamic Server Version 9.5, (SC23-7688-00). Este documento contiene informacin sobre productos patentados de IBM. Se proporciona segn un acuerdo de licencia y est protegido por la ley de la propiedad intelectual. La informacin contenida en esta publicacin no incluye ninguna garanta de producto, por lo que ninguna declaracin proporcionada en esta publicacin deber interpretarse como tal. Al enviar informacin a IBM, le otorga a IBM un derecho no exclusivo a utilizar o distribuir dicha informacin en la forma en que IBM considere adecuada, sin contraer por ello ninguna obligacin con el remitente. Copyright International Business Machines Corporation 2003, 2007. Reservados todos los derechos.
Contenido
Introduccin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
En esta introduccin . . . . . . . . . . . . Acerca de este manual . . . . . . . . . . . Convenios de la documentacin . . . . . . . . Convenios tipogrficos . . . . . . . . . . Sealizacin para funciones, productos y plataformas Convenios para cdigo de ejemplo . . . . . . Documentacin adicional . . . . . . . . . . . Cumplimiento de los estndares industriales . . . . IBM agradece sus comentarios . . . . . . . . . vii vii vii vii . . . . . . . . . . . . . . . . . . . . viii . . . . . . . . . . . . . . . . . . . . viii . . . . . . . . . . . . . . . . . . . . ix . . . . . . . . . . . . . . . . . . . . ix . . . . . . . . . . . . . . . . . . . . ix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Captulo 1. Visin general del IBM Data Server Provider for .NET para Informix Dynamic Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Qu es el IBM Data Server Provider for.NET? . . . . . . . . . . Entornos de programacin soportados . . . . . . . . . . . . . Soporte al acceso a datos con Visual Studio . . . . . . . . . . . Soporte para IPv6 . . . . . . . . . . . . . . . . . . . . Preparacin del servidor de la base de datos . . . . . . . . . . . Visin general de la biblioteca de clases IBM Data Server Provider for .NET Seguridad de las hebras de los tipos de proveedor . . . . . . . . . Requisitos de los espacios de nombres . . . . . . . . . . . . . Conexin a una base de datos . . . . . . . . . . . . . . . . Modalidades de base de datos con .NET . . . . . . . . . . . . Reconciliacin de los cambios de DataSet con la base de datos . . . . . La agrupacin de conexiones . . . . . . . . . . . . . . . . Establecimiento del permiso FullTrust . . . . . . . . . . . . . Utilizacin de marcadores de parmetro ? . . . . . . . . . . . . Matrices de parmetros . . . . . . . . . . . . . . . . . . Llamada de los procedimientos almacenados . . . . . . . . . . . Uso de las transacciones distribuidas . . . . . . . . . . . . . Codificacin genrica con ADO.NET Common Base Classes . . . . . . Migracin desde IBM Informix .NET Provider . . . . . . . . . . Mensajes de error . . . . . . . . . . . . . . . . . . . . Rastreo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1-1 1-2 1-2 1-2 1-2 1-3 1-3 1-4 1-5 1-5 1-6 1-6 1-6 1-7 1-7 1-7 1-7 1-8 1-8 1-8
Captulo 2. Correlacin de tipos de datos . . . . . . . . . . . . . . . . . . . . 2-1

En este captulo . . . . . . . . . . . . . . . . . . Recuperacin de datos . . . . . . . . . . . . . . . Establecimiento de los tipos de datos de los parmetros . . . . Formato de visualizacin de los tipos de datos FLOAT, DECIMAL o . . . . . . . . . MONEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 2-1 2-2 2-3
Captulo 3. IBM Data Server Provider for .NET . . . . . . . . . . . . . . . . . . 3-1

Espacio de nombres IBM.Data.Informix . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 Clase IfxBulkCopy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5 Clase IfxBulkCopyColumnMapping. . . . . . . . . . . . . . . . . . . . . . . . . . 3-28 Clase IfxBulkCopyColumnMappingCollection . . . . . . . . . . . . . . . . . . . . . . 3-46 Enumeracin IfxBulkCopyOptions . . . . . . . . . . . . . . . . . . . . . . . . . . 3-67 Clase IfxCommandBuilder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-68 Clase IfxCommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-98 Clase IfxConnection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-156 Clase IfxConnectionStringBuilder . . . . . . . . . . . . . . . . . . . . . . . . . . 3-219 Enumeracin IfxCursorType . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-254 Clase IfxDataAdapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-255 Clase IfxDataReader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-291 Clase IfxDataSourceEnumerator . . . . . . . . . . . . . . . . . . . . . . . . . . 3-363
Copyright IBM Corp. 2003, 2007
iii
Clase IfxError. . . . . . . . . . . Clase IfxErrorCollection . . . . . . . Clase IfxException . . . . . . . . . Clase IfxFactory . . . . . . . . . . Clase IfxInfoMessageEventArgs. . . . . Clase IfxParameter . . . . . . . . . Clase IfxParameterCollection . . . . . Clase IfxPermissionAttribute. . . . . . Clase IfxPermission . . . . . . . . . Clase IfxRecord . . . . . . . . . . Clase IfxResultSet . . . . . . . . . Enumeracin IfxResultSetOptions . . . . Clase IfxRowUpdatedEventArgs . . . . Delegado de IfxRowUpdatedEventHandler . Clase IfxRowUpdatingEventArgs . . . . Delegado de IfxRowUpdatingEventHandler Clase IfxRowsCopiedEventArgs . . . . Delegado de IfxRowsCopiedEventHandler . Clase IfxTransaction . . . . . . . . Enumeracin IfxType . . . . . . . . Clase IfxUpdatableRecord . . . . . . Espacio de nombres IBM.Data.IfxTypes . . . Estructura IfxBinary . . . . . . . . Clase IfxClob . . . . . . . . . . . Estructura IfxDate . . . . . . . . . Estructura IfxDecimal . . . . . . . . Estructura IfxDouble . . . . . . . . Estructura IfxInt16 . . . . . . . . . Estructura IfxInt32 . . . . . . . . . Estructura IfxInt64 . . . . . . . . . Clase IfxNullValueException . . . . . . Clase IfxFormatException . . . . . . . Estructura IfxReal370 . . . . . . . . Estructura IfxReal . . . . . . . . . Estructura IfxRowId . . . . . . . . Estructura IfxString . . . . . . . . . Estructura IfxTime . . . . . . . . . Estructura IfxTimeStamp . . . . . . . Clase IfxTruncateException . . . . . . Clase IfxTypeException . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3-371 3-384 3-392 3-402 3-415 3-418 3-453 3-495 3-501 3-509 3-563 3-683 3-684 3-690 3-691 3-696 3-697 3-700 3-701 3-714 3-717 3-802 3-803 3-811 3-820 3-830 3-845 3-856 3-866 3-876 3-887 3-889 3-891 3-902 3-913 3-919 3-927 3-939 3-950 3-953
Captulo 4. Programas de ejemplo
. . . . . . . . . . . . . . . . . . . . . . . 4-1
. . . . . . . . . . . . . . . . . . . . . . . . con la base . . . . . . . . . . . . . . . . . . de . . . . . . . . . . . . . . . datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1 4-1 4-1 4-2 4-3 4-3 4-4 4-5 4-6 4-7
Programas de demostracin. . . . . . . . . . . . . . . . Ejemplos . . . . . . . . . . . . . . . . . . . . . . Recuperacin de un nico valor . . . . . . . . . . . . . Recuperacin de mltiples columnas. . . . . . . . . . . . Ejecucin de SQL, que no devuelve datos, y uso de una transaccin . Recuperacin de datos en un archivo . . . . . . . . . . . Utilizacin del objeto IfxCommandBuilder para reconciliar los cambios Llamada de un procedimiento almacenado . . . . . . . . . Uso de las transacciones distribuidas . . . . . . . . . . . Grabar CLOBs en archivos . . . . . . . . . . . . . . .
Apndice. Accesibilidad . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Funciones de accesibilidad de IBM Informix Funciones de accesibilidad . . . . . Navegacin mediante el teclado . . . Informacin afn sobre accesibilidad . . IBM y accesibilidad . . . . . . . Dynamic Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1 A-1 A-1 A-1 A-1
iv
IBM Data Server Provider for .NET para Informix Dynamic Server
Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
Marcas registradas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3
ndice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . X-1
Contenido
vi
Introduccin
En esta introduccin . . . . . . . . . . . . Acerca de este manual . . . . . . . . . . . Convenios de la documentacin . . . . . . . . Convenios tipogrficos . . . . . . . . . . Sealizacin para funciones, productos y plataformas Convenios para cdigo de ejemplo . . . . . . Documentacin adicional . . . . . . . . . . . Cumplimiento de los estndares industriales . . . . IBM agradece sus comentarios . . . . . . . . . vii vii vii vii . . . . . . . . . . . . . . . . . . . . viii . . . . . . . . . . . . . . . . . . . . viii . . . . . . . . . . . . . . . . . . . . ix . . . . . . . . . . . . . . . . . . . . ix . . . . . . . . . . . . . . . . . . . . ix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
En esta introduccin
En esta introduccin encontrar un resumen sobre la informacin contenida en esta publicacin y se describen los convenios que se utilizan.
Acerca de este manual

Esta publicacin contiene la informacin que necesita para utilizar IBM Data Server Provider for .NET para acceder y manipular datos en bases de datos IBM Informix. Esta publicacin asume que est familiarizado con la especificacin Microsoft .NET, los principios de programacin orientada a objetos, y con el uso de servidores y bases de datos IBM Informix. Microsoft proporciona informacin sobre la programacin con .NET en este sitio Web. Para obtener ms informacin sobre cmo trabajar con IBM Informix Dynamic Server, consulte la publicacin Gua de iniciacin en el conjunto de documentacin del servidor. Windows y .NET son marcas registradas o marcas de Microsoft Corporation en Estados Unidos o en otros pases.
Convenios de la documentacin
Esta seccin describe los convenios siguientes, los cuales se utilizan en la documentacin de producto de IBM Informix Dynamic Server: v Convenios tipogrficos v Convenios para componentes, productos y plataformas v Diagramas de sintaxis v Convenios de la lnea de mandatos v Convenios para cdigo de ejemplo
Convenios tipogrficos
Esta publicacin utiliza los convenios siguientes para presentar trminos nuevos, mostrar capturas de pantalla, describir la sintaxis de mandatos, etc.
Convenio PALABRA CLAVE Significado Las palabras clave de SQL, SPL y algunos otros lenguajes de programacin aparecen escritos en maysculas, con un font con remate.
vii
Convenio cursiva
Significado En el texto, aparecen en cursiva trminos nuevos y palabras que se destacan. En la sintaxis y ejemplos de cdigo, aparecen en cursiva valores de variable que debe especificar el usuario. Aparecen en negrita los nombres de entidades de programas (tales como clases, sucesos y tablas), las variables de entorno, los nombres de archivos, las vas de acceso y los elementos de la interfaz (tales como iconos, opciones de men y botones). La informacin que visualiza el producto y la informacin que especifica el usuario aparecen con el tipo de letra de monoespaciado. Las teclas que debe pulsar aparecen en letras maysculas escritas con un font sin remate (sans serif). Este smbolo indica un elemento de men. Por ejemplo, Elija Herramientas > Opciones significa que tiene que elegir el elemento Opciones en el men Herramientas.
negrita
monoespaciado PULSACIN >
Sealizacin para funciones, productos y plataformas

La sealizacin para componentes, productos y plataformas identifica prrafos que contienen informacin especfica de un componente, producto o plataforma. A continuacin, se muestran algunos ejemplos de esta sealizacin: Dynamic Server Identifica informacin que es especfica de IBM Informix Dynamic Server Fin de Dynamic Server Windows solamente Identifica informacin que es especfica del sistema operativo Windows Fin de Windows solamente Esta sealizacin puede aplicarse a uno o ms prrafos de un apartado. Cuando un apartado completo es aplicable a un producto o plataforma determinados, esto se indica en el texto de cabecera; por ejemplo: Ordenacin de tablas (Windows)
Convenios para cdigo de ejemplo

Esta publicacin contiene ejemplos de cdigo de SQL a lo largo de toda ella. Excepto cuando se indique, el cdigo no es especfico de ninguna herramienta individual de desarrollo de aplicaciones de IBM Informix. Si el ejemplo solamente contiene sentencias de SQL, las sentencias no estn delimitadas por signos de punto y coma. A continuacin sigue un cdigo de ejemplo:
CONNECT TO stores_demo ... DELETE FROM customer WHERE customer_num = 121
viii
... COMMIT WORK DISCONNECT CURRENT
Para utilizar este cdigo de SQL para un producto especfico, debe aplicar las reglas de sintaxis de ese producto. Por ejemplo, si est utilizando DBAccess, debe delimitar varias sentencias con signos de punto y coma. Si est utilizando una API de SQL, debe utilizar EXEC SQL al principio de cada sentencia y un signo de punto y coma (u otro delimitador apropiado) al final de la sentencia. Consejo: Los puntos suspensivos en un ejemplo de cdigo indican que se aadira ms cdigo en una aplicacin completa, pero no es necesario mostrarlo para describir el concepto que se explica. Para obtener instrucciones detalladas sobre la utilizacin de sentencias de SQL para una herramienta determinada de desarrollo de aplicaciones o para una API de SQL, consulte la documentacin correspondiente al producto.
Documentacin adicional
Puede ver, buscar e imprimir toda la documentacin del producto desde el Centro de informacin de IBM Informix Dynamic Server, situado en esta direccin de la Web: http://publib.boulder.ibm.com/infocenter/idshelp/v111/index.jsp. Para obtener documentacin adicional sobre IBM Informix Dynamic Server y productos asociados, tales como notas de release, notas de mquina y notas de documentacin, consulte la pgina de la biblioteca de productos en lnea, situada en http://www.ibm.com/software/data/informix/pubs/library/. Como alternativa, puede consultar o instalar la documentacin del producto a partir del CD de Iniciacin rpida que se proporciona con el producto.
Cumplimiento de los estndares industriales

Las instituciones American National Standards Institute (ANSI) e International Organization of Standardization (ISO) han establecido conjuntamente un conjunto de normas de la industria para el Lenguaje de consulta estructurado (SQL). Los productos basados en SQL de IBM Informix se ajustan totalmente a la norma SQL-92 Entry Level (publicada como ANSI X3.135-1992), que es idntica a ISO 9075:1992. Adems, muchas funciones de los servidores de bases de datos IBM Informix cumplen las normas SQL-92 Intermediate y Full Level y X/Open SQL de Common Applications Environment (CAE).
IBM agradece sus comentarios

Deseamos conocer cualquier correccin o clarificacin que considere que pueda ser til en nuestros manuales, lo cual nos ayudar a mejorar las ediciones futuras. Incluya la informacin siguiente: v Nombre y versin de la publicacin que est utilizando v Apartado y nmero de pgina v Sus sugerencias sobre la publicacin Envenos sus comentarios a la siguiente direccin de correo electrnico: hojacom@es.ibm.com
Introduccin
ix
Esta direccin de correo electrnico est reservada para notificar errores y omisiones de nuestra documentacin. Para obtener ayuda inmediata para un problema tcnico, pngase en contacto con el Centro de soporte tcnico de IBM. Para obtener instrucciones, visite el sitio Web de Soporte tcnico de IBM Informix que se encuentra en http://www.ibm.com/planetwide/. Valoramos en gran medida sus sugerencias.
Captulo 1. Visin general del IBM Data Server Provider for .NET para Informix Dynamic Server
Qu es el IBM Data Server Provider for.NET? . . . . . . . . . . Entornos de programacin soportados . . . . . . . . . . . . . Soporte al acceso a datos con Visual Studio . . . . . . . . . . . Soporte para IPv6 . . . . . . . . . . . . . . . . . . . . Preparacin del servidor de la base de datos . . . . . . . . . . . Visin general de la biblioteca de clases IBM Data Server Provider for .NET Seguridad de las hebras de los tipos de proveedor . . . . . . . . . Requisitos de los espacios de nombres . . . . . . . . . . . . . Conexin a una base de datos . . . . . . . . . . . . . . . . Modalidades de base de datos con .NET . . . . . . . . . . . . Reconciliacin de los cambios de DataSet con la base de datos . . . . . La agrupacin de conexiones . . . . . . . . . . . . . . . . Establecimiento del permiso FullTrust . . . . . . . . . . . . . Utilizacin de marcadores de parmetro ? . . . . . . . . . . . . Matrices de parmetros . . . . . . . . . . . . . . . . . . Llamada de los procedimientos almacenados . . . . . . . . . . . Uso de las transacciones distribuidas . . . . . . . . . . . . . Codificacin genrica con ADO.NET Common Base Classes . . . . . . Migracin desde IBM Informix .NET Provider . . . . . . . . . . Mensajes de error . . . . . . . . . . . . . . . . . . . . Rastreo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 1-1 1-2 1-2 1-2 1-2 1-3 1-3 1-4 1-5 1-5 1-6 1-6 1-6 1-7 1-7 1-7 1-7 1-8 1-8 1-8
Qu es el IBM Data Server Provider for.NET?

El IBM Data Server Provider for .NET es un conjunto .NET que permite a las aplicaciones .NET acceder y manipular datos en servidores de datos IBM. Lo hace implementando diferentes interfaces en el Microsoft .NET Framework que se utilizan para acceder a los datos desde una base de datos. Utilizar IBM Data Server Provider for .NET es ms eficaz que acceder a una base de datos IBM Informix mediante uno de los dos siguientes mtodos: v Utilizacin de Microsoft .NET Framework Data Provider for ODBC junto con IBM Informix ODBC Driver v Utilizacin de Microsoft .NET Framework Data Provider for OLE DB junto con IBM Informix OLE DB Provider
Entornos de programacin soportados

El IBM Data Server Provider for .NET puede ser utilizado por cualquier aplicacin que pueda ejecutar el Microsoft .NET Framework. La siguiente lista incluye algunos ejemplos de lenguajes de programacin que crean aplicaciones que cumplen estos criterios: v Visual BASIC .NET v Visual C# .NET v Visual J# .NET v ASP.NET El IBM Data Server Provider for .NET se ejecuta en todas las plataformas Microsoft Windows que proporcionan soporte total a .NET. Si quiere utilizar el IBM Data
1-1
Server Provider for .NET que implementa interfaces ADO.NET 2.0, deber tener instalado en su sistema Microsoft .NET Framework Versin 2.0 o superior.
Soporte al acceso a datos con Visual Studio

Si utiliza Microsoft Visual Studio, se instalar un mdulo adicional de IBM Data Server Provider for .NET de forma automtica al instalar el Client SDK. Los mdulos adicionales de Visual Studio 2005 slo estn disponibles con CSDK. El proveedor de IConnect no incluye estos mdulos adicionales. Consulte en la pestaa Datos de la caja de herramientas las herramientas que le permitan configurar estos tipos de IBM Data Server Provider for .NET de forma visual: v IfxConnection v IfxCommand v IfxDataAdapter
Soporte para IPv6

El IBM Data Server Provider for .NET puede utilizar direcciones Internet Protocol Version 6 (IPv6), as como direcciones Internet Protocol Version 4 (IPv4). Si su sistema utiliza IPv6 recomendamos que utilice nombres de sistema principal en sus series de conexin en vez de utilizar direcciones IP con el formato IPv6. A parte de esto, no deber realizar ninguna otra accin.
Preparacin del servidor de la base de datos

Antes de utilizar el IBM Data Server Provider for .NET para acceder a las bases de datos de un servidor de base de datos determinado, deber ejecutar el script, cdotnet.sql, en funcin de la base de datos sysmaster en dicho servidor como usuario informix.
Visin general de la biblioteca de clases IBM Data Server Provider for .NET
El IBM Data Server for .NET da soporte a todas las clases pblicas y base .NET necesarias para acceder a la base de datos IBM Informix. Consulte la documentacin de Microsoft .NET Framework SDK para obtener ms informacin. En el .NET Framework, el acceso a una fuente de datos y sus datos est gestionado por las clases ADO.NET (ADO.NET significa ActiveX Data Objects -Objetos de datos de ActiveX- en la plataforma .NET). El .NET Framework es un conjunto de servicios y programas que proporcionan el entorno de tiempo de ejecucin para las aplicaciones .NET. ADO.NET contiene dos componentes primarios: las clases de archivo y las clases de .NET Provider. El objeto DataSet representa una fuente de datos en memoria (en estado desconectado). Las aplicaciones .NET utilizan DataSet para manipular datos. Las interfaces DataTable y DataColumn representan la tabla fuente y sus columnas. La interfaz DataRelation representa las relaciones entre tablas, como la del tipo padre-hijo. Al recuperar datos de la base de datos, todo el conjunto de resultados se toma del servidor y se convierte en XML antes de colocarlo en un DataSet. Todo el conjunto de resultados se almacena en un cliente. Por ello, se recomienda mantener los
1-2
archivos lo ms pequeos posible. No olvide utilizar el parmetro MAX ROWS en sus sentencias SELECT si no tiene que devolver todos los datos. Las principales clases de IBM Data Server Provider for .NET que proporcionan acceso a los datos son: v IfxConnectionpara conectarse a una base de datos y gestionar las transacciones. v IfxCommandpara emitir mandatos SQL. v IfxDataReaderpara leer una corriente de slo reenvo de registros de datos. v IfxTransactionpara controlar las transacciones. v IfxDataAdapterpara meter los datos en un archivo y reconciliar los cambios de un archivo con la base de datos. Las siguientes clases de .NET Provider le permiten desarrollar un cdigo independiente del proveedor al utilizar .NET Provider para el entorno 2.0: v DbProviderFactory v DbConnectionStringBuilder v DbCommand El objeto IfxDataReader proporciona una recuperacin rpida de los datos de la base de datos. Sin embargo, los datos son de slo lectura y slo puede avanzar, un registro cada vez, por el conjunto de resultados. A diferencia de los objetos DataSet, los objetos IfxDataReader no crean tablas temporales para que contengan los datos, por lo que utilizan menos memoria. Si se modifican los datos en el cliente, es posible que el usuario quiera aplicar dichos cambios en la base de datos. Para ello necesitar la clave primaria de su tabla de la base de datos para asegurarse de que est actualizando la fila correcta de la tabla. Para las actualizaciones de tablas nicas puede utilizar la clase IfxCommandBuilder para facilitar la reconciliacin automtica de los cambios en el archivo con la base de datos (consulte Reconciliacin de los cambios de DataSet con la base de datos en la pgina 1-5).
Seguridad de las hebras de los tipos de proveedor

nicamente los miembros estticos de un tipo de IBM Data Server Provider for .NET son de enhebramiento seguro. No se garantiza que todos los tipos sean seguros al llamarlos desde distintas hebras al mismo tiempo.
Requisitos de los espacios de nombres

El espacio de nombres para el IBM Data Server Provider for .NET para Informix Dynamic Server es: IBM.Data.Informix. Esto significa que el nombre completo de todos los objetos en IBM Data Server Provider for .NET para Informix Dynamix Server Provider empieza por IBM.Data.Informix. Por ejemplo, el nombre completo de IfxConnection es IBM.Data.Informix.IfxConnection. Para evitar tener que introducir todo el espacio de nombres de cada uno de los objetos, puede importar el espacio de nombres. La manera exacta de hacerlo depende de su lenguaje de programacin. El lenguaje C# utiliza la palabra clave using. Si est programando en C# puede referenciar el espacio de nombres incluyendo esta lnea al principio de su mdulo:
using IBM.Data.Informix;
1-3
Conexin a una base de datos

Para conectarse a una base de datos deber utilizar el mtodo Open de un objeto IfxConnection. Puede definir informacin sobre cmo conectarse a una base de datos (como la mquina y el servidor donde est la base de datos) pasando una serie de conexin al objeto IfxConnection. La serie de conexin tiene la siguiente forma: atributo=valor[;atributo=valor]... Los corchetes ([]) y la elipsis (...) no forman parte de la serie. Slo indican que los pares atributo/valor despus del primero son opcionales y que puede incluirse cualquier nmero de los pares atributo/valor. Los pares atributo/valor se separan entre s con un punto y coma. Si utiliza Microsoft Visual Studio podr crear una conexin visualmente: 1. Arrastre un IfxConnection de la pestaa Datos de la barra de herramientas hasta uno de sus formularios. 2. Pulse en la propiedad ConnectionString del nuevo objeto IfxConnection. 3. Pulse en el botn de la elipsis (...) que aparece en el cuadro de texto ConnectionString. Se abrir un recuadro de dilogo. 4. Llene los elementos del dilogo para darle informacin a la conexin. Pulse en el botn de ayuda del recuadro de dilogo para obtener detalles sobre cmo utilizar el dilogo. El siguiente fragmento muestra una conexin simple a una base de datos denominada testdb en un servidor IBM Informix denominado testserver ubicado en una mquina denominada berry:
IfxConnection conn=new IfxConnection("Host=berry; Service=9401; Server=testserver;User ID=informix; password=ifxtest; Database=testdb"); conn.Open();
Adems de la propiedad ConnectionString, un objeto IfxConnection tambin puede determinar las propiedades de conexin del programa de utilidad Setnet y del entorno o el registro (por ejemplo, los valores de DELIMIDENT y OPTOFC se pueden determinar de esta manera). Si las propiedades se establecen en la serie de conexin, el objeto IfxConnection utilizar dichos valores. Si, en cambio, no se establecen ah, utilizar los valores del entorno. Para las propiedades que no se establezcan, el objeto IfxConnection tomar los valores del programa de utilidad SetNet. Nota: De acuerdo con los estndares de la industria, el IBM Data Server Provider for .NET acta como si DELIMIDENT se hubiera establecido en Y a menos que el usuario lo establezca expresamente en N. Cuando su aplicacin haya acabado de utilizar la base de datos, cierre la conexin como en el siguiente fragmento:
conn.Close();
Nota: Los nombres de atributo de las series de conexin no son sensibles a maysculas y minsculas, pero a menudo sus valores lo son.
1-4
Modalidades de base de datos con .NET

La modalidad de base de datos se detecta automticamente. Utilice la semntica de base de datos ANSI tanto para las bases de datos registradas como las ANSI. En las aplicaciones CLI, el atributo SQL_ATTR_AUTOCOMMIT a nivel de conexin puede ser SQL_AUTOCOMMIT_ON o SQL_AUTOCOMMIT_OFF. v SQL_AUTOCOMMIT_ON para bases de datos MODE ANSI da como resultado una confirmacin despus de cada sentencia y el servidor inicia una transaccin automticamente. v SQL_AUTOCOMMIT_OFF significa que la aplicacin tiene la responsabilidad de emitir confirmaciones utilizando SQLEndTran con SQL_COMMIT.
Reconciliacin de los cambios de DataSet con la base de datos

Si recupera datos de la base de datos utilizando un objeto IfxDataAdapter y realiza cambios en los datos del archivo, la clase IfxCommandBuilder le permite generar mandatos INSERT, DELETE y UPDATE automticos para reconciliar dichos cambios con la base de datos. Recuperacin de datos en un archivo en la pgina 4-3 incluye un ejemplo que demuestra cmo utilizar los objetos IfxDataAdapter. Utilizacin del objeto IfxCommandBuilder para reconciliar los cambios con la base de datos en la pgina 4-4 incluye un ejemplo que demuestra cmo utilizar los objetos IfxCommandBuilder. La generacin automtica de sentencias SQL para la reconciliacin de datos se inicia al establecer la propiedad SelectCommand de un objeto IfxDataAdapter con la sentencia SELECT que quiere ejecutar. A continuacin, al crear un objeto IfxCommandBuilder, genera de forma automtica sentencias SQL para actualizaciones de tablas nicas para reconciliar los cambios en el archivo con la base de datos. Un objeto IfxCommandBuilder siempre est asociado con un objeto IfxDataAdapter (en una relacin de uno a uno). La sentencia SELECT que ejecuta al utilizar la propiedad SelectCommand debe devolver al menos una clave primaria o una columna exclusiva. Si no dispone de ninguno, se devolver una excepcin InvalidOperation y no se generarn los mandatos de reconciliacin. El objeto IfxCommandBuilder tambin utiliza las propiedades IfxCommand Connection, CommandTimeout y Transaction para la sentencia SELECT que est ejecutando (establecida por la propiedad SelectCommand). Si se modifica alguna de estas propiedades o si se sustituye la sentencia SELECT, debera llamar el mtodo IfxCommandBuilder.RefreshSchema. De no ser as, las propiedades InsertCommand, UpdateCommand y DeleteCommand conservarn sus valores originales. El mtodo IfxCommandBuilder.Dispose disocia el objeto IfxCommandBuilder del objeto IfxDataAdapter y ya no se utilizan ms los mandatos generados. Es posible que un objeto IfxCommandBuilder no genere sentencias SQL eficientes. Puede visualizar los mandatos que genera utilizando los mtodos GetDeleteCommand, GetInsertCommand y GetUpdateCommand. Las siguientes limitaciones se aplican al uso de los objetos IfxCommandBuilder: v La sentencia SELECT debe recuperar al menos una clave primaria o una columna unvoca como parte de la consulta.
1-5
v La sentencia SELECT debe hacer referencia a una sola tabla; no puede tener procedimientos o vistas almacenadas que contengan operadores JOIN. v La sentencia SELECT debe hacer referencia a columnas que admitan operaciones de lectura-grabacin. v El objeto IfxCommandBuilder no intenta ni proporciona ningn mecanismo para buscar y cargar argumentos de salida de la sentencia SELECT. v Con las propiedades CommandText, Connection, CommandTimeout o Transaction para el cambio de consulta deber ejecutar el mtodo IfxCommandBuilder.RefreshSchema. v Los mandatos UPDATE y DELETE generados por un objeto IfxCommandBuilder no cambiarn ninguna columna modificada en la base de datos despus de que SELECT haya ledo los datos. v El objeto IfxCommandBuilder se ha diseado para trabajar con tablas individuales no relacionadas. No puede utilizar objetos IfxCommandBuilder para actualizar tablas con relaciones de clave primaria/clave externa. v Si las columnas de su mandato SELECT contienen caracteres especiales como espacios, puntos, comillas o caracteres no alfanumricos, no podr utilizar los objetos IfxCommandBuilder a menos que utilice las propiedades QuotePrefix y QuoteSuffix para especificar el delimitador para los nombres de tabla y columna en las consultas que genera.
La agrupacin de conexiones
La agrupacin de conexiones permite que las aplicaciones del cliente reutilicen las conexiones en vez de tener que crear una nueva cada vez que IBM Data Server Provider for .NET deba conectarse a una base de datos. Para que una conexin est disponible en la agrupacin, deber cerrarlo despus de que su aplicacin haya acabado de utilizar dicha conexin. Para reutilizar una conexin, sta deber estar en desuso y deber seguir estando conectada al servidor. Los atributos de la serie de conexin Pooling, Max Pool Size, Connection Life Time y Min Pool Size se utilizan para controlar la agrupacin de conexiones.
Establecimiento del permiso FullTrust

Para utilizar IBM Data Server Provider for .NET, las aplicaciones de llamada deben tener establecido el permiso de FullTrust.
Utilizacin de marcadores de parmetro ?

Puede utilizar el smbolo de pregunta (?) para marcar la posicin de un parmetro en una sentencia SQL o en un procedimiento almacenado. Puesto que IBM Data Server Provider for .NET no tiene acceso a los nombres de estos parmetros, deber traspasarlos en el orden adecuado. El orden en que aada los objetos IfxParameter a un objeto IfxParameterCollection deber corresponder directamente a la posicin del smbolo ? de la retencin de posicin de ese parmetro. Deber utilizar el mtodo ParameterCollection.Add para agregar un parmetro a la coleccin.
1-6
Matrices de parmetros
El IBM Data Server Provider for .NET da soporte a las matrices de los parmetros de entrada para las sentencias UPDATE y INSERT. Esto permite que una aplicacin utilice un nico mandato para especificar una fila de valores de parmetro y dichos valores pueden enviarse de una sola vez al servidor.
Llamada de los procedimientos almacenados

Para utilizar procedimientos almacenados en sus aplicaciones, establezca las siguientes propiedades del objeto IfxCommand tal como se muestra a continuacin: v CommandText - establecida en el nombre del procedimiento almacenado v CommandType - establecida en StoredProcedure Puede utilizar el mtodo IfxCommandBuilder.DeriveParameters para recuperar informacin sobre los parmetros para los procedimientos almacenados. Si un procedimiento almacenado devuelve un valor, su aplicacin deber aadir un parmetro para dicho valor en la coleccin de parmetros utilizada por el objeto IfxCommand. La seccin Llamada de un procedimiento almacenado en la pgina 4-5 incluye un ejemplo que muestra cmo ejecutar un procedimiento almacenado y leer los resultados que devuelva.
Uso de las transacciones distribuidas

Su aplicacin puede conseguir una conexin para las transacciones distribuidas estableciendo el atributo de la serie de conexin Enlist en true, yes o 1. Se recomienda establecer el atributo de la serie de conexin Pooling en true, yes o 1 mientras trabaje con transacciones distribuidas. Uso de las transacciones distribuidas en la pgina 4-6 incluye un ejemplo sobre cmo utilizar las transacciones distribuidas con su aplicacin. Nota: Las transacciones distribuidas estn soportadas por Microsoft Distributed Transaction Coordinator (MS DTC). Los componentes MS DTC son necesarios para llamar algunos cdigos no gestionados que pueden afectar al nivel de seguridad disponible y al rendimiento.
Codificacin genrica con ADO.NET Common Base Classes

.NET Framework versin 2.0 contiene un espacio para nombres denominado System.Data.Common que incluye un conjunto de clases base que pueden compartirse entre todos los proveedores de datos .NET. Esto facilita un enfoque genrico al desarrollo de la aplicacin de bases de datos ADO.NET generando una interfaz de programacin constante. Las clases principales de IBM Data Server Provider for .NET se heredan de las clases base System.Data.Common. Como resultado, las aplicaciones ADO.NET genricas trabajarn con bases de datos Dynamic Server mediante el IBM Data Server Provider for .NET. El siguiente cdigo C# muestra un enfoque genrico para establecer una conexin a una base de datos.
1-7
DbProviderFactory factory = DbProviderFactories.GetFactory("IBM.Data.Informix"); DbConnection conn = factory.CreateConnection(); DbConnectionStringBuilder sb = factory.CreateConnectionStringBuilder(); if( sb.ContainsKey( "Database" ) ) { sb.Remove( "database" ); sb.Add( "database", "SAMPLE" ); } conn.ConnectionString = sb.ConnectionString; conn.Open();
El objeto DbProviderFactory es el punto en que empieza cualquier aplicacin ADO.NET genrica. Este objeto crea instancias genricas de objetos del proveedor de datos .NET como conexiones, adaptadores de datos y lectores de datos que trabajan con un producto de bases de datos especfico. En el caso del ejemplo anterior, la serie "IBM.Data.Informix" traspasada al mtodo GetFactory slo identifica de forma unvoca el IBM Data Server Provider for .NET for Informix Dynamic Server y da como resultado la inicializacin de una instancia DbProviderFactory que crea instancias del objeto del proveedor de bases de datos especfico de IBM Data Server Provider for .NET para Informix Dynamic Server. El objeto DbConnection puede conectarse a bases de datos Dynamic Server como un objeto IfxConnection, que se hereda de DbConnection. Al utilizar la clase DbConnectionStringBuilder, puede determinar las palabras clave de la serie de conexin para un proveedor de datos y generar una serie de conexin del cliente. El cdigo del ejemplo anterior comprueba si existe una palabra clave denominada "database" en IBM Data Server Provider for .NET para Informix Dynamic Server y, de ser as, genera una serie de conexin para conectarse a la base de datos SAMPLE.
Migracin desde IBM Informix .NET Provider

El soporte anterior para las aplicaciones .NET ha utilizado SQLI para conectarse a una base de datos, en tanto que IBM Data Server Provider for .NET utiliza DRDA para conectarse a una base de datos. En consecuencia, debe utilizar un nivel de Dynamic Server que da soporte a DRDA, el cual es Dynamic Server, Versin 11.1 o superior. Asimismo, ya no se da soporte a las siguientes clases y sus estructuras. v IfxBlob v IfxTimeSpan
Mensajes de error
Los mensajes de error del servidor IBM Informix se representan como excepciones de IBM Data Server Provider for .NET.
Rastreo
Una aplicacin puede habilitar el rastreo estableciendo la variable de entorno IFXDOTNETTRACE.
Valor 0 1 Significado Sin rastreo Rastreo de la entrada API y salida con cdigo de retorno
1-8
Valor 2
Significado Rastreo de la entrada API y salida con cdigo de retorno ms rastreo de los parmetros del API
v 0Sin rastreo v 1Rastreo de la entrada API y salida con cdigo de retorno v 2Rastreo de la entrada API y salida con cdigo de retorno ms rastreo de los parmetros del API La informacin de rastreo se graba en el archivo que establece el usuario con la variable de entorno IFXDOTNETTRACEFILE.
1-9
1-10
Captulo 2. Correlacin de tipos de datos

En este captulo . . . . . . . . . . . . . . . . . . Recuperacin de datos . . . . . . . . . . . . . . . Establecimiento de los tipos de datos de los parmetros . . . . Formato de visualizacin de los tipos de datos FLOAT, DECIMAL o . . . . . . . . . MONEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 2-1 2-2 2-3
En este captulo
En este captulo se describe cmo se correlacionan los tipos de datos entre las bases de datos IBM Informix y .NET Framework. Esto incluye: v Cmo se correlacionan los tipos de datos cuando se recuperan datos de la base de datos utilizando los objetos IfxDataReader y IfxDataAdapter v Cmo se correlaciona un tipo de datos de los parmetros (al utilizar los objetos IfxParameter)
Recuperacin de datos
La Tabla 2-1 muestra cada tipo de datos Informix, el tipo recomendado para almacenar dicho tipo de datos y el tipo de datos .NET Framework que mejor se adapte. El tipo recomendado debera utilizarse al acceder a los datos mediante IfxDataReader. El tipo de .NET ms adecuado es el tipo que utilizar un objeto IfxDataAdapter cuando llene un objeto DataSet. Puede utilizar tipos distintos a los que se muestran, por ejemplo, puede utilizar el mtodo IfxDataReader.GetString para obtener cualquier tipo de datos que pueda almacenarse en la base de datos IBM Informix. Los tipos recomendados son los ms eficientes y es menos probable que cambien el valor.
Tabla 2-1. Los mejores tipos para recuperar tipos de datos de IBM Informix Tipo de datos de Informix BLOB BOOLEAN BYTE CHAR CHAR(1) CLOB DATE DATETIME Escala fija DECIMAL(p<=28) Coma flotante DECIMAL (p<=28) DECIMAL (p>28) DOUBLE FLOAT IDSSECURITYLABEL INTEGER Tipo recomendado IfxBlob Boolean Byte[] String String IfxClob IfxDateTime IfxDateTime IfxDecimal IfxDecimal IfxDecimal Double Double Int64[] Int32 Mejor tipo de datos .NET nativo Byte[] Boolean Byte[] String String Byte[] DateTime DateTime Decimal Double String Double Double Int64[] Int32
2-1
Tabla 2-1. Los mejores tipos para recuperar tipos de datos de IBM Informix (continuacin) Tipo de datos de Informix INT8 INTERVAL, ao-mes INTERVAL, da-fraccin LVARCHAR MONEY NCHAR REAL SERIAL SERIAL8 SMALLFLOAT TEXT VARCHAR Tipo recomendado Int64 IfxMonthSpan IfxTimeSpan String IfxDecimal String Float nt32 Int64 Float String String Mejor tipo de datos .NET nativo Int64 String TimeSpan String Como para Decimal con la misma precisin String Float Int32 Int64 Float String String
Nota: Para el formato de los tipos de datos Informix, DECIMAL, MONEY, DATETIME e INTERVAL devueltos utilizando el mtodo IfxDataReader.GetString, consulte la seccin sobre el segmento Fila literal en IBM Informix Guide to SQL: Syntax. Nota: Los tipos ROW y TEXT y los tipos de coleccin LIST, MULTISET, SET pueden correlacionarse con un tipo .NET Framework del literal de serie y acceder a ellos desde el mtodo IfxDataReader.GetString. El formato para la serie est documentado en IBM Informix Guide to SQL: Syntax, en la seccin sobre el segmento Fila literal. Para que la expresin de cualquier literal de serie anidado sea ms simple, no se devuelve una comilla delante de la serie. Las comillas simples se utilizan, mejor que las comillas dobles, para englobar los literales de serie intercalados en el tipo ROW. Esto se hace para evitar confusiones si se utilizan comillas dobles como identificador de la delimitacin.
Establecimiento de los tipos de datos de los parmetros

Se recomienda que su aplicacin establezca un tipo de parmetro como tipo Informix siempre que sea posible (utilizando el argumento IfxType del constructor IfxParameter). Puede especificar un tipo de parmetro como .NET DbType, de manera que IBM Informix .NET Provider infiera el tipo Informix lo mejor que pueda. .NET DbType especifica el tipo de datos de un objeto Parameter de un proveedor de datos .NET Framework. Algunos tipos DbType, como el GUID, no se correlacionan con ningn tipo Informix, por lo que devolvern un error. Algunos tipos DbType, como el AnsiString, pueden correlacionarse con diferentes tipos Informix como VARCHAR, TEXT o BLOB; debe saber que IBM Informix .NET Provider puede no elegir el tipo de datos que el usuario quiere. Si no especifica un tipo de datos Informix o un .NET DbType, IBM Informix .NET Provider intentar inferir un tipo de datos Informix del propio valor. Por ejemplo,
2-2
si el valor es 4, el proveedor lo correlacionar con un tipo de datos INTEGER. En funcin de estas correlaciones inferidas pueden surgir resultados inesperados.
Formato de visualizacin de los tipos de datos FLOAT, DECIMAL o MONEY

El formato de visualizacin de los tipos de datos FLOAT, DECIMAL o MONEY de Informix se especifica con los valores de las variables de entorno DBMONEY o CLIENT_LOCALE. La variable de entorno DBMONEY tiene prioridad sobre la variable de entorno CLIENT_LOCALE. Si no esteblece DBMONEY, entonces se utilizar el valor local (CLIENT_LOCALE) para dar formato al valor. DBMONEY se establece, por omisin, con el signo del dlar y un punto ($.)y CLIENT_LOCALE se establece en US English (en_us.CP1252). Por ejemplo, si establece DBMONEY=Pt, el separador ser una coma (,). Entonces, un valor decimal de 169.0 se formatear con una coma: 169,0. Informix .NET Provider determina el formato de visualizacin utilizando la siguiente precedencia: 1. Serie de conexin 2. Entorno 3. Registro (valores SetNet) Los valores de la serie de conexin sobregraban los dems valores. Para obtener ms informacin, consulte el manual IBM Informix Guide to SQL: Reference.
Captulo 2. Correlacin de tipos de datos
2-3
2-4
Captulo 3. IBM Data Server Provider for .NET

IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece un acceso seguro y de alto rendimiento a los servidores de datos IBM. IBM Data Server Provider for .NET permite que las aplicaciones .NET del usuario accedan a los sistemas de gestin de bases de datos siguientes: v DB2 Database para Linux, UNIX y Windows, Versin 9 v DB2 Universal Database Versin 8 para Windows, UNIX y sistemas basados en Linux v DB2 Universal Database Versin 6 (o posterior) para OS/390 y z/OS, mediante DB2 Connect v DB2 Universal Database Versin 5, Release 1 (o posterior) para AS/400 y System i, mediante DB2 Connect v DB2 Universal Database Versin 7.3 (o posterior) para VSE & VM, mediante DB2 Connect v IBM Informix Dynamic Server, Versin 11.10 o posterior v IBM UniData, Versin 7.1.11 o posterior v IBM UniVerse, Versin 10.2 o posterior Adems de IBM Data Server Provider for .NET, IBM Database Add-Ins permite desarrollar de forma fcil y sencilla aplicaciones .NET para bases de datos en Visual Studio 2003 y Visual Studio 2005. Tambin puede utilizar estos mdulos adicionales para crear objetos de base de datos como ndices y tablas y desarrollar objetos del servidor, tales como procedimientos almacenados y funciones definidas por el usuario.
Espacios de nombres
Espacio de nombres IBM.Data.Informix IBM.Data.IfxTypes Descripcin Los servidores de datos de .NET Framework Data Provider for Informix. Proporciona clases para tipos de datos nativos en servidores de datos Informix.
Espacio de nombres IBM.Data.Informix

El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. IBM Data Server Provider for .NET permite que las aplicaciones .NET del usuario accedan a los sistemas de gestin de bases de datos siguientes: v DB2 Database para Linux, UNIX y Windows, Versin 9 o posterior v DB2 Universal Database Versin 8 para Windows, UNIX y sistemas basados en Linux v DB2 Universal Database Versin 6 (o posterior) para OS/390 y z/OS, mediante DB2 Connect
3-1
v DB2 Universal Database Versin 5, Release 1 (o posterior) para AS/400 e iSeries, mediante DB2 Connect v DB2 Universal Database Versin 7.3 (o posterior) para VSE & VM, mediante DB2 Connect v IBM Informix Dynamic Server, Versin 11.10 o posterior v IBM UniData, Versin 7.1.11 o posterior v IBM UniVerse, Versin 10.2 o posterior Adems de IBM Data Server Provider for .NET, IBM Database Development Add-Ins permite desarrollar de forma fcil y sencilla aplicaciones .NET para servidores de datos IBM en Visual Studio 2005. Tambin puede utilizar estos mdulos adicionales para crear objetos de base de datos como ndices y tablas y desarrollar objetos del servidor, tales como procedimientos almacenados y funciones definidas por el usuario.
Desarrollo de aplicaciones en IBM Data Server Provider for .NET

IBM Data Server Provider for .NET permite la conexin con una base de datos, la ejecucin de mandatos y la recuperacin de resultados. Dichos resultados se pueden procesar directamente o se pueden colocar en un DataSet ADO.NET para procesarlos posteriormente cuando se estn desconectados. Mientras se encuentren en el DataSet, los datos se pueden exponer al usuario, combinados con otros datos procedentes de varias fuentes, o se pueden pasar remotamente entre niveles. Cualquier proceso que se realice en los datos mientras se encuentren en el DataSet se puede reconciliar en la base de datos. Para utilizar IBM Data Server Provider for .NET, es necesario aadir al .DLL de la aplicacin una sentencia imports o using para el espacio de nombres IBM.Data.Informix. Por ejemplo:
[Visual Basic] Imports IBM.Data.Informix [C#] using IBM.Data.Informix;
Tambin debe incluirse una referencia a IBM.Data.Informix.dll en el proyecto de la aplicacin. En Visual Studio lo puede hacer desde la seccin References, para su proyecto en Solution Explorer o desde la opcin de men Proyecto > Aadir referencia. Si est compilando un programa desde la lnea de mandatos para Framework 2.0 o 3.0, los mandatos csc o vbc deben incluir la opcin siguiente:
/r:"%IfxPATH%"\bin\netf20\IBM.Data.Informix.dll
Si est compilando un programa desde la lnea de mandatos para Framework 1.1, los mandatos csc o vbc deben incluir la opcin siguiente:
/r:"%IfxPATH%"\bin\netf11\IBM.Data.Informix.dll
Para establecer una conexin con uno de los servidores de datos soportados, deber construir un objeto IfxConnection y proporcionarle una serie de caracteres de conexin Informix .NET vlida. Consulte la propiedadIfxConnection.ConnectionString para obtener informacin sobre las palabras clave soportadas. Para obtener informacin detallada sobre cmo utilizar mejor el espacio de nombres IBM.Data.DB2, consulte la documentacin sobre las siguientes clases de IBM Data Server Provider for .NET: v IfxDataAdapter
3-2
v IfxCommand v IfxConnection v IfxDataReader
Clases
Clase IfxBulkCopy IfxBulkCopyColumnMapping Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Descripcin Facilita la copia de filas de una fuente de datos a otra.
Representa una coleccin de correlaciones de columnas de la tabla IfxBulkCopyColumnMappingCollection fuente con la tabla de destino. IfxCommand IfxCommandBuilder Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar en funcin de una fuente de datos. Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Representa una conexin abierta con una base de datos. IfxConnection IfxConnectionStringBuilder Proporciona enfoques genricos y especficos de IBM Data Server Provider for .NET para la generacin de series de caracteres de conexin vlidas. Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Proporciona una forma de descubrir las fuentes de datos visibles de la familia Informix. Recopila informacin relevante para un aviso o error devuelto por la base de datos. Recopila todos los errores generados por el IfxDataAdapter. IfxErrorCollection IfxException IfxFactory La excepcin que se genera cuando un servidor de datos Informix devuelve un error. Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para el proveedor de datos. Proporciona datos para el suceso InfoMessage. IfxInfoMessageEventArgs IfxParameter IfxParameterCollection Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Habilita IBM Data Server Provider for .NET para garantizar que un usuario tenga el nivel de seguridad adecuado para acceder a una base de datosInformix.
IfxDataAdapter
IfxDataReader IfxDataSourceEnumerator IfxError
IfxPermission
3-3
Clase IfxPermissionAttribute IfxRecord IfxResultSet
Descripcin Asocia una accin de seguridad con un atributo de seguridad personalizado. Representa un registro de slo lectura. Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden actualizar, suprimir e insertar filas. Proporciona datos para el suceso IfxRowsCopied. IfxRowsCopiedEventArgs Proporciona datos para el suceso RowUpdated. IfxRowUpdatedEventArgs Proporciona datos para el suceso RowUpdating. IfxRowUpdatingEventArgs IfxTransaction IfxUpdatableRecord Representa una transaccin de SQL que se debe realizar en una base de datos. Representa una fila nueva que se crear en una instancia de IfxResultSet.
Delegados
Delegado IfxInfoMessageEventHandler IfxRowsCopiedEventHandler IfxRowUpdatedEventHandler IfxRowUpdatingEventHandler Descripcin Representa el mtodo que manejar el suceso InfoMessage de un objeto IfxConnection. Representa el mtodo que manejar el suceso IfxRowsCopied de un objeto IfxBulkCopy. Representa el mtodo que manejar el suceso RowUpdated de un objeto IfxDataAdapter. Representa el mtodo que manejar el suceso RowUpdating de un objeto IfxDataAdapter.
Enumeraciones
Enumeracin Descripcin Especifique las opciones a utilizar con IfxBulkCopy. Estas opciones son distintivos de bits que le permiten combinarlos en mscaras de bits. Especifique las opciones de cursor a utilizar con IfxResultSet. Estas opciones son distintivos de bits que le permiten combinarlos en mscaras de bits. Especifique las opciones de conjunto de resultados a utilizar con IfxResultSet. Estas opciones son distintivos de bits que le permiten combinarlos en mscaras de bits. Especifica el tipo de datos de un campo, una propiedad o un IfxParameter.
IfxBulkCopyOptions IfxCursorType
IfxResultSetOptions IfxType
Consulta
3-4
Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Captulo 3, IBM Data Server Provider for .NET, en la pgina 3-1 IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece un acceso seguro y de alto rendimiento a los servidores de datos IBM.
Clase IfxBulkCopy
Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Jerarqua de herencia
System.Object System.MarshalByRefObject IBM.Data.Informix.IfxBulkCopy
Sintaxis
Visual Basic] NotInheritable Public Class IfxBulkCopy [C#] public sealed class IfxBulkCopy [C++] public ref class IfxBulkCopy sealed [JScript] public final class IfxBulkCopy
Comentarios
La fuente de los datos puede ser un objeto DataRow, DataTable o DataReader, lo que significa que los datos que se deben copiar pueden proceder de cualquier fuente que la aplicacin pueda leer. El destino es una tabla de una base de datos. Para permitir la copia de datos de columnas que tengan nombres distintos al de la tabla de destino, IfxBulkCopy utiliza objetos IfxCopyColumnMapping y IfxCopyColumnMappingCollection.
Ejemplo
[C#] El ejemplo siguiente muestra una copia masiva de datos de una fuente DataTable en la tabla SALES.
[C#] public static void copyIntoSales(IfxConnection conn, DataTable source) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "SALES"; try { salesCopy.WriteToServer(source); salesCopy.Close(); } catch (Exception ex)
3-5
{ MessageBox.Show(ex.ToString(), "Exception"); } }
Seguridad de hebra
Cualquier miembro esttico pblico (Shared en Visual Basic) de este tipo es seguro para operaciones multihebra. No se garantiza que cualquier miembro de instancia sea seguro para hebras.
Informacin de versin
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxBulkCopy Facilita la copia de filas de una fuente de datos a otra. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopy. Enumeracin IfxBulkCopyOptions en la pgina 3-67 Especifique las opciones a utilizar con IfxBulkCopy. Estas opciones son distintivos de bits que le permiten combinarlos en mscaras de bits. Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Miembros de IfxBulkCopy
Facilita la copia de filas de una fuente de datos a otra. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopy.
Constructores pblicos
Nombre IfxBulkCopy Descripcin Sobrecargado. Inicializa una instancia nueva de la clase IfxBulkCopy.
Propiedades pblicas
Nombre BulkCopyTimeout Descripcin Nmero de segundos durante los cuales se debe ejecutar la operacin de copia masiva antes de que se produzca un tiempo de espera excedido. Correlaciones de las columnas de la tabla de la fuente de datos con las columnas de la tabla de destino.
ColumnMappings
3-6
Nombre DestinationTableName
Descripcin Nombre de la tabla de destino residente en el servidor. Errores producidos en la operacin de copia masiva.
Errors NotifyAfter Nmero de filas que se deben copiar antes de generar un suceso IfxRowsCopied.
Mtodos pblicos
Nombre Close Cierra la instancia de IfxBulkCopy. Dispose WriteToServer Sobrecargado. Copia todas las filas de una fuente de datos en la tabla de destino especificada por la propiedad DestinationTableName. Descripcin Cierra la instancia de IfxBulkCopy.
Sucesos pblicos
Nombre IfxRowsCopied Descripcin Se produce cada vez que el nmero de filas copiadas alcanza el valor definido en la propiedad NotifyAfter.
Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Constructores de IfxBulkCopy
Inicializa una instancia nueva de la clase IfxBulkCopy.
Lista de sobrecargas
Inicializa una nueva instancia de la clase IfxBulkCopy con un objeto IfxConnection. IfxBulkCopy(IBM.Data.DB2.IfxConnection) Inicializa una nueva instancia de la clase IfxBulkCopy con un objeto IfxConnection y valores de enumeracin de IfxBulkCopyOptions. Inicializa una nueva instancia de la clase IfxBulkCopy con una serie de caracteres de conexin de base de datos.
IfxBulkCopy(IBM.Data.DB2.IfxConnection, IBM.Data.DB2.IfxBulkCopyOptions) IfxBulkCopy(string)
3-7
IfxBulkCopy(string, IBM.Data.DB2.IfxBulkCopyOptions)
Inicializa una nueva instancia de la clase IfxBulkCopy con una serie de caracteres de conexin de base de datos y valores de enumeracin de IfxBulkCopyOptions.
Consulta Miembros de IfxBulkCopy en la pgina 3-6 Facilita la copia de filas de una fuente de datos a otra. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopy. Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxBulkCopy.IfxBulkCopy(IBM.Data.DB2.IfxConnection): Inicializa una nueva instancia de la clase IfxBulkCopy con un objeto IfxConnection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New(connection As IfxConnection) [C#] public IfxBulkCopy(IfxConnection connection); [C++] public: IfxBulkCopy(IfxConnection* connection); [JScript] public function IfxBulkCopy(connection : IfxConnection);
Parmetros connection Objeto IfxConnection que representa una conexin con una base de datos. Excepciones
Tipo de excepcin InvalidOperationException Condicin Este constructor de IfxBulkCopy requiere el acceso a una conexin de base de datos abierta.
Comentarios Los datos se copiarn a una tabla del servidor de datos identificado en el parmetro de conexin.
3-8
Ejemplo [C#] El ejemplo siguiente muestra una copia masiva de datos de una fuente DataTable en la tabla SALES.
[C#] public static void copyIntoSales(IfxConnection conn, DataTable source) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "SALES"; try { salesCopy.WriteToServer(source); salesCopy.Close(); } catch (Exception ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxBulkCopy.IfxBulkCopy(IBM.Data.DB2.IfxConnection, IBM.Data.DB2.IfxBulkCopyOptions): Inicializa una nueva instancia de la clase IfxBulkCopy con un objeto IfxConnection y valores de enumeracin de IfxBulkCopyOptions. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ connection As IfxConnection, _ options As IfxBulkCopyOptions _ ) [C#] public IfxBulkCopy( IfxConnection connection, IfxBulkCopyOptions options, ); [C++] public: IfxBulkCopy( IfxConnection* connection, IfxBulkCopyOptions options,
3-9
); [JScript] public function IfxBulkCopy( connection : IfxConnection, options : IfxBulkCopyOptions );
Parmetros connection Objeto IfxConnection que representa una conexin con una base de datos. options Opciones que se deben utilizar durante la operacin de copia masiva. Se pueden especificar como una enumeracin IfxBulkCopyOptions individual o un valor de mscara de bits que indique las opciones deseadas de la enumeracin IfxBulkCopyOptions. Comentarios Los datos se copiarn a una tabla del servidor de datos identificado en el parmetro de conexin. Ejemplo [C#] El ejemplo siguiente muestra una copia masiva de datos de una fuente DataTable en la tabla SALES utilizando los valores TableLock y Truncate de la enumeracin IfxBulkCopyOptions. Todos los valores de la tabla de destino se borrarn antes de que empiece la operacin de copia masiva y la tabla se bloquear durante la operacin de copia masiva.
[C#] public static void copyIntoSales(IfxConnection conn, DataTable source) { IfxBulkCopy salesCopy = new IfxBulkCopy(connString, (IfxBulkCopyOptions)IfxBulkCopyOptions.TableLock | IfxBulkCopyOptions.Truncate); salesCopy.DestinationTableName = "SALES"; try { salesCopy.WriteToServer(source); salesCopy.Close(); } catch (Exception ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-10
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxBulkCopy.IfxBulkCopy(string): Inicializa una nueva instancia de la clase IfxBulkCopy con una serie de caracteres de conexin de base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New(connectionString As String) [C#] public IfxBulkCopy(string connectionString); [C++] public: IfxBulkCopy(String* connectionString); [JScript] public function IfxBulkCopy(connectionString : String);
Parmetros connectionString Serie de conexin para la conexin de base de datos. Comentarios Un objeto IfxConnection se inicializar utilizando la informacin de la serie de caracteres de la conexin. La IfxConnection se abrir y los datos se copiarn en la tabla. La IfxConnection se cerrar de forma automtica tras la operacin de copia masiva. Ejemplo [C#] El ejemplo siguiente muestra una copia masiva de datos de una fuente DataTable en la tabla SALES.
[C#] public static void copyIntoSales(String connString, DataTable source) { IfxBulkCopy salesCopy = new IfxBulkCopy(connString); salesCopy.DestinationTableName = "SALES"; try { salesCopy.WriteToServer(source); salesCopy.Close(); } catch (Exception ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
3-11
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxBulkCopy.IfxBulkCopy(string, IBM.Data.DB2.IfxBulkCopyOptions): Inicializa una nueva instancia de la clase IfxBulkCopy con una serie de caracteres de conexin de base de datos y valores de enumeracin de IfxBulkCopyOptions. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ connectionString As String, _ options As IfxBulkCopyOptions _ ) [C#] public IfxBulkCopy( string connectionString, IfxBulkCopyOptions options, ); [C++] public: IfxBulkCopy( String* connectionString, IfxBulkCopyOptions options, ); [JScript] public function IfxBulkCopy( connectionString : String, options : IfxBulkCopyOptions );
Parmetros connectionString Serie de conexin para la conexin de base de datos. options Opciones que se deben utilizar durante la operacin de copia masiva. Se pueden especificar como una enumeracin IfxBulkCopyOptions individual o un valor de mscara de bits que indique las opciones deseadas de la enumeracin IfxBulkCopyOptions.
3-12
Comentarios Un objeto IfxConnection se inicializar utilizando la informacin de la serie de caracteres de la conexin. La IfxConnection se abrir y los datos se copiarn en la tabla. La IfxConnection se cerrar de forma automtica tras la operacin de copia masiva. Ejemplo [C#] El ejemplo siguiente muestra una copia masiva de datos de una fuente DataTable en la tabla SALES utilizando los valores TableLock y Truncate de la enumeracin IfxBulkCopyOptions. Todos los valores de la tabla de destino se borrarn antes de que empiece la operacin de copia masiva y la tabla se bloquear durante la operacin de copia masiva.
[C#] public static void copyIntoSales(IfxConnection connString, DataTable source) { IfxBulkCopy salesCopy = new IfxBulkCopy(connString, (IfxBulkCopyOptions)IfxBulkCopyOptions.TableLock | IfxBulkCopyOptions.Truncate); salesCopy.DestinationTableName = "SALES"; try { salesCopy.WriteToServer(source); salesCopy.Close(); } catch (Exception ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxBulkCopy
Los mtodos de la clase IfxBulkCopy se listan a continuacin.
Mtodos pblicos
Nombre Close Cierra la instancia de IfxBulkCopy. Dispose Descripcin Cierra la instancia de IfxBulkCopy.
3-13
Nombre WriteToServer
Descripcin Sobrecargado. Copia todas las filas de una fuente de datos en la tabla de destino especificada por la propiedad DestinationTableName.
Consulta Miembros de IfxBulkCopy en la pgina 3-6 Facilita la copia de filas de una fuente de datos a otra. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopy. Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopy.Close: Cierra la instancia de IfxBulkCopy. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub Close [C#] public void Close () [C++] public: void Close () [JScript] public function Close ()
Comentarios Despus de llamar a Close en una instancia de IfxBulkCopy, ninguna otra operacin resultar satisfactoria. Cualquier accin realizada con miembros de una instancia de IfxBulkCopy despus de ejecutar Close har que el proveedor de datos emita una InvalidOperationException. Ejemplo [C#] El ejemplo siguiente muestra una copia masiva de datos de una fuente DataTable en la tabla SALES.
[C#] public static void copyIntoSales(IfxConnection conn, DataTable source) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "SALES"; try { salesCopy.WriteToServer(source);
3-14
salesCopy.Close(); } catch (Exception ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopy.Dispose: Cierra la instancia de IfxBulkCopy. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub Dispose [C#] public void Dispose () [C++] public: void Dispose () [JScript] public function Dispose ()
Comentarios Despus de llamar a Dispose en una instancia de IfxBulkCopy, ninguna otra operacin resultar satisfactoria. Cualquier accin realizada con miembros de una instancia de IfxBulkCopy despus de una operacin Dispose provocar que la aplicacin emita una excepcin InvalidOperationException. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos.
3-15
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopy.WriteToServer: Copia todas las filas de una fuente de datos en la tabla de destino especificada mediante la propiedad DestinationTableName. Lista de sobrecargas
Nombre WriteToServer(System.Data.DataRow[ ]) Descripcin Copia todas las filas de la matriz DataRow en la tabla de destino especificada mediante la propiedad DestinationTableName. Copia todas las filas de la DataTable en la tabla de destino especificada mediante la propiedad DestinationTableName. Copia solamente las filas que estn en el estado especificado (indicado en DataRowState) de la DataTable en la tabla de destino especificada mediante la propiedad DestinationTableName. Copia todas las filas del DataReader en la tabla de destino especificada mediante la propiedad DestinationTableName.
WriteToServer(System.Data.DataTable)
WriteToServer(System.Data.DataTable, System.Data.DataRowState)
WriteToServer(System.Data.IDataReader)
Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopy.WriteToServer(System.Data.DataRow[ ]): Copia todas las filas de la matriz DataRow en una tabla de destino especificada por la propiedad DestinationTableName. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub WriteToServer ( dataRows As DataRow() ) [C#] public void WriteToServer ( DataRow[] dataRows ) [C++] public:
3-16
void WriteToServer ( array<DataRow*>* dataRows ) [JScript] public function WriteToServer ( dataRows : DataRow[] )
Parmetros dataRows Matriz de objetos DataRow que se debe copiar en la tabla de destino. Ejemplo [C#] El ejemplo siguiente muestra una copia masiva de datos de una matriz de objetos DataRow en la tabla SALES.
[C#] public static void copyIntoSales(IfxConnection conn, DataRow [] source) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "SALES"; try { salesCopy.WriteToServer(source); salesCopy.Close(); } catch (Exception ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopy.WriteToServer(System.Data.DataTable): Copia todas las filas de la DataTable en la tabla de destino especificada por la propiedad DestinationTableName. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub WriteToServer ( dataTable As DataTable ) [C#] public void WriteToServer ( DataTable dataTable ) [C++] public:
3-17
void WriteToServer ( DataTable* dataTable ) [JScript] public function WriteToServer ( dataTable : DataTable )
Parmetros dataTable Objeto DataTable cuyas filas se copiarn en la tabla de destino. Ejemplo [C#] El ejemplo siguiente muestra una copia masiva de datos de una fuente DataTable en la tabla SALES.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopy.WriteToServer(System.Data.DataTable, System.Data.DataRowState): Copia solamente las filas que estn en el estado especificado (indicado en DataRowState) de la DataTable en la tabla de destino especificada mediante la propiedad DestinationTableName. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub WriteToServer ( _ dataTable As DataTable, _ rowState As DataRowState _
3-18
) [C#] public void WriteToServer ( DataTable dataTable, DataRowState rowState ) [C++] public: void WriteToServer ( DataTable* dataTable, DataRowState rowState ) [JScript] public function WriteToServer ( dataTable : DataTable, rowState : DataRowState )
Parmetros dataTable Objeto DataTable cuyas filas se copiarn en la tabla de destino. rowState Valor de la enumeracin DataRowState que especifica el estado de las filas que se deben copiar en la tabla de destino. Comentarios Los estados permitidos que DataRowState puede especificar son Added, Changed y Unmodified. Ejemplo [C#] El ejemplo siguiente muestra una copia masiva de datos de una fuente DataTable en la tabla SALES.
[C#] public static void copyIntoSales(IfxConnection conn, DataTable source) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "SALES"; try { salesCopy.WriteToServer(source, DataRowState.Unchanged); salesCopy.Close(); } catch (Exception ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos.
3-19
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. MtodoIfxBulkCopy.WriteToServer(System.Data.IDataReader): Copia todas las filas de DataReader en una tabla de destino especificada por la propiedad DestinationTableName. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub WriteToServer ( dataReader As IDataReader ) [C#] public void WriteToServer ( IDataReader dataReader ) [C++] public: void WriteToServer ( IDataReader* dataReader ) [JScript] public function WriteToServer ( dataReader : IDataReader )
Parmetros dataReader Objeto IDataReader cuyas filas se copiarn en la tabla de destino. Comentarios Para evitar una InvalidOperationException, la instancia de IfxBulkCopy necesita una instancia de IfxConnection que sea distinta a la instancia que IfxDataReader utiliza. Ejemplo [C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla SALES.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "SALES"; try { salesCopy.WriteToServer(reader); salesCopy.Close(); } catch (Exception ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
3-20
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxBulkCopy
Las propiedades de la clase IfxBulkCopy se listan a continuacin.
Propiedades pblicas
Nombre BulkCopyTimeout Descripcin Nmero de segundos durante los cuales se debe ejecutar la operacin de copia masiva antes de que se produzca un tiempo de espera excedido. Correlaciones de las columnas de la tabla de la fuente de datos con las columnas de la tabla de destino. Nombre de la tabla de destino residente en el servidor. DestinationTableName Errores producidos en la operacin de copia masiva. Errors NotifyAfter Nmero de filas que se deben copiar antes de generar un suceso IfxRowsCopied.
ColumnMappings
Consulta Miembros de IfxBulkCopy en la pgina 3-6 Facilita la copia de filas de una fuente de datos a otra. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopy. Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxBulkCopy.BulkCopyTimeout: Nmero de segundos durante los cuales se debe ejecutar la operacin de copia masiva antes de que se produzca un tiempo de espera excedido. Espacio de nombres: IBM.Data.Informix
3-21
Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis

Visual Basic] Public Property IfxBulkCopyTimeout As Integer [C#] public int IfxBulkCopyTimeout {get; set;} [C++] public: property int BulkCopyTimeout { int get(); void set (int value); } [JScript] public function get IfxBulkCopyTimeout () : int; public function set IfxBulkCopyTimeout (value : int);
Valor de la propiedad Valor entero de la propiedad IfxBulkCopyTimeout. El valor por omisin es cero, que significa que no hay tiempo de espera. Comentarios Si se proporciona una valor de IfxBulkCopyTimeout, ste alterar temporalmente el tiempo de espera de la consulta. De lo contrario, se aplicar el tiempo de espera de la consulta. Ejemplo [C#] El ejemplo siguiente muestra una copia masiva de datos de una fuente DataTable en la tabla SALES utilizando un tiempo de espera de 30 segundos.
[C#] public static void copyIntoSales(IfxConnection conn, DataTable source) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "SALES"; salesCopy.BulkCopyTimeout = 30; try { salesCopy.WriteToServer(source); salesCopy.Close(); } catch (Exception ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-22
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxBulkCopy.ColumnMappings: Correlaciones de las columnas de la tabla de la fuente de datos con las columnas de la tabla de destino. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property ColumnMappings As IfxBulkCopyColumnMappingCollection [C#] public IfxBulkCopyColumnMappingCollection ColumnMappings {get; set;} [C++] public: __property IfxBulkCopyColumnMappingCollection* get_ColumnMappings(); public: __property void set_ColumnMappings(IfxBulkCopyColumnMappingCollection*); [JScript] public function get ColumnMappings() : IfxBulkCopyColumnMappingCollection; public function set ColumnMappings(IfxBulkCopyColumnMappingCollection);
Valor de la propiedad Coleccin de correlaciones de columnas. Por omisin, es una coleccin vaca. Comentarios Las correlaciones definidas en la instancia de IfxBulkCopyColumnMappingCollection se validan en la llamada a WriteToServer(). Ejemplo [C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las tablas de origen y de destino se definen en una instancia de IfxBulkCopyColumnMappingCollection.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMappingCollection colMapCollection; colMapCollection = new IfxBulkCopyColumnMappingCollection(); salesCopy.ColumnMappings = colMapCollection; colMapCollection.Add("DEPTNUMB", "DEPTNO"); colMapCollection.Add("DEPTNAME", "DEPTNAME"); colMapCollection.Add("MANAGER", "ADMRDEPT"); colMapCollection.Add("LOCATION", "LOCATION"); try {
3-23
salesCopy.WriteToServer(reader); salesCopy.Close(); } catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxBulkCopy.DestinationTableName: Nombre de la tabla de destino del servidor donde se copiarn las filas de la fuente de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property DestinationTableName As String [C#] public string DestinationTableName {get; set;} [C++] public: __property String* get_DestinationTableName(); public: __property void set_DestinationTableName(String*); [JScript] public function get DestinationTableName() : String; public function set DestinationTableName(String);
Valor de la propiedad Valor de la serie de caracteres del nombre de la tabla de destino. Comentarios Para que la operacin WriteToServer resulte satisfactoria, se debe especificar un valor de DestinationTableName. Si es necesario conservar la sensibilidad a maysculas y minsculas para el nombre de la tabla de destino, debe escribir el nombre de la tabla de destino entre un par adicional de comillas dobles. Por ejemplo:
salesCopy.DestinationTable = "\"CanadaSales\"";
3-24
El valor que proporcione para DestinationTableName puede incluir, opcionalmente, el nombre de base de datos y el nombre de esquema, adems del nombre de tabla, que es obligatorio. Por ejemplo: SAMPLE.USER.SALES. Ejemplo [C#] El ejemplo siguiente muestra una copia masiva de datos de una fuente DataTable en la tabla SALES.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxBulkCopy.Errors: Errores producidos en la operacin de copia masiva. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Errors As IfxErrorCollection [C#] public IfxErrorCollection Errors {get;} [C++] public: __property IfxErrorCollection* get_Errors(); [JScript] public function get Errors() : IfxErrorCollection;
3-25
Valor de la propiedad Instancia de IfxErrorCollection que representa una coleccin de errores que se han producido durante la operacin de copia masiva. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxBulkCopy.NotifyAfter: Nmero de filas que se deben copiar antes de generar un suceso IfxRowsCopied. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property NotifyAfter As Integer [C#] public int NotifyAfter {get; set;} [C++] public: __property int get_NotifyAfter(); public: __property void set_NotifyAfter(int); [JScript] public function get NotifyAfter() : int; public function set NotifyAfter(int);
Valor de la propiedad Valor entero de la propiedad NotifyAfter que indica el nmero de filas que se deben copiar en la tabla de destino antes de generar un suceso IfxRowsCopied. La propiedad NotifyAfter puede establecerse a partir del manejador de sucesos de IfxRowsCopied. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-26
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Sucesos de IfxBulkCopy
Los sucesos de la clase IfxBulkCopy se listan a continuacin.
Sucesos pblicos
Nombre IfxRowsCopied Descripcin Se produce cada vez que el nmero de filas copiadas alcanza el valor definido en la propiedad NotifyAfter.
Consulta Miembros de IfxBulkCopy en la pgina 3-6 Facilita la copia de filas de una fuente de datos a otra. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopy. Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Suceso de IfxBulkCopy.IfxRowsCopied: Se produce cada vez que el nmero de filas copiadas alcanza el valor definido en la propiedad NotifyAfter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Event IfxRowsCopied As IfxRowsCopiedEventHandler [C#] public event IfxRowsCopiedEventHandler IfxRowsCopied; [C++] public: event IfxRowsCopiedEventHandler* IfxRowsCopied{ void add (IfxRowsCopiedEventHandler* value); void remove (IfxRowsCopiedEventHandler* value); }
[JScript] En JScript(R), podr manejar los sucesos definidos por una clase, pero no podr declarar nuevos sucesos. Comentarios La aplicacin puede terminar anormalmente la operacin en el manejador de sucesos estableciendo la propiedad Abort de IfxRowsCopiedEventArgs en true.
3-27
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Propiedad IfxBulkCopy.NotifyAfter en la pgina 3-26 Nmero de filas que se deben copiar antes de generar un suceso IfxRowsCopied. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxBulkCopyColumnMapping
Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.MarshalByRefObject IBM.Data.Informix.IfxBulkCopyColumnMapping
Sintaxis
Visual Basic] NotInheritable Public Class IfxBulkCopyColumnMapping [C#] public sealed class IfxBulkCopyColumnMapping [C++] public __gc __sealed class IfxBulkCopyColumnMapping [JScript] public final class IfxBulkCopyColumnMapping
Comentarios
Si no hay correlaciones de columnas definidas, las columnas se correlacionarn segn sus posiciones ordinales en su respectivo esquema de tabla. Si las columnas fuente y de destino no son compatibles, se emitir una excepcin InvalidOperationException.
Ejemplo
[C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las tablas de origen y de destino se definen mediante instancias de IfxBulkCopyColumnMapping.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn);
3-28
salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping colMapDeptNum colMapDeptNme colMapDeptMgr colMapDeptLoc = = = = new new new new IfxBulkCopyColumnMapping("DEPTNUMB", "DEPTNO"); IfxBulkCopyColumnMapping("DEPTNAME", "DEPTNAME"); IfxBulkCopyColumnMapping("MANAGER", "ADMRDEPT"); IfxBulkCopyColumnMapping("LOCATION", "LOCATION");
salesCopy.ColumnMappings.Add(colMapDeptNum); salesCopy.ColumnMappings.Add(colMapDeptNme); salesCopy.ColumnMappings.Add(colMapDeptMgr); salesCopy.ColumnMappings.Add(colMapDeptLoc); try { salesCopy.WriteToServer(reader); salesCopy.Close(); } catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxBulkCopyColumnMapping Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopyColumnMapping. Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Miembros de IfxBulkCopyColumnMapping
Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopyColumnMapping.
Nombre Descripcin Sobrecargado. Inicializa un objeto IfxBulkCopyColumnMapping nuevo. IfxBulkCopyColumnMapping
3-29
Propiedades pblicas
Nombre DestinationColumn DestinationOrdinal SourceColumn SourceOrdinal Valor ordinal de la columna que se est copiando de la fuente de datos. Descripcin Nombre de la columna con la que se establece correlacin en la tabla de destino. Valor ordinal de la columna con la que se establece correlacin en la tabla de destino. Nombre de la columna que se copia de la fuente de datos.
Mtodos pblicos
Nombre Equals (heredado de Object.) GetHashCode (heredado de Object.) ToString (heredado de Object.) Descripcin Determina si dos instancias de IfxBulkCopyColumnMapping son iguales. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el texto completo de la correlacin de columnas.
Consulta Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Constructores de IfxBulkCopyColumnMapping
Inicializa una instancia nueva de la clase IfxBulkCopyColumnMapping.
Nombre IfxBulkCopyColumnMapping() Descripcin Constructor por omisin que inicializa un nuevo objeto IfxBulkCopyColumnMapping. Inicializa un nuevo objeto IfxBulkCopyColumnMapping utilizando ordinales de columna para las columnas de la fuente de datos y de destino. IfxBulkCopyColumnMapping(int, int)
3-30
Nombre
Descripcin Inicializa un nuevo objeto IfxBulkCopyColumnMapping utilizando un ordinal de columna para la columna de la fuente de datos y un nombre de columna para la columna de destino. Inicializa un nuevo objeto IfxBulkCopyColumnMapping utilizando un nombre de columna para la columna de la fuente de datos y un ordinal de columna para la columna de destino. Inicializa un nuevo objeto IfxBulkCopyColumnMapping utilizando nombres de columna para las columnas de la fuente de datos y de destino.
IfxBulkCopyColumnMapping(int, string)
IfxBulkCopyColumnMapping(string, int)
IfxBulkCopyColumnMapping(string, string)
Consulta Miembros de IfxBulkCopyColumnMapping en la pgina 3-29 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopyColumnMapping. Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxBulkCopyColumnMapping.IfxBulkCopyColumnMapping(): Constructor por omisin que inicializa un nuevo objeto IfxBulkCopyColumnMapping. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New [C#] public IfxBulkCopyColumnMapping(); [C++] public: IfxBulkCopyColumnMapping(); [JScript] public function IfxBulkCopyColumnMapping();
Comentarios Si utiliza este constructor para crear una instancia de IfxBulkCopyColumnMapping necesitar asignar las columnas de origen y de destino. Las columnas de origen pueden definirse mediante las propiedades SourceColumn y SourceOrdinal. Las columnas de destino pueden definirse mediante las propiedades DestinationColumn y DestinationOrdinal.
3-31
Ejemplo [C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las tablas de origen y de destino se definen en las instancias de IfxBulkCopyColumnMapping mediante las propiedades SourceColumn y DestinationColumn.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping colMapDeptNum colMapDeptNme colMapDeptMgr colMapDeptLoc = = = = = = = = new new new new IfxBulkCopyColumnMapping(); IfxBulkCopyColumnMapping(); IfxBulkCopyColumnMapping(); IfxBulkCopyColumnMapping();
colMapDeptNum.DestinationColumn colMapDeptNme.DestinationColumn colMapDeptMgr.DestinationColumn colMapDeptLoc.DestinationColumn colMapDeptNum.SourceColumn colMapDeptNme.SourceColumn colMapDeptMgr.SourceColumn colMapDeptLoc.SourceColumn = = = =
"DEPTNO"; "DEPTNAME"; "ADMRDEPT"; "LOCATION";
"DEPTNUMB"; "DEPTNAME"; "MANAGER"; "LOCATION";
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor deIfxBulkCopyColumnMapping.IfxBulkCopyColumnMapping(int, int):
3-32
Inicializa un nuevo objeto IfxBulkCopyColumnMapping utilizando ordinales de columna para las columnas de la fuente de datos y de destino. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ source As Integer, _ destination As Integer _ ) [C#] public IfxBulkCopyColumnMapping( int source int destination ); [C++] public: IfxBulkCopyColumnMapping( int source int destination ); [JScript] public function IfxBulkCopyColumnMapping( source : int, destination : int )
Parmetros source Valor ordinal de la columna que se est copiando de la fuente de datos. destination Valor ordinal de la columna con la que se establece correlacin en la tabla de destino. Ejemplo [C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las tablas de origen y de destino se definen mediante instancias de IfxBulkCopyColumnMapping.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping colMapDeptNum colMapDeptNme colMapDeptMgr colMapDeptLoc = = = = new new new new IfxBulkCopyColumnMapping(0,0); IfxBulkCopyColumnMapping(1,1); IfxBulkCopyColumnMapping(2,3); IfxBulkCopyColumnMapping(4,4);
salesCopy.ColumnMappings.Add(colMapDeptNum); salesCopy.ColumnMappings.Add(colMapDeptNme); salesCopy.ColumnMappings.Add(colMapDeptMgr); salesCopy.ColumnMappings.Add(colMapDeptLoc); try { salesCopy.WriteToServer(reader);

3-33
salesCopy.Close(); } catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxBulkCopyColumnMapping.IfxBulkCopyColumnMapping(int, string): Inicializa un nuevo objeto IfxBulkCopyColumnMapping utilizando un ordinal de columna para la columna de la fuente de datos y un nombre de columna para la columna de destino. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ source As Integer, _ destination As String _ ) [C#] public IfxBulkCopyColumnMapping( int source string destination ); [C++] public: IfxBulkCopyColumnMapping( int source String* destination ); [JScript] public function IfxBulkCopyColumnMapping( source : int, destination : String )
Parmetros source Valor ordinal de la columna que se est copiando de la fuente de datos.
3-34
destination Nombre de la columna con la que se establece correlacin en la tabla de destino. Comentarios Para mantener la sensibilidad a maysculas y minsculas, el nombre de la columna debe aparecer entre un par adicional de comillas dobles. Por ejemplo, la columna de destino puede definirse de la forma siguiente:
IfxBulkCopyColumnMapping colMapDeptNum = new IfxBulkCopyColumnMapping(0, "\"LoCaTion\"");
Ejemplo [C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las tablas de origen y de destino se definen mediante instancias de IfxBulkCopyColumnMapping.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping colMapDeptNum colMapDeptNme colMapDeptMgr colMapDeptLoc = = = = new new new new IfxBulkCopyColumnMapping(0, IfxBulkCopyColumnMapping(1, IfxBulkCopyColumnMapping(2, IfxBulkCopyColumnMapping(4, "\"DEPTNO\""); "\"DEPTNAME\""); "\"ADMRDEPT\""); "\"LOCATION\"");
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-35
Constructor de IfxBulkCopyColumnMapping.IfxBulkCopyColumnMapping(string, int): Inicializa un nuevo objeto IfxBulkCopyColumnMapping utilizando un nombre de columna para la columna de la fuente de datos y un ordinal de columna para la columna de destino. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ source As String, _ destination As Integer _ ) [C#] public IfxBulkCopyColumnMapping( string source int destination ); [C++] public: IfxBulkCopyColumnMapping( String* source int destination ); [JScript] public function IfxBulkCopyColumnMapping( source : String, destination : int )
Parmetros source Nombre de la columna que se copia de la fuente de datos. destination Valor ordinal de la columna con la que se establece correlacin en la tabla de destino. Comentarios Para mantener la sensibilidad a maysculas y minsculas, el nombre de la columna debe aparecer entre un par adicional de comillas dobles. Por ejemplo, la columna de origen puede definirse de la forma siguiente:
IfxBulkCopyColumnMapping colMapDeptNum = new IfxBulkCopyColumnMapping("\"LoCaTion\"", 0);
3-36
salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping colMapDeptNum colMapDeptNme colMapDeptMgr colMapDeptLoc = = = = new new new new IfxBulkCopyColumnMapping("\"DEPTNUMB\"", 0); IfxBulkCopyColumnMapping("\"DEPTNAME\"", 1); IfxBulkCopyColumnMapping("\"MANAGER\"", 3); IfxBulkCopyColumnMapping("\"LOCATION\"", 4);
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxBulkCopyColumnMapping.IfxBulkCopyColumnMapping(string, string): Inicializa un nuevo objeto IfxBulkCopyColumnMapping utilizando nombres de columna para las columnas de la fuente de datos y de destino. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ source As String, _ destination As String _ ) [C#] public IfxBulkCopyColumnMapping( string source string destination ); [C++] public: IfxBulkCopyColumnMapping(
3-37
String* source String* destination ); [JScript] public function IfxBulkCopyColumnMapping( source : String, destination : String )
Parmetros source Nombre de la columna que se copia de la fuente de datos. destination Nombre de la columna con la que se establece correlacin en la tabla de destino. Comentarios Para mantener la sensibilidad a maysculas y minsculas, el nombre de la columna debe aparecer entre un par adicional de comillas dobles. Por ejemplo, las columnas de origen y de destino pueden definirse de la forma siguiente:
IfxBulkCopyColumnMapping colMapDeptNum = new IfxBulkCopyColumnMapping("\"LoCaTion1\"", "\"LoCaTion2\"");
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping colMapDeptNum colMapDeptNme colMapDeptMgr colMapDeptLoc = = = = new new new new IfxBulkCopyColumnMapping("\"DEPTNUMB\"", "\"DEPTNO\""); IfxBulkCopyColumnMapping("\"DEPTNAME\"", "\"DEPTNAME\""); IfxBulkCopyColumnMapping("\"MANAGER\"", "\"ADMRDEPT\""); IfxBulkCopyColumnMapping("\"LOCATION\"", "\"LOCATION\"");
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-38
Mtodos de IfxBulkCopyColumnMapping
Los mtodos de la clase IfxBulkCopyColumnMapping se listan a continuacin.
Mtodos pblicos
Nombre Equals (heredado de Object.) GetHashCode (heredado de Object.) ToString (heredado de Object.) Descripcin Determina si dos instancias de IfxBulkCopyColumnMapping son iguales. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el texto completo de la correlacin de columnas.
Consulta Miembros de IfxBulkCopyColumnMapping en la pgina 3-29 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopyColumnMapping. Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxBulkCopyColumnMapping
Las propiedades de la clase IfxBulkCopyColumnMapping se listan a continuacin.
Propiedades pblicas
Nombre DestinationColumn DestinationOrdinal SourceColumn SourceOrdinal Valor ordinal de la columna que se est copiando de la fuente de datos. Descripcin Nombre de la columna con la que se establece correlacin en la tabla de destino. Valor ordinal de la columna con la que se establece correlacin en la tabla de destino. Nombre de la columna que se copia de la fuente de datos.
Consulta
3-39
Miembros de IfxBulkCopyColumnMapping en la pgina 3-29 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopyColumnMapping. Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxBulkCopyColumnMapping.DestinationColumn: Nombre de la columna con la que se establece correlacin en la tabla de destino. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property DestinationColumn As String [C#] public string DestinationColumn {get; set;} [C++] public: __property String* get_DestinationColumn(); public: __property void set_DestinationColumn(String*); [JScript] public function get DestinationColumn() : String; public function set DestinationColumn(String);
Valor de la propiedad Valor de la serie de caracteres del nombre de la columna de destino. Comentarios En caso de que un valor de la columna de destino est definido varias veces (si los valores se aaden varias veces a las propiedades DestinationColumn o DestinationOrdinal o si un valor se ha asignado por lo menos una vez en cada una de estas dos propiedades), en el mtodo Add se utiliza el valor que se haya definido el ltimo. Para mantener la sensibilidad a maysculas y minsculas, el nombre de la columna debe aparecer entre un par adicional de comillas dobles. Por ejemplo, la columna de destino puede definirse de la forma siguiente:
salesCopy.ColumnMappings.DestinationColumn= "\"LoCaTion\"";
Ejemplo [C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las
3-40
tablas de origen y de destino se definen en las instancias de IfxBulkCopyColumnMapping mediante las propiedades SourceColumn y DestinationColumn.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxBulkCopyColumnMapping.DestinationOrdinal: Valor ordinal de la columna con la que se establece correlacin en la tabla de destino. Espacio de nombres: IBM.Data.Informix
3-41

Visual Basic] Public Property DestinationOrdinal As Integer [C#] public int DestinationOrdinal {get; set;} [C++] public: __property int get_DestinationOrdinal(); public: __property void set_DestinationOrdinal(int); [JScript] public function get DestinationOrdinal() : int; public function set DestinationOrdinal(int);
Valor de la propiedad Valor entero del ordinal que representa la columna de destino. Comentarios En caso de que un valor de la columna de destino est definido varias veces (si los valores se aaden varias veces a las propiedades DestinationColumn o DestinationOrdinal o si un valor se ha asignado por lo menos una vez en cada una de estas dos propiedades), en el mtodo Add se utiliza el valor que se haya definido el ltimo. Ejemplo [C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las tablas de origen y de destino se definen en las instancias de IfxBulkCopyColumnMapping mediante las propiedades SourceOrdinal y DestinationOrdinal.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping colMapDeptNum colMapDeptNme colMapDeptMgr colMapDeptLoc = = = = 0; 1; 3; 4; = = = = new new new new IfxBulkCopyColumnMapping(); IfxBulkCopyColumnMapping(); IfxBulkCopyColumnMapping(); IfxBulkCopyColumnMapping();
colMapDeptNum.DestinationOrdinal colMapDeptNme.DestinationOrdinal colMapDeptMgr.DestinationOrdinal colMapDeptLoc.DestinationOrdinal colMapDeptNum.SourceOrdinal colMapDeptNme.SourceOrdinal colMapDeptMgr.SourceOrdinal colMapDeptLoc.SourceOrdinal = = = = 0; 1; 2; 4;
salesCopy.ColumnMappings.Add(colMapDeptNum); salesCopy.ColumnMappings.Add(colMapDeptNme); salesCopy.ColumnMappings.Add(colMapDeptMgr); salesCopy.ColumnMappings.Add(colMapDeptLoc); try
3-42
{ salesCopy.WriteToServer(reader); salesCopy.Close(); } catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxBulkCopyColumnMapping.SourceColumn: Nombre de la columna que se copia de la fuente de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property SourceColumn As String [C#] public string SourceColumn {get; set;} [C++] public: __property String* get_SourceColumn(); public: __property void set_SourceColumn(String*); [JScript] public function get SourceColumn() : String; public function set SourceColumn(String);
Valor de la propiedad Valor de la serie de caracteres del nombre de la columna de origen. Comentarios En caso de que un valor de la columna de origen est definido varias veces (si los valores se aaden varias veces a las propiedades SourceColumn o SourceOrdinal o si un valor se ha asignado por lo menos una vez en cada una de estas dos propiedades), en el mtodo Add se utiliza el valor que se haya definido el ltimo. Para mantener la sensibilidad a maysculas y minsculas, el nombre de la columna debe aparecer entre un par adicional de comillas dobles. Por ejemplo, la columna de origen puede definirse de la forma siguiente:
3-43
salesCopy.ColumnMappings.SourceColumn= "\"LoCaTion\"";
Ejemplo [C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las tablas de origen y de destino se definen en las instancias de IfxBulkCopyColumnMapping mediante las propiedades SourceColumn y DestinationColumn.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxBulkCopyColumnMapping.SourceOrdinal:
3-44
Valor ordinal de la columna que se est copiando de la fuente de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property SourceOrdinal As Integer [C#] public int SourceOrdinal {get; set;} [C++] public: __property int get_SourceOrdinal(); public: __property void set_SourceOrdinal(int); [JScript] public function get SourceOrdinal() : int; public function set SourceOrdinal(int);
Valor de la propiedad Valor entero del ordinal que representa la columna de origen. Comentarios En caso de que un valor de la columna de origen est definido varias veces (si los valores se aaden varias veces a las propiedades SourceColumn o SourceOrdinal o si un valor se ha asignado por lo menos una vez en cada una de estas dos propiedades), en el mtodo Add se utiliza el valor que se haya definido el ltimo. Ejemplo [C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las tablas de origen y de destino se definen en las instancias de IfxBulkCopyColumnMapping mediante las propiedades SourceOrdinal y DestinationOrdinal.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping colMapDeptNum colMapDeptNme colMapDeptMgr colMapDeptLoc = = = = 0; 1; 3; 4; = = = = new new new new IfxBulkCopyColumnMapping(); IfxBulkCopyColumnMapping(); IfxBulkCopyColumnMapping(); IfxBulkCopyColumnMapping();
colMapDeptNum.DestinationOrdinal colMapDeptNme.DestinationOrdinal colMapDeptMgr.DestinationOrdinal colMapDeptLoc.DestinationOrdinal colMapDeptNum.SourceOrdinal colMapDeptNme.SourceOrdinal colMapDeptMgr.SourceOrdinal colMapDeptLoc.SourceOrdinal = = = = 0; 1; 2; 4;
salesCopy.ColumnMappings.Add(colMapDeptNum); salesCopy.ColumnMappings.Add(colMapDeptNme);
3-45
salesCopy.ColumnMappings.Add(colMapDeptMgr); salesCopy.ColumnMappings.Add(colMapDeptLoc); try { salesCopy.WriteToServer(reader); salesCopy.Close(); } catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxBulkCopyColumnMappingCollection
Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.Collections.CollectionBase IBM.Data.Informix.IfxBulkCopyColumnMappingCollection
Sintaxis
Visual Basic] NotInheritable Public Class IfxBulkCopyColumnMappingCollection _ Inherits System.Collections.CollectionBase [C#] public sealed class IfxBulkCopyColumnMappingCollection : System.Collections.CollectionBase [C++] public ref class IfxBulkCopyColumnMappingCollection sealed : public System.Collections.CollectionBase [JScript] public final class IfxBulkCopyColumnMappingCollection extends System.Collections.CollectionBase
Comentarios
Si no hay correlaciones de columnas definidas, las columnas se correlacionarn segn sus posiciones ordinales en su respectivo esquema de tabla. Si las columnas fuente y de destino no son compatibles, se emitir una excepcin InvalidOperationException.
3-46
Ejemplo
[C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las tablas de origen y de destino se definen en una instancia de IfxBulkCopyColumnMappingCollection.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMappingCollection colMapCollection; colMapCollection = new IfxBulkCopyColumnMappingCollection(); salesCopy.ColumnMappings = colMapCollection; colMapCollection.Add("DEPTNUMB", "DEPTNO"); colMapCollection.Add("DEPTNAME", "DEPTNAME"); colMapCollection.Add("MANAGER", "ADMRDEPT"); colMapCollection.Add("LOCATION", "LOCATION"); try { salesCopy.WriteToServer(reader); salesCopy.Close(); } catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxBulkCopyColumnMappingCollection en la pgina 3-48 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopyColumnMappingCollection. Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-47
Miembros de IfxBulkCopyColumnMappingCollection
Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopyColumnMappingCollection.
Nombre IfxBulkCopyColumnMappingCollection Descripcin Inicializa un nuevo objeto IfxBulkCopyColumnMappingCollection.
Mtodos pblicos
Nombre Add Descripcin Sobrecargado. Crea una IfxBulkCopyColumnMapping utilizando nombres de columna para las columnas de la fuente de datos y las columnas de destino, y lo aade a IfxBulkCopyColumnMappingCollection. Borra la coleccin actual de los objetos IfxBulkCopyColumnMapping. Devuelve un valor que indica si el objeto IfxBulkCopyColumnMapping especificado est en IfxBulkCopyColumnMappingCollection. Copia los objetos IfxBulkCopyColumnMapping de IfxBulkCopyColumnMappingCollection en una matriz de objetos IfxBulkCopyColumnMapping, comenzando en un ndice especificado de la matriz. Devuelve un valor que indica la posicin de la IfxBulkCopyColumnMappingCollection donde est ubicado el objeto IfxBulkCopyColumnMapping especificado. Inserte la IfxBulkCopyColumnMapping especificada en la IfxBulkCopyColumnMappingCollection en la posicin de ndice especificada. Elimina la IfxBulkCopyColumnMapping especificada de IfxBulkCopyColumnMappingCollection. Elimina la IfxBulkCopyColumnMapping en la posicin de ndice especificada de la IfxBulkCopyColumnMappingCollection. Obtiene el texto completo de las correlaciones de columnas de IfxBulkCopyColumnMappingCollection.
Clear Contains
CopyTo
IndexOf
Insert
Remove RemoveAt
ToString (heredado de Object.)
Mtodos protegidos
Nombre OnInsert (heredado de CollectionBase.) Descripcin Realiza procesos personalizados adicionales antes de insertar una nueva correlacin en la instancia de IfxBulkCopyColumnMappingCollection.
Consulta
3-48
Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Constructor de IfxBulkCopyColumnMappingCollection
Inicializa un nuevo objeto IfxBulkCopyColumnMappingCollection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] Public Sub New [C#] public IfxBulkCopyColumnMappingCollection(); [C++] public: IfxBulkCopyColumnMappingCollection(); [JScript] public function IfxBulkCopyColumnMappingCollection();
Comentarios
Si utiliza este constructor para crear una instancia de IfxBulkCopyColumnMappingCollection, necesitar aadir correlaciones de columnas. Se pueden aadir correlaciones de columnas utilizando los mtodos Add o Insert.
Ejemplo
[C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las tablas de origen y de destino se definen en una instancia de IfxBulkCopyColumnMappingCollection.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMappingCollection colMapCollection; colMapCollection = new IfxBulkCopyColumnMappingCollection(); salesCopy.ColumnMappings = colMapCollection; colMapCollection.Add("DEPTNUMB", "DEPTNO"); colMapCollection.Add("DEPTNAME", "DEPTNAME"); colMapCollection.Add("MANAGER", "ADMRDEPT"); colMapCollection.Add("LOCATION", "LOCATION"); try { salesCopy.WriteToServer(reader); salesCopy.Close();
3-49
} catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxBulkCopyColumnMappingCollection
Los mtodos de la clase IfxBulkCopyColumnMappingCollection se listan a continuacin.
Mtodos pblicos
Nombre Add Descripcin Sobrecargado. Crea una IfxBulkCopyColumnMapping utilizando nombres de columna para las columnas de la fuente de datos y las columnas de destino, y lo aade a IfxBulkCopyColumnMappingCollection. Borra la coleccin actual de los objetos IfxBulkCopyColumnMapping. Devuelve un valor que indica si el objeto IfxBulkCopyColumnMapping especificado est en IfxBulkCopyColumnMappingCollection. Copia los objetos IfxBulkCopyColumnMapping de IfxBulkCopyColumnMappingCollection en una matriz de objetos IfxBulkCopyColumnMapping, comenzando en un ndice especificado de la matriz. Devuelve un valor que indica la posicin de la IfxBulkCopyColumnMappingCollection donde est ubicado el objeto IfxBulkCopyColumnMapping especificado. Inserte la IfxBulkCopyColumnMapping especificada en la IfxBulkCopyColumnMappingCollection en la posicin de ndice especificada. Elimina la IfxBulkCopyColumnMapping especificada de IfxBulkCopyColumnMappingCollection. Elimina la IfxBulkCopyColumnMapping en la posicin de ndice especificada de la IfxBulkCopyColumnMappingCollection. Obtiene el texto completo de las correlaciones de columnas de IfxBulkCopyColumnMappingCollection.
Clear Contains
CopyTo
IndexOf
Insert
Remove RemoveAt
ToString (heredado de Object.)
3-50
Mtodos protegidos
Nombre OnInsert (heredado de CollectionBase.) Descripcin Realiza procesos personalizados adicionales antes de insertar una nueva correlacin en la instancia de IfxBulkCopyColumnMappingCollection.
Consulta Miembros de IfxBulkCopyColumnMappingCollection en la pgina 3-48 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Las tablas siguientes listan los miembros expuestos por la clase IfxBulkCopyColumnMappingCollection. Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopyColumnMappingCollection.Add: Crea una IfxBulkCopyColumnMapping utilizando nombres de columna para las columnas de la fuente de datos y las columnas de destino, y lo aade a IfxBulkCopyColumnMappingCollection. Lista de sobrecargas
Add(IBM.Data.Informix.IfxBulkCopyColumnMapping) Add(int, int) Aade la IfxBulkCopyColumnMapping especificada a IfxBulkCopyColumnMappingCollection. Crea una IfxBulkCopyColumnMapping utilizando ordinales de columna para las columnas de la fuente de datos y las columnas de destino, y la aade a IfxBulkCopyColumnMappingCollection. Crea una IfxBulkCopyColumnMapping utilizando un ordinal de columna para la columna de la fuente de datos y un nombre de columna para la columna de destino, y la aade a IfxBulkCopyColumnMappingCollection. Crea una IfxBulkCopyColumnMapping utilizando un nombre de columna para la columna de la fuente de datos y un ordinal de columna para la columna de destino, y la aade a IfxBulkCopyColumnMappingCollection. Crea una IfxBulkCopyColumnMapping utilizando nombres de columna para las columnas de la fuente de datos y las columnas de destino, y lo aade a IfxBulkCopyColumnMappingCollection.
Add(int, string)
Add(string, int)
Add(string, string)
Consulta
3-51
Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopyColumnMappingCollection.Add (IBM.Data.Informix.IfxBulkCopyColumnMapping): Aade la IfxBulkCopyColumnMapping especificada a IfxBulkCopyColumnMappingCollection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function Add ( _ bulkCopyColumnMapping As IfxBulkCopyColumnMapping _ ) As IfxBulkCopyColumnMapping [C#] public IfxBulkCopyColumnMapping Add(IfxBulkCopyColumnMapping bulkCopyColumnMapping) [C++] public: IfxBulkCopyColumnMapping* Add (IfxBulkCopyColumnMapping* bulkCopyColumnMapping) [JScript] public function Add( bulkCopyColumnMapping : IfxBulkCopyColumnMapping ) : IfxBulkCopyColumnMapping
Parmetros bulkCopyColumnMapping Correlacin de columnas que se aadir a IfxBulkCopyColumnMappingCollection. Valor de retorno Correlacin de columnas aadida a IfxBulkCopyColumnMappingCollection. Ejemplo [C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las tablas de origen y de destino se definen en una instancia de IfxBulkCopyColumnMappingCollection.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMappingCollection colMapCollection; colMapCollection = new IfxBulkCopyColumnMappingCollection();
3-52
salesCopy.ColumnMappings = colMapCollection; IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping IfxBulkCopyColumnMapping colMapDeptNum colMapDeptNme colMapDeptMgr colMapDeptLoc = = = = new new new new IfxBulkCopyColumnMapping("DEPTNUMB", "DEPTNO"); IfxBulkCopyColumnMapping("DEPTNAME", "DEPTNAME"); IfxBulkCopyColumnMapping("MANAGER", "ADMRDEPT"); IfxBulkCopyColumnMapping("LOCATION", "LOCATION");
colMapCollection.Add(colMapDeptNum); colMapCollection.Add(colMapDeptNme); colMapCollection.Add(colMapDeptMgr); colMapCollection.Add(colMapDeptLoc); try { salesCopy.WriteToServer(reader); salesCopy.Close(); } catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopyColumnMappingCollection.Add(int, int): Crea una IfxBulkCopyColumnMapping utilizando ordinales de columna para las columnas de la fuente de datos y las columnas de destino, y la aade a IfxBulkCopyColumnMappingCollection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function Add ( _ src As Integer, _ dest As Integer _ ) As IfxBulkCopyColumnMapping [C#] public IfxBulkCopyColumnMapping Add( int src, int dest ) [C++]
3-53
public: DB2BulkCopyColumnMapping* Add ( int src, int dest ) [JScript] public function Add( src : int, dest : int ) : IfxBulkCopyColumnMapping
Parmetros src dest Valor ordinal de la columna que se est copiando de la fuente de datos. Valor ordinal de la columna con la que se establece correlacin en la tabla de destino.
Valor de retorno Correlacin de columnas aadida a IfxBulkCopyColumnMappingCollection. Ejemplo [C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las tablas de origen y de destino se definen en una instancia de IfxBulkCopyColumnMappingCollection.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMappingCollection colMapCollection; colMapCollection = new IfxBulkCopyColumnMappingCollection(); salesCopy.ColumnMappings = colMapCollection; colMapCollection.Add(0, colMapCollection.Add(1, colMapCollection.Add(2, colMapCollection.Add(4, 0); 1); 3); 4);
try { salesCopy.WriteToServer(reader); salesCopy.Close(); } catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino.
3-54
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopyColumnMappingCollection.Add(int, string): Crea una IfxBulkCopyColumnMapping utilizando un ordinal de columna para la columna de la fuente de datos y un nombre de columna para la columna de destino, y la aade a IfxBulkCopyColumnMappingCollection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function Add ( _ src As Integer, _ dest As String _ ) As IfxBulkCopyColumnMapping [C#] public IfxBulkCopyColumnMapping Add( int src, string dest ) [C++] public: DB2BulkCopyColumnMapping* Add ( int src, String* dest ) [JScript] public function Add( src : int, dest : String ) : IfxBulkCopyColumnMapping
Parmetros src dest Valor ordinal de la columna que se est copiando de la fuente de datos. Nombre de la columna con la que se establece correlacin en la tabla de destino.
3-55
salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMappingCollection colMapCollection; colMapCollection = new IfxBulkCopyColumnMappingCollection(); salesCopy.ColumnMappings = colMapCollection; colMapCollection.Add(0, colMapCollection.Add(1, colMapCollection.Add(2, colMapCollection.Add(4, "DEPTNO"); "DEPTNAME"); "ADMRDEPT"); "LOCATION");
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopyColumnMappingCollection.Add(string, int): Crea una IfxBulkCopyColumnMapping utilizando un nombre de columna para la columna de la fuente de datos y un ordinal de columna para la columna de destino, y la aade a IfxBulkCopyColumnMappingCollection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function Add ( _ src As String, _ dest As Integer _ ) As IfxBulkCopyColumnMapping [C#] public IfxBulkCopyColumnMapping Add( string src, int dest ) [C++] public:
3-56
DB2BulkCopyColumnMapping* Add ( String* src, int dest ) [JScript] public function Add( src : String, dest : int ) : IfxBulkCopyColumnMapping
Parmetros src dest Nombre de la columna que se copia de la fuente de datos. Valor ordinal de la columna con la que se establece correlacin en la tabla de destino.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMappingCollection colMapCollection; colMapCollection = new IfxBulkCopyColumnMappingCollection(); salesCopy.ColumnMappings = colMapCollection; colMapCollection.Add("DEPTNUMB", 0); colMapCollection.Add("DEPTNAME", 1); colMapCollection.Add("MANAGER", 3); colMapCollection.Add("LOCATION", 4); try { salesCopy.WriteToServer(reader); salesCopy.Close(); } catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino.
3-57
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopyColumnMappingCollection.Add(string, string): Crea una IfxBulkCopyColumnMapping utilizando nombres de columna para las columnas de la fuente de datos y las columnas de destino, y lo aade a IfxBulkCopyColumnMappingCollection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function Add ( _ src As String, _ dest As String _ ) As IfxBulkCopyColumnMapping [C#] public IfxBulkCopyColumnMapping Add( string src, string dest ) [C++] public: DB2BulkCopyColumnMapping* Add ( String* src, String* dest ) [JScript] public function Add( src : String, dest : String ) : IfxBulkCopyColumnMapping
Parmetros src dest Nombre de la columna que se copia de la fuente de datos. Nombre de la columna con la que se establece correlacin en la tabla de destino.
3-58
salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMappingCollection colMapCollection; colMapCollection = new IfxBulkCopyColumnMappingCollection(); salesCopy.ColumnMappings = colMapCollection; colMapCollection.Add("DEPTNUMB", "DEPTNO"); colMapCollection.Add("DEPTNAME", "DEPTNAME"); colMapCollection.Add("MANAGER", "ADMRDEPT"); colMapCollection.Add("LOCATION", "LOCATION"); try { salesCopy.WriteToServer(reader); salesCopy.Close(); } catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopyColumnMappingCollection.Clear: Borra la coleccin actual de los objetos IfxBulkCopyColumnMapping. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub Clear [C#] public void Clear () [C++] public: void Clear () [JScript] public function Clear ()
Comentarios Si necesita realizar varias copias masivas, sera ms eficaz utilizar una nica instancia de IfxBulkCopy que crear una nueva instancia para cada operacin de
3-59
copia masiva. Al realizar varias operaciones de copia masiva, utilice el mtodo Clear para eliminar correlaciones de columna existentes (despus de ejecutar el mtodo IfxBulkCopy.WriteToServer para la operacin anterior) antes de definir nuevas correlaciones de columnas para la siguiente operacin de copia masiva. Ejemplo [C#] El ejemplo siguiente demuestra un mtodo que acepta las instancias de IfxBulkCopy y IfxBulkCopyColumnMappingCollection existentes y realiza copia masiva de datos de IfxDataReader en la tabla DEPARTMENT. Otros mtodos similares a este utilizan las instancias de IfxBulkCopy y IfxBulkCopyColumnMappingCollection, siempre que borren las correlaciones de columnas antes de definir las suyas propias.
[C#] public static void copyDept(IfxConnection conn, IfxDataReader reader, IfxBulkCopy salesCopy, IfxBulkCopyColumnMappingCollection colMapCollection) { colMapCollection.Clear(); salesCopy.DestinationTableName = "DEPARTMENT"; colMapCollection.Add("DEPTNUMB", "DEPTNO"); colMapCollection.Add("DEPTNAME", "DEPTNAME"); colMapCollection.Add("MANAGER", "ADMRDEPT"); colMapCollection.Add("LOCATION", "LOCATION"); try { salesCopy.WriteToServer(reader); colMapCollection.Clear(); } catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopyColumnMappingCollection.Contains: Devuelve un valor que indica si el objeto IfxBulkCopyColumnMapping especificado est en IfxBulkCopyColumnMappingCollection. Espacio de nombres: IBM.Data.Informix
3-60

Visual Basic] Public Function Contains ( _ inValue As IfxBulkCopyColumnMapping _ ) As Boolean [C#] public bool Contains(IfxBulkCopyColumnMapping inValue) [C++] public: bool Contains (IfxBulkCopyColumnMapping* inValue) [JScript] public function Contains( inValue : IfxBulkCopyColumnMapping ) : boolean
Parmetros inValue Objeto IfxBulkCopyColumnMapping. Valor de retorno Si la IfxBulkCopyColumnMapping especificada existe en la coleccin, Contains devuelve true. Si no, Contains devuelve false. Ejemplo [C#] El ejemplo siguiente demuestra una copia masiva de datos de un IfxDataReader en la tabla DEPARTMENT. Las correlaciones de columnas entre las tablas de origen y de destino se definen en una instancia de IfxBulkCopyColumnMappingCollection. Adems de la operacin de copia masiva, el mtodo Contains se muestra cuando determina si IfxBulkCopyColumnMapping existe en la coleccin.
[C#] public static void copyIntoSales(IfxConnection conn, IfxDataReader reader) { IfxBulkCopy salesCopy = new IfxBulkCopy(conn); salesCopy.DestinationTableName = "DEPARTMENT"; IfxBulkCopyColumnMappingCollection colMapCollection; colMapCollection = new IfxBulkCopyColumnMappingCollection(); salesCopy.ColumnMappings = colMapCollection; colMapCollection.Add("DEPTNUMB", "DEPTNO"); colMapCollection.Add("DEPTNAME", "DEPTNAME"); colMapCollection.Add("MANAGER", "ADMRDEPT"); colMapCollection.Add("LOCATION", "LOCATION"); //Determine if a IfxBulkCopyColumnMapping //is included in the current collection. IfxBulkCopyColumnMapping colMapDeptNum = new IfxBulkCopyColumnMapping("DEPTNUMB", "DEPTNO"); //If the IfxBulkCopyColumnMapping does exist, print a message indicating this. if (colMapCollection.Contains(colMapDeptNum)) { MessageBox.Show("The Department Number mapping is included in the mapping collection."); }
3-61
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopyColumnMappingCollection.CopyTo: Copia los objetos IfxBulkCopyColumnMapping de IfxBulkCopyColumnMappingCollection en una matriz de objetos IfxBulkCopyColumnMapping, comenzando en un ndice especificado de la matriz. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub CopyTo ( _ array As IfxBulkCopyColumnMapping() _ index As Integer _ ) [C#] public void CopyTo( IfxBulkCopyColumnMapping[] inValue, int index ) [C++] public: void CopyTo ( array<IfxBulkCopyColumnMapping> array, index int ) [JScript] public function CopyTo( array : IfxBulkCopyColumnMapping[], index : int )
3-62
Parmetros array index Matriz que albergar objetos IfxBulkCopyColumnMapping que se copiarn de IfxBulkCopyColumnMappingCollection. Valor de ndice que indica en qu lugar de la matriz se iniciar la copia.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopyColumnMappingCollection.IndexOf: Devuelve un valor que indica la posicin de la IfxBulkCopyColumnMappingCollection donde est ubicado el objeto IfxBulkCopyColumnMapping especificado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function IndexOf ( _ inValue As IfxBulkCopyColumnMapping _ ) As Integer [C#] public int IndexOf(IfxBulkCopyColumnMapping inValue) [C++] public: int IndexOf (IfxBulkCopyColumnMapping* inValue) [JScript] public function IndexOf( inValue : IfxBulkCopyColumnMapping ) : int
Parmetros inValue El objeto IfxBulkCopyColumnMapping que est buscando. Valor de retorno ndice basado en cero de la correlacin de columnas. IndexOf devolver -1 si no se encuentra la correlacin de columnas en la coleccin.
3-63
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopyColumnMappingCollection.Insert: Inserte la IfxBulkCopyColumnMapping especificada en la IfxBulkCopyColumnMappingCollection en la posicin de ndice especificada. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub Insert ( _ index As Integer, _ inValue As IfxBulkCopyColumnMapping _ ) [C#] public void Insert(int index, IfxBulkCopyColumnMapping inValue) [C++] public: void Insert (int index, IfxBulkCopyColumnMapping* inValue) [JScript] public function Insert( index : int, inValue : IfxBulkCopyColumnMapping )
Parmetros index Poscin de ndice basada en cero de la IfxBulkCopyColumnMappingCollection donde se insertar el objeto IfxBulkCopyColumnMapping. Objeto IfxBulkCopyColumnMapping que se insertar en IfxBulkCopyColumnMappingCollection. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino.
inValue
3-64
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopyColumnMappingCollection.RemoveAt: Elimina la IfxBulkCopyColumnMapping en la posicin de ndice especificada de la IfxBulkCopyColumnMappingCollection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub RemoveAt ( index As Integer ) [C#] public void RemoveAt(int index) [C++] public: void RemoveAt (int index) [JScript] public function RemoveAt( index : int )
Parmetros index Posicin de ndice basada en cero de la IfxBulkCopyColumnMappingCollection de la que se eliminar el objeto IfxBulkCopyColumnMapping.
Comentarios Si necesita realizar varias copias masivas, sera ms eficaz utilizar una nica instancia de IfxBulkCopy que crear una nueva instancia para cada operacin de copia masiva. Al realizar varias operaciones de copia masiva, utilice el mtodo RemoveAt para eliminar correlaciones de columna seleccionadas (despus de ejecutar el mtodo IfxBulkCopy.WriteToServer para la operacin anterior) antes de definir nuevas correlaciones de columnas para la siguiente operacin de copia masiva. Tambin puede utilizar el mtodo Clear para eliminar todas las correlaciones de columnas existentes. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-65
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxBulkCopyColumnMappingCollection.Remove: Elimina la IfxBulkCopyColumnMapping especificada de IfxBulkCopyColumnMappingCollection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub Remove ( _ inValue As IfxBulkCopyColumnMapping _ ) [C#] public void Remove(IfxBulkCopyColumnMapping inValue) [C++] public: void Remove (IfxBulkCopyColumnMapping* inValue) [JScript] public function Remove( inValue : IfxBulkCopyColumnMapping )
Parmetros inValue Objeto IfxBulkCopyColumnMapping que se eliminar de IfxBulkCopyColumnMappingCollection. Comentarios Si necesita realizar varias copias masivas, sera ms eficaz utilizar una nica instancia de IfxBulkCopy que crear una nueva instancia para cada operacin de copia masiva. Al realizar varias operaciones de copia masiva, utilice el mtodo Remove para eliminar las correlaciones de columnas seleccionadas (despus de ejecutar el mtodo IfxBulkCopy.WriteToServer para la operacin anterior) antes de definir nuevas correlaciones de columnas para la siguiente operacin de copia masiva. Tambin puede utilizar el mtodo Clear para eliminar todas las correlaciones de columnas existentes. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-66
Enumeracin IfxBulkCopyOptions
Especifique las opciones a utilizar con IfxBulkCopy. Estas opciones son distintivos de bits que le permiten combinarlos en mscaras de bits. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] <Serializable> Public Enum IfxBulkCopyOptions [C#] [Serializable] public enum IfxBulkCopyOptions [C++] [Serializable] __value public enum IfxBulkCopyOptions [JScript] public Serializable enum IfxBulkCopyOptions
Comentarios
Puede pasar una enumeracin IfxBulkCopyOptions a un constructor de IfxBulkCopy para definir comportamientos especficos para los mtodos WriteToServer.
Miembros
Nombre de miembro Valor por omisin KeepIdentity Valor de bit 0 1 Descripcin Utilice los valores por omisin para todas las opciones. Preservar los valores de identidad del fuente. Las columnas de identidad solamente se pueden conservar si no estn definidas como GENERATED ALWAYS. Cuando no se especifica esta opcin, los valores de identidad se asignan de acuerdo con el destino. TableLock 2 Asigna un bloqueo de tabla para el tiempo que dura una operacin de copia masiva. No se permite que las dems aplicaciones actualicen la tabla durante la operacin de copia. Cuando no se especifica esta opcin, se permiten las lecturas de la tabla para las filas que existan antes de la operacin de copia. Truncate 4 Borra los datos de la tabla de destino antes del inicio de la operacin de copia.
3-67
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Clase IfxBulkCopyColumnMapping en la pgina 3-28 Representa una correlacin de columnas de la tabla fuente de datos con la tabla de destino. Clase IfxBulkCopyColumnMappingCollection en la pgina 3-46 Representa una coleccin de correlaciones de columnas de la tabla fuente con la tabla de destino. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxCommandBuilder
Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Jerarqua de herencias de .NET Framework 1.1

System.Object System.MarshalByRefObject System.ComponentModel.Component IBM.Data.Informix.IfxCommandBuilder
Jerarqua de herencias de .NET Framework 2.0 y 3.0

System.Object System.MarshalByRefObject System.ComponentModel.Component System.Data.Common.DbCommandBuilder IBM.Data.Informix.IfxCommandBuilder
Sintaxis de .NET Framework 1.1

Visual Basic] NotInheritable Public Class IfxCommandBuilder Inherits Component [C#] public sealed class IfxCommandBuilder : Component [C++] public __gc __sealed class IfxCommandBuilder : public Component [JScript] public final class IfxCommandBuilder extends Component
3-68
Sintaxis de .NET Framework 2.0 y 3.0

Visual Basic] NotInheritable Public Class IfxCommandBuilder Inherits DbCommandBuilder [C#] public sealed class IfxCommandBuilder : DbCommandBuilder [C++] public __gc __sealed class IfxCommandBuilder : public DbCommandBuilder [JScript] public final class IfxCommandBuilder extends DbCommandBuilder
Comentarios
IfxDataAdapter no genera automticamente las sentencias de SQL necesarias para reconciliar los cambios realizados en un DataSet asociado con la base de datos. Sin embargo, puede crear un objeto IfxCommandBuilder que genera sentencias de SQL para actualizaciones de una sola tabla estableciendo la propiedad SelectCommand del IfxDataAdapter. A continuacin, el IfxCommandBuilder genera cualquier sentencia de SQL adicional que el usuario no establezca. La relacin entre un IfxDataAdapter y su IfxCommandBuilder correspondiente siempre es de uno en uno. Para crear esta correspondencia, debe establecerse la propiedad DataAdapter del objeto IfxCommandBuilder. Esto hace que IfxCommandBuilder se registre a s mismo como escucha, lo que genera la salida de los sucesos IfxDataAdapter.RowUpdating que afectan al DataSet. Para generar sentencias INSERT, UPDATE, o DELETE, el IfxCommandBuilder utiliza la propiedad SelectCommand para recuperar un conjunto de metadatos obligatorio. Si cambia el valor de SelectCommand despus de haber recuperado los metadatos (por ejemplo, despus de la primera actualizacin), debe invocar el mtodo RefreshSchema para actualizar los metadatos. Nota: Si la sentencia SELECT asignada a la propiedad SelectCommand utiliza nombres de columna con alias, puede que las sentencias INSERT, UPDATE y DELETE resultantes sean imprecisas o que fallen. Si el servidor de datos no puede proporcionar el nombre de columna base apropiado para el nombre de columna con alias, se podra utilizar el nombre de alias en las sentencias INSERT, UPDATE y DELETE generadas. Las sentencias INSERT, UPDATE y DELETE generadas daran lugar a errores. IfxCommandBuilder tambin utiliza las propiedades IfxCommand.Connection, IfxCommand.CommandTimeout y IfxCommand.Transaction a las que SelectCommand hace referencia. El usuario debe invocar RefreshSchema si se modifica cualquiera de estas propiedades o si se cambia el valor de la propia propiedad SelectCommand. De lo contrario, las propiedades IfxDataAdapter.InsertCommand, IfxDataAdapter.UpdateCommand y IfxDataAdapter.DeleteCommand retienen los valores anteriores. Si se llama a Dispose, IfxCommandBuilder se disocia de IfxDataAdapter y los mandatos generados ya no se utilizan.
Ejemplo
[Visual Basic, C#] El ejemplo siguiente utiliza IfxCommand, junto con IfxDataAdapter e IfxConnection, para seleccionar filas desde una base de datos. En este ejemplo se pasa un DataSet inicializado, una serie de caracteres de conexin,
3-69
una serie de consulta que es una sentencia SELECT de SQL y una serie de caracteres que es el nombre de la tabla de base de datos. A continuacin, el ejemplo crea un IfxCommandBuilder.
[Visual Basic] Public Function SelectIfxSrvRows(myDataSet As DataSet, myConnection As String, mySelectQuery As String, myTableName As String) As DataSet im myConn As New IfxConnection(myConnection) Dim myDataAdapter As New IfxDataAdapter() myDataAdapter.SelectCommand = New IfxCommand(mySelectQuery, myConn) Dim employeeCB As IfxCommandBuilder = New IfxCommandBuilder(myDataAdapter) myConn.Open() Dim employeeDS As DataSet = New DataSet() myDataAdapter.Fill(employeeDS, "EMPLOYEE") Code to modify data in DataSet here Without the IfxCommandBuilder this line would fail. myDataAdapter.Update(employeeDS, "EMPLOYEE") myConn.Close() Return employeeDS End Function SelectIfxSrvRows [C#] public DataSet SelectIfxSrvRows(DataSet myDataSet,string myConnection,string mySelectQuery,string myTableName) { IfxConnection myConn = new IfxConnection(myConnection); IfxDataAdapter myDataAdapter = new IfxDataAdapter(); myDataAdapter.SelectCommand = new IfxCommand(mySelectQuery, myConn); IfxCommandBuilder employeeCB = new IfxCommandBuilder(myDataAdapter); myConn.Open(); DataSet employeeDS = new DataSet(); myDataAdapter.Fill(employeeDS, "EMPLOYEE"); //code to modify data in dataset here //Without the IfxCommandBuilder this line would fail myDataAdapter.Update(employeeDS, "EMPLOYEE"); myConn.Close(); return employeeDS; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder
3-70
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbDatAdp.cs DbDatAdp.vb DbDatMap.cs DbDatMap.vb
Miembros de IfxCommandBuilder
Miembros de IfxCommandBuilder
IfxCommandBuilder Sobrecargado. Inicializa una instancia nueva de la clase IfxCommandBuilder.
Propiedades pblicas
CatalogLocation CatalogSeparator Obtiene la CatalogLocation para esta instancia de IfxCommandBuilder. Obtiene la serie de caracteres que representa un separador de catlogo para esta instancia de IfxCommandBuilder. Obtiene el IContainer que contiene el Component. Obtiene o establece un objeto IfxDataAdapter para el cual este objeto IfxCommandBuilder generar sentencias de SQL. Obtiene o establece el carcter inicial o caracteres iniciales que se deben utilizar al trabajar con objetos de base de datos (por ejemplo, tablas o columnas) cuyos nombres contienen caracteres tales como espacios o smbolos reservados. Obtiene o establece el carcter final o caracteres finales que se deben utilizar al trabajar con objetos de base de datos (por ejemplo, tablas o columnas) cuyos nombres contienen caracteres tales como espacios o smbolos reservados. Obtiene la serie de caracteres que representa un separador de esquema para esta instancia de IfxCommandBuilder. Obtiene o establece el ISite de Component. Site (heredada de Component)
Container (heredada de Component) DataAdapter
QuotePrefix
QuoteSuffix
SchemaSeparator
3-71
Mtodos pblicos
CreateObjRef (heredado de MarshalByRefObject) Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Recupera informacin sobre los parmetros del procedimiento almacenado especificado en el IfxCommand y llena la coleccin Parameters del objeto IfxCommand especificado. Sobrecargado. Libera los recursos utilizados por Component. Sobrecargado. Determina si dos instancias de Object son iguales. Obtiene el objeto IfxCommand generado automticamente necesario para realizar supresiones en la base de datos. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el objeto IfxCommand generado automticamente necesario para realizar inserciones en la base de datos. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el Type de la instancia actual. GetType (heredado de Object) GetUpdateCommand Obtiene el objeto IfxCommand generado automticamente necesario para realizar actualizaciones en la base de datos. Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Acepta un identificador sin comillas y devuelve el identificador en un formato entre comillas. Renueva la informacin de esquema de la base de datos utilizada para generar sentencias INSERT, UPDATE o DELETE. Acepta un identificador entre comillas y devuelve el identificador en un formato sin comillas. Devuelve una String que representa el Object actual.
DeriveParameters
Dispose (heredado de Component) Equals (heredado de Object) GetDeleteCommand
GetHashCode (heredado de Object)
GetInsertCommand
GetLifetimeService (heredado de MarshalByRefObject)
InitializeLifetimeService (heredado de MarshalByRefObject) QuoteIdentifier
RefreshSchema
UnquoteIdentifier
ToString (heredado de Object)
3-72
Sucesos pblicos
Disposed (heredado de Component) Aade un manejador de sucesos para escuchar al suceso Disposed en el componente.
Propiedades protegidas
DesignMode (heredada de Component) Events (heredada de Component) Obtiene un valor que indica si el Component est actualmente en modalidad de diseo. Obtiene la lista de manejadores de sucesos que estn conectados a este Component.
Mtodos protegidos
Dispose Sobrecargado. Alterado temporalmente. Libera los recursos que el IfxCommandBuilder utiliza. Sobrecargado. Devuelve el nombre completo del parmetro utilizando el nombre parcial del parmetro. Devuelve el espacio reservado para el parmetro en la correspondiente sentencia de SQL. Devuelve un objeto que representa un servicio proporcionado por el Component o por su Container. Crea una copia superficial del Object actual. MemberwiseClone (heredado de Object) SetRowUpdatingHandler Registra el IfxCommandBuilder que debe gestionar el suceso RowUpdating para un IfxDataAdapter.
GetParameterName
GetParameterPlaceholder
GetService (heredado de Component)
Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Constructor de IfxCommandBuilder
Inicializa una instancia nueva de la clase IfxCommandBuilder.
3-73
Nombre New() New(IfxDataAdapter) Descripcin Inicializa una nueva instancia de la clase IfxCommandBuilder. Inicializa una nueva instancia de la clase IfxCommandBuilder con el objeto asociado IfxDataAdapter.
Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxCommandBuilder (): Inicializa una instancia nueva de la clase IfxCommandBuilder. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New() [C#] public IfxCommandBuilder(); [C++] public: IfxCommandBuilder(); [JScript] public function IfxCommandBuilder();
Comentarios El constructor base inicializa todos los campos en sus valores por omisin. Consulta Constructor de IfxCommandBuilder en la pgina 3-73 Inicializa una instancia nueva de la clase IfxCommandBuilder. Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-74
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxCommandBuilder(IfxDataAdapter): Inicializa una nueva instancia de la clase IfxCommandBuilder con el objeto IfxDataAdapter asociado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ ByVal adapter As IfxDataAdapter _ ) [C#] public IfxCommandBuilder( IfxDataAdapter adapter ); [C++] public: IfxCommandBuilder( IfxDataAdapter * adapter ); [JScript] public function IfxCommandBuilder( adapter : IfxDataAdapter );
Parmetros adapter Objeto IfxDataAdapter que debe asociarse con este IfxCommandBuilder. Comentarios IfxCommandBuilder se registra a s mismo como escucha para los sucesos de IfxDataAdapter.RowUpdating que genera el IfxDataAdapter especificado en esta propiedad. Cuando se crea una nueva instancia de IfxCommandBuilder, se libera cualquier IfxCommandBuilder existente que est asociado con este IfxDataAdapter. Consulta Constructor de IfxCommandBuilder en la pgina 3-73 Inicializa una instancia nueva de la clase IfxCommandBuilder. Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder
3-75
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxCommandBuilder
Los mtodos de la clase IfxCommandBuilder se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxCommandBuilder, consulte el tema Miembros de IfxCommandBuilder.
Mtodos pblicos
CreateObjRef (heredado de MarshalByRefObject) Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Recupera informacin sobre los parmetros del procedimiento almacenado especificado en el IfxCommand y llena la coleccin Parameters del objeto IfxCommand especificado. Sobrecargado. Libera los recursos utilizados por Component. Sobrecargado. Determina si dos instancias de Object son iguales. Obtiene el objeto IfxCommand generado automticamente necesario para realizar supresiones en la base de datos. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el objeto IfxCommand generado automticamente necesario para realizar inserciones en la base de datos. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el Type de la instancia actual. GetType (heredado de Object) GetUpdateCommand Obtiene el objeto IfxCommand generado automticamente necesario para realizar actualizaciones en la base de datos. Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Acepta un identificador sin comillas y devuelve el identificador en un formato entre comillas. Renueva la informacin de esquema de la base de datos utilizada para generar sentencias INSERT, UPDATE o DELETE.
DeriveParameters
Dispose (heredado de Component) Equals (heredado de Object) GetDeleteCommand
GetInsertCommand
InitializeLifetimeService (heredado de MarshalByRefObject) QuoteIdentifier
RefreshSchema
3-76
UnquoteIdentifier
Acepta un identificador entre comillas y devuelve el identificador en un formato sin comillas. Devuelve una String que representa el Object actual.
Mtodos protegidos
Dispose Sobrecargado. Alterado temporalmente. Libera los recursos que el IfxCommandBuilder utiliza. Sobrecargado. Devuelve el nombre completo del parmetro utilizando el nombre parcial del parmetro. Devuelve el espacio reservado para el parmetro en la correspondiente sentencia de SQL. Devuelve un objeto que representa un servicio proporcionado por el Component o por su Container. Crea una copia superficial del Object actual. MemberwiseClone (heredado de Object) SetRowUpdatingHandler Registra el IfxCommandBuilder que debe gestionar el suceso RowUpdating para un IfxDataAdapter.
GetParameterName
GetParameterPlaceholder
Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommandBuilder.ApplyParameterInfo: Sobrecargado. Asigna un valor a la propiedad DbParameter.DbType utilizando el tipo de datos de DataRow. Para uso interno de DbCommandBuilder. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Sub ApplyParameterInfo( _ ByVal p As DbParameter, _ ByVal row As DataRow, _ ByVal st As StatementType, _ ByVal whereClause As Boolean _
3-77
) [C#] public static void ApplyParameterInfo( DbParameter p, DataRow row, StatementType st, boolwhereClause ); [C++] public: static void ApplyParameterInfo( DbParameter p, DataRow row, StatementType st, boolwhereClause); [JScript] public static function ApplyParameterInfo( p : DbParameter, _ row : DataRow, _ st : StatementType, _ whereClause : Boolean );
Parmetros p row st DbParameter al que se aplica el cambio del tipo de datos. DataRow de la tabla de esquema que GetSchemaTable proporciona. Tipo de mandato que se genera: INSERT, UPDATE o DELETE.
whereClause true si el parmetro forma parte de la clusula WHERE de actualizacin o supresin. false si forma parte de los valores de insercin o actualizacin. Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommandBuilder.DeriveParameters: Recupera informacin sobre los parmetros del procedimiento almacenado especificado en el IfxCommand y llena la coleccin Parameters del objeto IfxCommand especificado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-78
Sintaxis
Visual Basic] Public Shared Sub DeriveParameters( _ ByVal command As IfxCommand _ ) [C#] public static void DeriveParameters( IfxCommand command ); [C++] public: static void DeriveParameters( IfxCommand * command ); [JScript] public static function DeriveParameters( command : IfxCommand );
Parmetros command IfxCommand que hace referencia al procedimiento almacenado a partir del cual debe obtenerse la informacin sobre los parmetros. Los parmetros obtenidos se aaden a la coleccin IfxCommand.Parameters de IfxCommand. Excepciones
Tipo de excepcin ArgumentException InvalidOperationException El controlador subyacente no da soporte a la informacin sobre los parmetros del procedimiento almacenado que se devuelve, el texto del mandato no es un nombre de procedimiento almacenado vlido o la especificacin de CommandType no es CommandType.StoredProcedure. Condicin
Comentarios DeriveParameters sobregraba cualquier informacin de parmetros existente para el IfxCommand. Slo puede utilizar DeriveParameters con procedimientos almacenados. CommandText debe contener el nombre del procedimiento almacenado y CommandType debe establecerse en CommandType.StoredProcedure. No se recomienda la utilizacin de DeriveParameters en un procedimiento almacenado sobrecargado, debido a que se devuelven todos los parmetros de todos los procedimientos de calificacin. Por omisin, DeriveParameters aade el parmetro ReturnValue a la coleccin de Parameters de IfxCommand.
3-79
DeriveParameters requiere una llamada adicional al servidor de datos para obtener la informacin. Si la informacin de parmetros se conoce anticipadamente, es ms eficaz llenar la coleccin Parameters estableciendo la informacin explcitamente. Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommandBuilder.Dispose: Libera los recursos que el IfxCommandBuilder utiliza. Lista de sobrecargas
Nombre Dispose(Boolean) Descripcin Libera los recursos no gestionados y, opcionalmente, los recursos gestionados que el IfxCommandBuilder utiliza. Heredado de Component.
Dispose()
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommandBuilder y, a continuacin, se deshace del mismo. Nota: [Visual Basic, C#] Este ejemplo muestra cmo utilizar una de las versiones sobrecargadas de Dispose. Para obtener otros ejemplos que pudieran estar disponibles, consulte los temas de sobrecarga individuales.
Visual Basic] Public Sub IfxCommandBuilderHereAndGone() Dim myCommandBuilder As New IfxCommandBuilder() myCommandBuilder.Dispose() End Sub [C#] public void IfxCommandBuilderHereAndGone() { IfxCommandBuilder myCommandBuilder = new IfxCommandBuilder(); myCommandBuilder.Dispose(); }
Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-80
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommandBuilder.Dispose (Boolean): Libera los recursos no gestionados y, opcionalmente, los gestionados que IfxCommandBuilder utiliza. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overrides Overloads Protected Sub Dispose( _ ByVal disposing As Boolean _ ) [C#] protected override void Dispose( bool disposing ); [C++] protected: void Dispose( bool disposing ); [JScript] protected override function Dispose( disposing : Boolean );
Parmetros disposing true para liberar tanto los recursos gestionados como los no gestionados; false para liberar slo los recursos no gestionados. Comentarios El mtodo pblico Dispose llama a este mtodo. Dispose() invoca al mtodo protegido Dispose(Boolean) con el parmetro disposing establecido en true. Cuando el parmetro disposing es true, el mtodo libera todos los recursos retenidos por cualquier objetos gestionado referenciado por este IfxCommand. Lo hace invocando el mtodo Dispose() de cada objeto referenciado. Notas para los herederos: Otros objetos pueden llamar varias veces a Dispose. Al alterar temporalmente Dispose(Boolean), tenga cuidado de no hacer referencia a objetos que se hayan desechado anteriormente en una llamada previa a Dispose. Para obtener ms informacin sobre cmo implementar Dispose(Boolean), consulte Implementacin del mtodo Dispose en la documentacin del SDK de Microsoft(R) .NET.
3-81
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommandBuilder y, a continuacin, se deshace del mismo.
Visual Basic] Public Sub IfxCommandBuilderHereAndGone() Dim myCommandBuilder As New IfxCommandBuilder() myCommandBuilder.Dispose() End Sub [C#] public void IfxCommandBuilderHereAndGone() { IfxCommandBuilder myCommandBuilder = new IfxCommandBuilder(); myCommandBuilder.Dispose(); }
Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommandBuilder.Dispose en la pgina 3-80 Libera los recursos que el IfxCommandBuilder utiliza. Mtodo IfxCommandBuilder.GetDeleteCommand: Obtiene el objeto IfxCommand generado automticamente necesario para realizar supresiones en la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetDeleteCommand() As IfxCommand [C#] public IfxCommand GetDeleteCommand(); [C++] public: IfxCommand * GetDeleteCommand(); [JScript] public function GetDeleteCommand() : IfxCommand ;
Valor de retorno Objeto IfxCommand generado automticamente necesario para realizar supresiones.
3-82
Comentarios Puede utilizar el mtodo GetDeleteCommand con fines informativos o para la resolucin de problemas, pues devuelve el objeto IfxCommand que se debe ejecutar. Tambin puede utilizar GetDeleteCommand como base de un mandato modificado. Por ejemplo, puede invocar GetDeleteCommand y modificar el valor de IfxCommand.CommandTimeout y, a continuacin, establecerlo explcitamente en IfxDataAdapter. Despus de generar por primera vez la sentencia de SQL, debe invocar explcitamente RefreshSchema si ello cambiar la sentencia de algn modo. De lo contrario, GetDeleteCommand seguir utilizando la informacin de la sentencia anterior, que podra no ser correcta. Las sentencias de SQL se generan por primera vez cuando la aplicacin llama a Update o a GetDeleteCommand. Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbDatAdp.cs DbDatAdp.vb DbDatMap.cs DbDatMap.vb Mtodo IfxCommandBuilder.GetInsertCommand: Obtiene el objeto IfxCommand generado automticamente necesario para realizar inserciones en la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetInsertCommand() As IfxCommand [C#] public IfxCommand GetInsertCommand(); [C++] public: IfxCommand
3-83
* GetInsertCommand(); [JScript] public function GetInsertCommand() : IfxCommand ;
Valor de retorno Objeto IfxCommand generado automticamente necesario para realizar inserciones. Comentarios Puede utilizar el mtodo GetInsertCommand con fines informativos o para la resolucin de problemas, pues devuelve el objeto IfxCommand que se debe ejecutar. Tambin puede utilizar GetInsertCommand como base de un mandato modificado. Por ejemplo, puede invocar GetInsertCommand y modificar el valor de IfxCommand.CommandTimeout y, a continuacin, establecerlo explcitamente en IfxDataAdapter. Despus de generar por primera vez la sentencia de SQL, debe invocar explcitamente RefreshSchema si ello cambiar la sentencia de algn modo. De lo contrario, GetInsertCommand seguir utilizando la informacin de la sentencia anterior, que podra no ser correcta. Las sentencias de SQL se generan por primera vez cuando la aplicacin llama a Update o a GetInsertCommand. Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbDatAdp.cs DbDatAdp.vb DbDatMap.cs DbDatMap.vb Mtodo IfxCommandBuilder.GetParameterName: Devuelve el nombre completo del parmetro especificado. Lista de sobrecargas
GetParameterName(int) GetParameterName(string) Devuelve el nombre del parmetro especificado por el valor ordinal. Devuelve el nombre completo del parmetro utilizando el nombre parcial del parmetro.
Consulta
3-84
Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommandBuilder.GetParameterName(int): Devuelve el nombre del parmetro especificado por el valor ordinal. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function GetParameterName ( _ parmOrdinal As Integer _ ) As String [C#] public override string GetParameterName (int parmOrdinal) [C++] public: virtual String^ GetParameterName (int parmOrdinal) override [JScript] public override function GetParameterName (parmOrdinal : int) : String
Parmetros parmOrdinal Entero que representa un ordinal de columna. Valor de retorno Nombre del parmetro, con el ordinal de columna aadido al nombre. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommandBuilder.GetParameterName(string): Devuelve el nombre completo del parmetro utilizando el nombre parcial del parmetro.
3-85
Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis

Visual Basic] Public Overrides Function GetParameterName ( _ parameterName As String _ ) As String [C#] public override string GetParameterName (string parameterName) [C++] public: virtual String^ GetParameterName (String^ parameterName) override [JScript] public override function GetParameterName (parameterName : String) : String
Parmetros parameterName Serie de caracteres que representa un fragmento del nombre del parmetro. Valor de retorno El nombre del parmetro. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommandBuilder.GetParameterPlaceholder: Devuelve el espacio reservado para el parmetro en la correspondiente sentencia de SQL. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function GetParameterPlaceholder ( _ parmOrdinal As Integer _ ) As String [C#] public override string GetParameterPlaceholder (int parmOrdinal)
3-86
[C++] public: virtual String^ GetParameterPlaceholder (int parmOrdinal) override [JScript] public override function GetParameterPlaceholder (parmOrdinal : int) : String
Parmetros parmOrdinal Entero que representa un ordinal de columna. Valor de retorno El espacio reservado para el parmetro es ?. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommandBuilder.GetUpdateCommand: Obtiene el objeto IfxCommand generado automticamente necesario para realizar actualizaciones en la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetUpdateCommand() As IfxCommand [C#] public IfxCommand GetUpdateCommand(); [C++] public: IfxCommand * GetUpdateCommand(); [JScript] public function GetUpdateCommand() : IfxCommand ;
Valor de retorno Objeto IfxCommand generado automticamente necesario para realizar actualizaciones.
3-87
Comentarios Puede utilizar el mtodo GetUpdateCommand con fines informativos o para la resolucin de problemas, pues devuelve el objeto IfxCommand que se debe ejecutar. Tambin puede utilizar GetUpdateCommand como base de un mandato modificado. Por ejemplo, puede invocar GetUpdateCommand y modificar el valor de IfxCommand.CommandTimeout y, a continuacin, establecerlo explcitamente en IfxDataAdapter. Despus de generar por primera vez la sentencia de SQL, debe invocar explcitamente RefreshSchema si ello cambiar la sentencia de algn modo. De lo contrario, GetUpdateCommand seguir utilizando la informacin de la sentencia anterior, que podra no ser correcta. Las sentencias de SQL se generan por primera vez cuando la aplicacin llama a Update o a GetUpdateCommand. Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbDatAdp.cs DbDatAdp.vb DbDatMap.cs DbDatMap.vb Mtodo IfxCommandBuilder.QuoteIdentifier: Acepta un identificador sin comillas y devuelve el identificador en un formato entre comillas. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function QuoteIdentifier ( _ unquotedIdentifier As String _ ) As String [C#] public override string QuoteIdentifier ( string unquotedIdentifier ) [C++] public: virtual String^ QuoteIdentifier (
3-88
String^ unquotedIdentifier ) override [JScript] public override function QuoteIdentifier ( unquotedIdentifier : String ) : String
Parmetros unquotedIdentifier Serie de caracteres con el identificador en un formato sin comillas. Valor de retorno Serie de caracteres con el identificador en un formato entre comillas. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommandBuilder.RefreshSchema: Renueva la informacin de esquema de la base de datos utilizada para generar sentencias INSERT, UPDATE o DELETE. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub RefreshSchema() [C#] public void RefreshSchema(); [C++] public: void RefreshSchema(); [JScript] public function RefreshSchema();
Comentarios Debe llamarse a RefreshSchema cada vez que cambie el valor IfxDataAdapter.SelectCommand de IfxDataAdapter. Consulta
3-89
Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommandBuilder.SetRowUpdatingHandler: Registra el IfxCommandBuilder que debe gestionar el suceso RowUpdating para un IfxDataAdapter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Sub SetRowUpdatingHandler (adapter As DbDataAdapter) [C#] public override void SetRowUpdatingHandler (DbDataAdapter adapter) [C++] public: virtual void SetRowUpdatingHandler (DbDataAdapter adapter) override [JScript] public override function SetRowUpdatingHandler (adapter : DbDataAdapter)
Parmetros adapter IfxDataAdapter (o IfxDataAdapter) que debe utilizarse para la operacin de actualizacin. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommandBuilder.UnquoteIdentifier: Acepta un identificador entre comillas y devuelve el identificador en un formato sin comillas.
3-90

Visual Basic] Public Overrides Function UnquoteIdentifier ( _ quotedIdentifier As String _ ) As String [C#] public override string UnquoteIdentifier ( string quotedIdentifier ) [C++] public: virtual String^ UnquoteIdentifier ( String^ quotedIdentifier ) override [JScript] public override function UnquoteIdentifier ( quotedIdentifier : String ) : String
Parmetros unquotedIdentifier Serie de caracteres con el identificador en un formato entre comillas. Valor de retorno Serie de caracteres con el identificador en un formato sin comillas. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxCommandBuilder
Las propiedades de la clase IfxCommandBuilder se listan a continuacin.
Propiedades pblicas
CatalogLocation Obtiene la CatalogLocation para esta instancia de IfxCommandBuilder.
3-91
CatalogSeparator
Obtiene la serie de caracteres que representa un separador de catlogo para esta instancia de IfxCommandBuilder. Obtiene el IContainer que contiene el Component. Obtiene o establece un objeto IfxDataAdapter para el cual este objeto IfxCommandBuilder generar sentencias de SQL. Obtiene o establece el carcter inicial o caracteres iniciales que se deben utilizar al trabajar con objetos de base de datos (por ejemplo, tablas o columnas) cuyos nombres contienen caracteres tales como espacios o smbolos reservados. Obtiene o establece el carcter final o caracteres finales que se deben utilizar al trabajar con objetos de base de datos (por ejemplo, tablas o columnas) cuyos nombres contienen caracteres tales como espacios o smbolos reservados. Obtiene la serie de caracteres que representa un separador de esquema para esta instancia de IfxCommandBuilder. Obtiene o establece el ISite de Component.
Container (heredada de Component) DataAdapter
QuotePrefix
QuoteSuffix
SchemaSeparator
Site (heredada de Component)
Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommandBuilder.CatalogLocation: Obtiene la CatalogLocation para esta instancia de IfxCommandBuilder. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-92
Sintaxis
Visual Basic] Public Overrides Property CatalogLocation As CatalogLocation [C#] public override CatalogLocation CatalogLocation { get; set; } [C++] public: virtual property CatalogLocation CatalogLocation { CatalogLocation get () override; void set (CatalogLocation value) override; } [JScript] public override function get CatalogLocation () : CatalogLocation public override function set CatalogLocation (value : CatalogLocation)
Valor de la propiedad Devuelve CatalogLocation.Start. Excepciones

Tipo de excepcin System.NotSupportedException Condicin Se ha intentado establecer la propiedad CatalogLocation.
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommandBuilder.CatalogSeparator: Obtiene la serie de caracteres que representa un separador de catlogo para esta instancia de IfxCommandBuilder. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Property CatalogSeparator As String [C#] public override string CatalogSeparator { get; set; } [C++]
3-93
public: virtual property String^ CatalogSeparator { String^ get () override; void set (String^ value) override; } [JScript] public override function get CatalogSeparator () : String public override function set CatalogSeparator (value : String)
Valor de la propiedad El valor de la serie de caracteres para la propiedad CatalogSeparator es .. Para Informix Dynamic Server, el valor de la serie de caracteres es :. Excepciones
Tipo de excepcin System.NotSupportedException Condicin Se ha intentado establecer la propiedad CatalogSeparator.
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommandBuilder.DataAdapter: Obtiene o establece un objeto IfxDataAdapter para el cual este objeto IfxCommandBuilder generar sentencias de SQL. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property DataAdapter As IfxDataAdapter [C#] public IfxDataAdapter DataAdapter {get; set;} [C++] public: __property IfxDataAdapter * get_DataAdapter(); public: __property void set_DataAdapter(IfxDataAdapter
3-94
*); [JScript] public function get DataAdapter() : IfxDataAdapter ; public function set DataAdapter(IfxDataAdapter );
Valor de la propiedad Objeto IfxDataAdapter que est asociado con este IfxCommandBuilder. Comentarios IfxCommandBuilder se registra a s mismo como escucha para los sucesos de IfxDataAdapter.RowUpdating que genera el IfxDataAdapter especificado en esta propiedad. Cuando se crea una nueva instancia de IfxCommandBuilder, se libera cualquier IfxCommandBuilder existente que est asociado con este IfxDataAdapter. Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbDatAdp.cs DbDatAdp.vb Propiedad IfxCommandBuilder.QuotePrefix: Obtiene o establece el carcter inicial o caracteres iniciales que se deben utilizar al trabajar con objetos de base de datos (por ejemplo, tablas o columnas) cuyos nombres contienen caracteres tales como espacios o smbolos reservados. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property QuotePrefix As String [C#] public string QuotePrefix {get; set;} [C++] public: __property String* get_QuotePrefix(); public: __property void set_QuotePrefix(String*); [JScript] public function get QuotePrefix() : String; public function set QuotePrefix(String);
3-95
Valor de la propiedad El carcter o los caracteres iniciales que se van a utilizar. El valor por omisin es una serie de caracteres vaca. Excepciones
Tipo de excepcin InvalidOperationException Condicin Esta propiedad no se puede cambiar despus de generar un mandato de insercin, actualizacin o supresin.
Comentarios Algunas bases de datos pueden contener objetos cuyos nombres incluyen caracteres tales como espacios, comas y puntos y comas. Para dar cabida a esos caracteres, utilice las propiedades QuotePrefix y QuoteSuffix para especificar delimitadores, tales como corchetes de apertura y de cierre, que servirn para encapsular el nombre del objeto. Nota: Aunque no puede cambiar las propiedades QuotePrefix o QuoteSuffix una vez se haya generado un mandato de insercin, actualizacin o supresin, puede cambiar los valores de los mismos despus de invocar el mtodo Update de un IfxDataAdapter. Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommandBuilder.QuoteSuffix: Obtiene o establece el carcter final o caracteres finales que se deben utilizar al trabajar con objetos de base de datos (por ejemplo, tablas o columnas) cuyos nombres contienen caracteres tales como espacios o smbolos reservados. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property QuoteSuffix As String [C#] public string QuoteSuffix {get; set;} [C++] public: __property String* get_QuoteSuffix();
3-96
public: __property void set_QuoteSuffix(String*); [JScript] public function get QuoteSuffix() : String; public function set QuoteSuffix(String);
Valor de la propiedad El carcter o los caracteres finales que se van a utilizar. El valor por omisin es una serie de caracteres vaca. Excepciones
Tipo de excepcin InvalidOperationException Condicin Esta propiedad no se puede cambiar despus de generar un mandato de insercin, actualizacin o supresin.
Comentarios Algunas bases de datos pueden contener objetos cuyos nombres incluyen caracteres tales como espacios, comas y puntos y comas. Para dar cabida a esos caracteres, utilice las propiedades QuotePrefix y QuoteSuffix para especificar delimitadores, tales como corchetes de apertura y de cierre, que servirn para encapsular el nombre del objeto. Nota: Aunque no puede cambiar las propiedades QuotePrefix o QuoteSuffix una vez se haya generado una operacin de insercin, actualizacin o supresin, puede cambiar los valores de los mismos despus de invocar el mtodo Update de un IfxDataAdapter. Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommandBuilder.SchemaSeparator: Obtiene la serie de caracteres que representa un separador de esquema para esta instancia de IfxCommandBuilder. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Property SchemaSeparator As String [C#]
3-97
public override string SchemaSeparator { get; set; } [C++] public: virtual property String^ SchemaSeparator { String^ get () override; void set (String^ value) override; } [JScript] public override function get SchemaSeparator () : String public override function set SchemaSeparator (value : String)
Valor de la propiedad El valor de la serie de caracteres para la propiedad SchemaSeparator es siempre .. Excepciones
Tipo de excepcin System.NotSupportedException Condicin Se ha intentado establecer la propiedad SchemaSeparator.
Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxCommandBuilder en la pgina 3-68 Genera automticamente mandatos de una sola tabla utilizados para reconciliar cambios realizados en un DataSet con la base de datos asociada. Miembros de IfxCommandBuilder en la pgina 3-71 Miembros de IfxCommandBuilder Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxCommand
Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)

System.Object System.MarshalByRefObject System.ComponentModel.Component IBM.Data.Informix.IfxCommand
3-98

System.Object System.MarshalByRefObject System.ComponentModel.Component System.Data.Common.DbCommand IBM.Data.Informix.IfxCommand

Visual Basic] NotInheritable Public Class IfxCommand Inherits Component Implements ICloneable, IDbCommand [C#] public sealed class IfxCommand : Component, ICloneable, IDbCommand [C++] public __gc __sealed class IfxCommand : public Component, ICloneable, IDbCommand [JScript] public class IfxCommand extends Component implements ICloneable, IDbCommand

Visual Basic] NotInheritable Public Class IfxCommand Inherits DbCommand Implements ICloneable [C#] public sealed class IfxCommand : DbCommand, ICloneable [C++] public __gc __sealed class IfxCommand : public DbCommand, ICloneable [JScript] public class IfxCommand extends DbCommand implements ICloneable
Comentarios
La clase IfxCommand proporciona los mtodos siguientes para la ejecucin de mandatos contra una base de datos:
Elemento ExecuteReader ExecuteResultSet ExecuteNonQuery ExecuteScalar Descripcin Ejecuta mandatos que devuelven filas. Enva CommandText a la Connection y crea un DB2ResultSet. Ejecuta mandatos tales como sentencias INSERT, DELETE, UPDATE y SET de SQL. Recupera un solo valor (por ejemplo, un valor agregado) de una base de datos.
Si la ejecucin del mandato produce una excepcin IfxException muy grave, es posible que IfxConnection se cierre. Sin embargo, el usuario puede reabrir la conexin y continuar.
3-99
Ejemplo
[Visual Basic, C#] El ejemplo siguiente utiliza el mtodo ExecuteReader de IfxCommand, junto con IfxDataReader y IfxConnection para seleccionar filas de una tabla.
[Visual Basic] Public Sub ReadMyData(myConnString As String) Dim mySelectQuery As String = "SELECT SALES, SALES_PERSON FROM SALES" Dim myConnection As New IfxConnection(myConnString) Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myConnection.Open() Dim myReader As IfxDataReader = myCommand.ExecuteReader() Try While myReader.Read() Console.WriteLine(myReader.GetInt32(0).ToString() + ", " _ + myReader.GetString(1)) End While Finally always call Close when done reading. myReader.Close() always call Close when done with connection. myConnection.Close() End Try End Sub [C#] public void ReadMyData(string myConnString) { string mySelectQuery = "SELECT SALES, SALES_PERSON FROM SALES"; IfxConnection myConnection = new IfxConnection(myConnString); IfxCommand myCommand = new IfxCommand(mySelectQuery,myConnection); myConnection.Open(); IfxDataReader myReader = myCommand.ExecuteReader(); try { while (myReader.Read()) { Console.WriteLine(myReader.GetInt32(0) + ", " + myReader.GetString(1)); } } finally { // always call Close when done reading. myReader.Close(); // always call Close when done with connection. myConnection.Close(); } }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand
3-100
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Ejemplos DbUse.cs DbUse.cs TbUse.cs TbUse.vb
Miembros de IfxCommand
Visin general de IfxCommand
IfxCommand Sobrecargado. Inicializa una nueva instancia de la clase IfxCommand.
Propiedades pblicas
CommandText Obtiene o establece la sentencia de SQL, expresin de o procedimiento almacenado que se debe ejecutar contra la base de datos. Obtiene o establece el tiempo de espera antes de finalizar la ejecucin de un mandato y generar un error. Obtiene o establece un valor que indica cmo se interpreta la propiedad CommandText. Obtiene o establece la IfxConnection utilizada por esta instancia de IfxCommand. Obtiene el IContainer que contiene el Component. Determina si los valores del parmetro de solo salida asociados con IfxCommand se devolvern como tipos de datos DB2 nativos (especialmente, clases y estructuras en el espacio de nombres IBM.Data.IfxTypes). Obtiene o establece la DbConnection utilizada por esta instancia de IfxCommand. Obtiene el objeto DbParameterCollection. DbParameterCollection DbTransaction Obtiene o establece la DbTransaction dentro de la cual se ejecuta IfxCommand.
CommandTimeout
CommandType
Connection Container (heredada de Component) IfxTypeOutput
DbConnection
3-101
DesignTimeVisible
Obtiene o establece un valor booleano que indica si un IfxCommand generado por un adaptador de datos es visible. Obtiene IfxParameterCollection.
Parameters Obtiene o establece el ISite de Component. Site (heredada de Component) Transaction UpdatedRowSource Obtiene o establece la IfxTransaction dentro de la cual se ejecuta IfxCommand. Obtiene o establece un valor que especifica cmo el mtodo Update debe aplicar resultados de mandato a DataRow.
Mtodos pblicos
Cancel CreateObjRef (heredado de MarshalByRefObject) Intenta cancelar la ejecucin de IfxCommand. Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Crea una nueva instancia de un objeto IfxParameter. Alterado temporalmente. Libera los recursos utilizados por Component. Alterado temporalmente. Determina si dos instancias de Object son iguales. Ejecuta una sentencia de SQL en Connection y devuelve el nmero de filas afectadas. Devuelve una instancia de IfxDataReader que contiene un conjunto de filas solicitado. Sobrecargado. Enva el CommandText a la Connection y crea un IfxDataReader. Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta. Las columnas o filas extra se ignoran. Sobrecargado. Enva el CommandText a la Connection y crea un IfxResultSet. Enva el CommandText a la Connection y crea un IfxRecord. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia.
CreateParameter Dispose (heredado de Component) Equals (heredado de Object) ExecuteNonQuery ExecutePageReader ExecuteReader ExecuteScalar
ExecuteResultSet ExecuteRow GetHashCode (heredado de Object)
3-102
Obtiene el Type de la instancia actual. GetType (heredado de Object) InitializeLifetimeService (heredado de MarshalByRefObject) Prepare ResetCommandTimeout ToString (heredado de Object) Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Crea una versin preparada (o compilada) del mandato en la base de datos. Restablece la propiedad CommandTimeout en el valor por omisin. Devuelve una String que representa el Object actual.
Sucesos pblicos
Disposed (heredado de Component) Aade un manejador de sucesos para escuchar al suceso Disposed en el componente.
Mtodos protegidos
CreateDbParameter Dispose Crea una nueva instancia de un objeto DbParameter. Sobrecargado. Alterado temporalmente. Libera los recursos utilizados por IfxCommand. Enva CommandText a Connection y crea un objeto DbDataReader. Alterado temporalmente. Permite que un Object intente liberar recursos y realizar otras operaciones de limpieza antes de que el Object sea reclamado para la recopilacin de basura. En C# y Microsoft(R) Visual C++(R), los finalizadores se expresan utilizando sintaxis de destructor. GetService (heredado de Component) Devuelve un objeto que representa un servicio proporcionado por el Component o por su Container. Crea una copia superficial del Object actual. MemberwiseClone (heredado de Object)
ExecuteDbDataReader Finalize (heredado de Object)
3-103
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Constructor de IfxCommand
Inicializa una nueva instancia de la clase IfxCommand.
Nombre IfxCommand() IfxCommand(String) IfxCommand(String, IfxConnection) Descripcin Inicializa una nueva instancia de la clase IfxCommand. Inicializa una nueva instancia de la clase IfxCommand con el texto de la consulta. Inicializa una nueva instancia de la clase IfxCommand con el texto de la consulta y un objeto DB2Connection. Inicializa una nueva instancia de la clase IfxCommand con el texto de la consulta, un objeto DB2Connection y Transaction.
IfxCommand(String, IfxConnection, IfxTransaction)
Ejemplo
[Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y establece algunas de sus propiedades. Nota: [Visual Basic, C#] Este ejemplo muestra cmo utilizar una de las versiones sobrecargadas del constructor de IfxCommand. Para obtener otros ejemplos que pudieran estar disponibles, consulte los temas de sobrecarga individuales.
[Visual Basic] Public Sub CreateMyIfxCommand() Dim myConnection As New IfxConnection _ ("DATABASE=SAMPLE") myConnection.Open() Dim myTrans As IfxTransaction = myConnection.BeginTransaction() Dim mySelectQuery As String = _ "SELECT * FROM EMPLOYEE ORDER BY EMPNO" Dim myCommand As New IfxCommand(mySelectQuery, myConnection, myTrans) myCommand.CommandTimeout = 20 End Sub [C#] public void CreateMyIfxCommand() { IfxConnection myConnection = new IfxConnection("DATABASE=SAMPLE"); myConnection.Open(); IfxTransaction myTrans = myConnection.BeginTransaction();
3-104
string mySelectQuery = "SELECT * FROM EMPLOYEE ORDER BY EMPNO"; IfxCommand myCommand = new IfxCommand(mySelectQuery, myConnection,myTrans); myCommand.CommandTimeout = 20; }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxCommand (): Inicializa una nueva instancia de la clase IfxCommand. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New() [C#] public IfxCommand(); [C++] public: IfxCommand(); [JScript] public function IfxCommand();
Comentarios El constructor base inicializa todos los campos en sus valores por omisin. La tabla siguiente muestra los valores iniciales de las propiedades para una instancia de IfxCommand.
Propiedades CommandText CommandTimeout CommandType Connection Valor inicial serie vaca () 30 Texto nulo
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y define algunas de sus propiedades.
Visual Basic] Public Sub CreateMyIfxCommand() Dim myCommand As New IfxCommand() myCommand.CommandTimeout = 20
3-105
End Sub [C#] public void CreateMyIfxCommand() { IfxCommand myCommand = new IfxCommand(); myCommand.CommandTimeout = 20; }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxCommand en la pgina 3-104 Inicializa una nueva instancia de la clase IfxCommand. Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Constructor de IfxCommand (String): Inicializa una nueva instancia de la clase IfxCommand con el texto de la consulta. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ ByVal cmdText As String _ ) [C#] public IfxCommand( string cmdText ); [C++] public: IfxCommand( String* cmdText ); [JScript] public function IfxCommand( cmdText : String );
Parmetros cmdText El texto de la consulta.
3-106
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y define algunas de sus propiedades.
Visual Basic] Public Sub CreateMyIfxCommand() Dim mySelectQuery As String = "SELECT * FROM EMPLOYEE ORDER BY EMPNO" Dim myCommand As New IfxCommand(mySelectQuery) myCommand.CommandTimeout = 20 End Sub [C#] public void CreateMyIfxCommand() { string mySelectQuery = "SELECT * FROM EMPLOYEE ORDER BY EMPNO"; IfxCommand myCommand = new IfxCommand(mySelectQuery); myCommand.CommandTimeout = 20; }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxCommand en la pgina 3-104 Inicializa una nueva instancia de la clase IfxCommand. Constructor de IfxCommand (String, IfxConnection): Inicializa una nueva instancia de la clase IfxCommand con el texto de la consulta y el objeto IfxConnection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ ByVal cmdText As String, _ ByVal connection As IfxConnection _ ) [C#] public IfxCommand( string cmdText, IfxConnection connection ); [C++] public: IfxCommand( String* cmdText, IfxConnection * connection ); [JScript]
3-107
public function IfxCommand( cmdText : String, connection : IfxConnection );
Parmetros cmdText El texto de la consulta. connection Objeto IfxConnection que representa una conexin abierta a un servidor de datos. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y establece algunas de sus propiedades.
Visual Basic] Public Sub CreateMyIfxCommand() Dim myConnection As New IfxConnection _ ("DATABASE=SAMPLE;") Dim mySelectQuery As String = _ "SELECT * FROM EMPLOYEE ORDER BY EMPNO" Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myCommand.CommandTimeout = 20 End Sub [C#] public void CreateMyIfxCommand() { IfxConnection myConnection = new IfxConnection("DATABASE=SAMPLE;"); string mySelectQuery = "SELECT * FROM EMPLOYEE ORDER BY EMPNO"; IfxCommand myCommand = new IfxCommand(mySelectQuery, myConnection); myCommand.CommandTimeout = 20; }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxCommand en la pgina 3-104 Inicializa una nueva instancia de la clase IfxCommand. Constructor de IfxCommand (String, IfxConnection, IfxTransaction): Inicializa una nueva instancia de la clase IfxCommand con el texto de la consulta, un objeto IfxConnection y Transaction. Espacio de nombres: IBM.Data.Informix
3-108

Visual Basic] Public Sub New( _ ByVal cmdText As String, _ ByVal connection As IfxConnection , _ ByVal transaction As IfxTransaction _ ) [C#] public IfxCommand( string cmdText, IfxConnection connection, IfxTransaction transaction ); [C++] public: IfxCommand( String* cmdText, IfxConnection* connection, IfxTransaction* transaction ); [JScript] public function IfxCommand( cmdText : String, connection : IfxConnection, transaction : IfxTransaction );
Parmetros cmdText El texto de la consulta. connection Objeto IfxConnection que representa una conexin abierta a un servidor de datos. transaction La transaccin en la que DB2Command se ejecuta. Comentarios La tabla siguiente muestra los valores iniciales de las propiedades para una instancia de esta implementacin de IfxCommand.
Propiedades CommandText CommandTimeout CommandType Connection Valor inicial cmdText 30 Texto Nueva IfxConnection que es el valor del parmetro connection.
Puede cambiar el valor de cualquiera de estos parmetros definiendo la propiedad asociada.
3-109
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y establece algunas de sus propiedades.
Visual Basic] Public Sub CreateMyIfxCommand() Dim myConnection As New IfxConnection _ ("DATABASE=SAMPLE;") myConnection.Open() Dim myTrans As IfxTransaction = myConnection.BeginTransaction() Dim mySelectQuery As String = _ "SELECT * FROM EMPLOYEE ORDER BY EMPNO" Dim myCommand As New IfxCommand(mySelectQuery, myConnection, myTrans) myCommand.CommandTimeout = 20 End Sub [C#] public void CreateMyIfxCommand() { IfxConnection myConnection = new IfxConnection("DATABASE=SAMPLE;"); myConnection.Open(); IfxTransaction myTrans = myConnection.BeginTransaction(); string mySelectQuery = "SELECT * FROM EMPLOYEE ORDER BY EMPNO"; IfxCommand myCommand = new IfxCommand(mySelectQuery, myConnection,myTrans); myCommand.CommandTimeout = 20; }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxCommand en la pgina 3-104 Inicializa una nueva instancia de la clase IfxCommand.
Mtodos de IfxCommand
Los mtodos de la clase IfxCommand se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxCommand, consulte el tema Miembros de IfxCommand.
Mtodos pblicos
Cancel CreateObjRef (heredado de MarshalByRefObject) Intenta cancelar la ejecucin de IfxCommand. Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Crea una nueva instancia de un objeto IfxParameter.
CreateParameter
3-110
Dispose (heredado de Component) Equals (heredado de Object) ExecuteNonQuery ExecutePageReader ExecuteReader ExecuteScalar
Alterado temporalmente. Libera los recursos utilizados por Component. Alterado temporalmente. Determina si dos instancias de Object son iguales. Ejecuta una sentencia de SQL en Connection y devuelve el nmero de filas afectadas. Devuelve una instancia de IfxDataReader que contiene un conjunto de filas solicitado. Sobrecargado. Enva el CommandText a la Connection y crea un IfxDataReader. Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta. Las columnas o filas extra se ignoran. Sobrecargado. Enva el CommandText a la Connection y crea un IfxResultSet. Enva el CommandText a la Connection y crea un IfxRecord. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el Type de la instancia actual.
ExecuteResultSet ExecuteRow GetHashCode (heredado de Object)
GetLifetimeService (heredado de MarshalByRefObject) GetType (heredado de Object) InitializeLifetimeService (heredado de MarshalByRefObject) Prepare ResetCommandTimeout ToString (heredado de Object)
Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Crea una versin preparada (o compilada) del mandato en la base de datos. Restablece la propiedad CommandTimeout en el valor por omisin. Devuelve una String que representa el Object actual.
Mtodos protegidos
CreateDbParameter Dispose Crea una nueva instancia de un objeto DbParameter. Sobrecargado. Alterado temporalmente. Libera los recursos utilizados por IfxCommand. Enva CommandText a Connection y crea un objeto DbDataReader.
ExecuteDbDataReader
3-111
Finalize (heredado de Object)
Alterado temporalmente. Permite que un Object intente liberar recursos y realizar otras operaciones de limpieza antes de que el Object sea reclamado para la recopilacin de basura. En C# y Microsoft(R) Visual C++(R), los finalizadores se expresan utilizando sintaxis de destructor.
Devuelve un objeto que representa un servicio proporcionado por el Component o por su Container. Crea una copia superficial del Object actual.
MemberwiseClone (heredado de Object)
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.Cancel: Intenta cancelar la ejecucin de IfxCommand. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Public Sub Cancel() [C#] public void Cancel(); [C++] public: __sealed void Cancel(); [JScript] public function Cancel();
Comentarios Si no hay nada que cancelar, no sucede nada. Sin embargo, si existe un mandato en proceso y el intento de cancelarlo falla, no se genera ninguna excepcin. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand, lo ejecuta y, a continuacin, cancela la ejecucin. Para hacer esto, el mtodo recibe una serie de caracteres que es una sentencia SELECT de SQL, y una serie de caracteres que se utiliza para conectar con la base de datos.
3-112
Visual Basic] Public Sub CreateMyIfxCommand _ (mySelectQuery As String, myConnectionString As String) Dim myConnection As New IfxConnection(myConnectionString) Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myCommand.Connection.Open() myCommand.ExecuteReader() myCommand.Cancel() End Sub [C#] public void CreateMyIfxCommand(string mySelectQuery, string myConnectionString) { IfxConnection myConnection = new IfxConnection(myConnectionString); IfxCommand myCommand = new IfxCommand(mySelectQuery, myConnection); myCommand.Connection.Open(); myCommand.ExecuteReader(); myCommand.Cancel(); }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.CreateDbParameter: Crea una nueva instancia de un objeto DbParameter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overrides Protected Function CreateDbParameter() _ As DbParameter [C#] protected override DbParameter CreateDbParameter(); [C++] protected: DbParameter CreateDbParameter(); [JScript] protected override function CreateDbParameter() : DbParameter;
Valor de retorno Instancia de DbParameter. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0
3-113
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.CreateParameter: Crea una nueva instancia de un objeto IfxParameter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function CreateParameter() As IfxParameter [C#] public IfxParameter CreateParameter(); [C++] public: IfxParameter * CreateParameter(); [JScript] public function CreateParameter() : IfxParameter ;
Valor de retorno Un objeto IfxParameter. Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.Dispose: Libera los recursos utilizados por IfxCommand.
3-114
Nombre Dispose(Boolean) Descripcin Libera los recursos no gestionados y, opcionalmente, los recursos gestionados utilizados por el objeto DB2Command. Heredado de Component.
Dispose()
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y, a continuacin, se deshace del mismo. Nota: [Visual Basic, C#] Este ejemplo muestra cmo utilizar una de las versiones sobrecargadas de Dispose. Para obtener otros ejemplos que pudieran estar disponibles, consulte los temas de sobrecarga individuales.
Visual Basic] Public Sub IfxCommandHereAndGone() Dim myCommand As New IfxCommand() myCommand.Dispose() End Sub [C#] public void IfxCommandHereAndGone() { IfxCommand myCommand = new IfxCommand(); myCommand.Dispose(); }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.Dispose (Boolean): Libera los recursos no gestionados y, opcionalmente, los gestionados que el objeto IfxCommand utiliza. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overrides Overloads Protected Sub Dispose( _ ByVal disposing As Boolean _ ) [C#] protected override void Dispose(
3-115
bool disposing ); [C++] protected: void Dispose( bool disposing ); [JScript] protected override function Dispose( disposing : Boolean );
Parmetros disposing true para liberar tanto los recursos gestionados como los no gestionados; false para liberar slo los recursos no gestionados. Comentarios El mtodo pblico Dispose llama a este mtodo. Dispose() invoca al mtodo protegido Dispose(Boolean) con el parmetro disposing establecido en true. Cuando el parmetro disposing es true, el mtodo libera todos los recursos retenidos por cualquier objetos gestionado referenciado por este IfxCommand. Lo hace invocando el mtodo Dispose() de cada objeto referenciado. Notas para los herederos: Otros objetos pueden llamar varias veces a Dispose. Al alterar temporalmente Dispose(Boolean), tenga cuidado de no hacer referencia a objetos que se hayan desechado anteriormente en una llamada previa a Dispose. Para obtener ms informacin sobre cmo implementar Dispose(Boolean), consulte Implementacin del mtodo Dispose en la documentacin del SDK de Microsoft(R) .NET. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y despus lo desecha.
Visual Basic] Public Sub IfxCommandHereAndGone() Dim myCommand As New IfxCommand() myCommand.Dispose() End Sub [C#] public void IfxCommandHereAndGone() { IfxCommand myCommand = new IfxCommand(); myCommand.Dispose(); }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-116
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.Dispose en la pgina 3-114 Libera los recursos utilizados por IfxCommand. Mtodo IfxCommand.ExecuteDbDataReader: Enva CommandText a Connection y crea un objeto DbDataReader. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overrides Protected Function ExecuteDbDataReader( _ ByVal behavior As CommandBehavior _ ) As DbDataReader [C#] protected override DbDataReader ExecuteDbDataReader( CommandBehavior behavior ); [C++] protected: DbDataReader ExecuteDbDataReader( CommandBehavior behavior ); [JScript] protected override function ExecuteDbDataReader( behavior : CommandBehavior ) : DbDataReader;
Parmetros behavior Instancia de CommandBehavior. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.ExecuteNonQuery: Ejecuta una sentencia de SQL en Connection y devuelve el nmero de filas afectadas. Espacio de nombres: IBM.Data.Informix
3-117

Visual Basic] NotOverridable Public Function ExecuteNonQuery() As Integer [C#] public int ExecuteNonQuery(); [C++] public: __sealed int ExecuteNonQuery(); [JScript] public function ExecuteNonQuery() : int;
Valor de retorno Para sentencias UPDATE, INSERT y DELETE, el valor de retorno es el nmero de filas afectadas por el mandato. Para el resto de tipos de sentencias, el valor de retorno es -1. Comentarios Puede utilizar ExecuteNonQuery para realizar operaciones de catlogo (por ejemplo, consultar la estructura de una base de datos o crear objetos de base de datos como, por ejemplo, tablas); o para cambiar los datos de una base de datos, sin utilizar DataSet, ejecutando sentencias UPDATE, INSERT o DELETE. Tambin se puede utilizar ExecuteNonQuery para ejecutar varias sentencias de SQL. En este caso, el valor de retorno es el nmero de filas afectadas por todas las sentencias en el mandato. Aunque ExecuteNonQuery no devuelva ninguna fila, los parmetros de salida o los valores de retorno correlacionados con parmetros se rellenan con datos. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y, a continuacin, lo ejecuta utilizando ExecuteNonQuery. Al ejemplo se le pasa una serie que es una sentencia de SQL (por ejemplo UPDATE, INSERT o DELETE) y una serie para utilizarla para conectar con la base de datos.
[Visual Basic] Public Sub CreateMyIfxCommand(myExecuteQuery As String, _ myConnectionString As String) Dim myConnection As New IfxConnection(myConnectionString) Dim myCommand As New IfxCommand(myExecuteQuery, myConnection) myCommand.Connection.Open() myCommand.ExecuteNonQuery() MyConnection.Close() End Sub [C#] public void CreateMyIfxCommand(string myExecuteQuery, string myConnectionString) { IfxConnection myConnection = new IfxConnection(myConnectionString); IfxCommand myCommand = new IfxCommand(myExecuteQuery, myConnection); myCommand.Connection.Open(); myCommand.ExecuteNonQuery(); myConnection.Close(); }
Consulta
3-118
Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbUse.cs DbUse.vb Mtodo IfxCommand.ExecutePageReader: Devuelve una instancia de IfxDataReader que contiene un conjunto de filas solicitado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function ExecutePageReader( _ ByVal startRow As int, ByVal numRows As int _ ) As DataReader [C#] public DataReader ExecutePageReader( int startRow, int numRows); [C++] public: DataReader^ ExecutePageReader( int startRow, int numRows); [JScript] public function ExecutePageReader ( startRow : int, numRows : int ) : DataReader
Parmetros startRow Especifica la fila de inicio del conjunto de filas que se deben devolver. numRows Especifica el nmero total de filas que se deben devolver. Valor de retorno Devuelve una instancia de IfxDataReader que contiene un conjunto de filas solicitado. Ejemplo [C#] El ejemplo siguiente demuestra la recuperacin de un conjunto especfico de filas del conjunto de resultados. En el ejemplo, se pasa a la aplicacin un IfxDataReader que contiene las filas de la tres a la siete.
3-119
[C#] IfxCommand cmd = conn.CreateCommand(); cmd.CommandText = "SELECT * FROM SALES"; IfxDataReader dr = cmd.ExecutePageReader(3, 7);
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.ExecuteReader: Enva el CommandText a la Connection y crea un IfxDataReader. Lista de sobrecargas
Nombre ExecuteReader() ExecuteReader(CommandBehavior) Descripcin Enva el CommandText a la Connection y crea un IfxDataReader. Enva el CommandText a la Connection y crea un IfxDataReader basado en el CommandBehavior especificado.
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y ms tarde lo ejecuta pasando una serie de caracteres que es una sentencia SELECT de SQL y una serie de caracteres que se utilizar para conectar con la base de datos. A continuacin, se establece CommandBehavior en CloseConnection. Nota: [Visual Basic, C#] Este ejemplo muestra cmo utilizar una de las versiones sobrecargadas de ExecuteReader. Para obtener otros ejemplos que pudieran estar disponibles, consulte los temas de sobrecarga individuales.
[Visual Basic] Public Sub CreateMyIfxDataReader(mySelectQuery As String, _ myConnectionString As String) Dim myConnection As New IfxConnection(myConnectionString) Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myCommand.Connection.Open() Dim myReader As IfxDataReader = myCommand.ExecuteReader(CommandBehavior.CloseConnection) While myReader.Read() Console.WriteLine(myReader.GetString(0)) End While myReader.Close() myConnection.Close()
3-120
End Sub [C#] public void CreateMyIfxDataReader(string mySelectQuery,string myConnectionString) { IfxConnection myConnection = new IfxConnection(myConnectionString); IfxCommand myCommand = new IfxCommand(mySelectQuery, myConnection); myCommand.Connection.Open(); IfxDataReader myReader = myCommand.ExecuteReader(CommandBehavior.CloseConnection); while(myReader.Read()) { Console.WriteLine(myReader.GetString(0)); } myReader.Close(); myConnection.Close(); }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos TbUse.cs TbUse.vb Mtodo IfxCommand.ExecuteReader (): Enva el CommandText a la Connection y crea un IfxDataReader. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overloads Public Function ExecuteReader() As IfxDataReader [C#] public IfxDataReader ExecuteReader(); [C++] public: IfxDataReader * ExecuteReader(); [JScript] public function ExecuteReader() : IfxDataReader;
Valor de retorno Un objeto IfxDataReader.
3-121
Comentarios Para preparar la ejecucin del procedimiento almacenado, establezca la propiedad CommandType en StoredProcedure y establezca la propiedad CommandText en el nombre del procedimiento almacenado. Entonces, cuando llame a ExecuteReader, la aplicacin ejecutar este procedimiento almacenado. Puede acceder simultneamente a datos desde varias instancias de IfxDataReader que utilizan la misma instancia de IfxConnection. Cada instancia de IfxDataReader debe estar asociada con su propia instancia de IfxCommand. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand transfiriendo una serie de caracteres con una sentencia SELECT de SQL y una serie de caracteres de conexin. El SQL se ejecuta a continuacin llamando a ExecuteReader.
[Visual Basic] Public Sub CreateMyIfxDataReader(mySelectQuery As String, _ myConnectionString As String) Dim myConnection As New IfxConnection(myConnectionString) Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myCommand.Connection.Open() Dim myReader As IfxDataReader = myCommand.ExecuteReader() Try While myReader.Read() Console.WriteLine(myReader.GetString(0)) End While Finally myReader.Close() myConnection.Close() End Try End Sub [C#] public void CreateMyIfxDataReader(string mySelectQuery,string myConnectionString) { IfxConnection myConnection = new IfxConnection(myConnectionString); IfxCommand myCommand = new IfxCommand(mySelectQuery, myConnection); myCommand.Connection.Open(); IfxDataReader myReader = myCommand.ExecuteReader(); try { while(myReader.Read()) { Console.WriteLine(myReader.GetString(0)); } } finally { myReader.Close(); myConnection.Close(); } }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand
3-122
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.ExecuteReader en la pgina 3-120 Enva el CommandText a la Connection y crea un IfxDataReader. Ejemplos TbUse.cs TbUse.vb Mtodo IfxCommand.ExecuteReader (CommandBehavior): Enva el CommandText a la Connection, y crea un IfxDataReader utilizando uno de los valores de CommandBehavior. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function ExecuteReader( _ ByVal behavior As CommandBehavior _ ) As IfxDataReader [C#] public IfxDataReader ExecuteReader( CommandBehavior behavior ); [C++] public: IfxDataReader * ExecuteReader( CommandBehavior behavior ); [JScript] public function ExecuteReader( behavior : CommandBehavior ) : IfxDataReader ;
Parmetros behavior Uno de los valores de System.Data.CommandBehavior. Valor de retorno Una instancia de IfxDataReader. Comentarios Si espera que la sentencia de SQL devuelva solamente una fila, la especificacin de SingleRow como valor de CommandBehavior puede mejorar el rendimiento de la aplicacin.
3-123
IfxDataReader permite la utilizacin de una modalidad especial gracias a la que se pueden leer de forma eficiente los valores binarios altos. Para obtener ms informacin, consulte el valor SequentialAccess de CommandBehavior. Puede acceder simultneamente a datos desde varias instancias de IfxDataReader que utilizan la misma instancia de IfxConnection. Cada instancia de IfxDataReader debe estar asociada con su propia instancia de IfxCommand. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y ms tarde lo ejecuta pasando una serie de caracteres que es una sentencia SELECT de SQL y una serie de caracteres que se utilizar para conectar con la base de datos. A continuacin, se establece CommandBehavior en CloseConnection.
[Visual Basic] Public Sub CreateMyIfxDataReader(mySelectQuery As String, _ myConnectionString As String) Dim myConnection As New IfxConnection(myConnectionString) Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myCommand.Connection.Open() Dim myReader As IfxDataReader = myCommand.ExecuteReader(CommandBehavior.CloseConnection) While myReader.Read() Console.WriteLine(myReader.GetString(0)) End While myReader.Close() myConnection.Close() End Sub [C#] public void CreateMyIfxDataReader(string mySelectQuery,string myConnectionString) { IfxConnection myConnection = new IfxConnection(myConnectionString); IfxCommand myCommand = new IfxCommand(mySelectQuery, myConnection); myCommand.Connection.Open(); IfxDataReader myReader = myCommand.ExecuteReader(CommandBehavior.CloseConnection); while(myReader.Read()) { Console.WriteLine(myReader.GetString(0)); } myReader.Close(); myConnection.Close(); }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.ExecuteReader en la pgina 3-120 Enva el CommandText a la Connection y crea un IfxDataReader. Ejemplos
3-124
DtLob.cs DtLob.vb Mtodo IfxCommand.ExecuteResultSet: Enva el CommandText a la Connection y crea un IfxResultSet. Lista de sobrecargas
ExecuteResultSet(IBM.Data.IfxCursorType) ExecuteResultSet(IBM.Data.IfxResultSetOptions) ExecuteResultSet(System.Data.CommandBehavior, IBM.Data.IfxCursorType) ExecuteResultSet(System.Data.CommandBehavior, IBM.Data.IfxCursorType, bool) Enva el CommandText a la Connection y crea un IfxResultSet en funcin de un IfxCursorType. Enva el CommandText a la Connection y crea un IfxResultSet basado en IfxResultSetOptions. Enva el CommandText a la Connection y crea un IfxResultSet basado en CommandBehavior y un IfxCursorType. Enva el CommandText a la Connection y crea un IfxResultSet basado en CommandBehavior, un IfxCursorType y un valor que determina si la operacin terminar anormalmente si se reduce el cursor. Enva el CommandText a la Connection y crea un IfxResultSet basado en CommandBehavior y IfxResultSetOptions. Enva el CommandText a la Connection y crea un IfxResultSet basado en CommandBehavior, IfxResultSetOptions y un valor que determina si la operacin terminar anormalmente si se reduce el cursor.
ExecuteResultSet(System.Data.CommandBehavior, IBM.Data.IfxResultSetOptions) ExecuteResultSet(System.Data.CommandBehavior, IBM.Data.IfxResultSetOptions, bool)
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.ExecuteResultSet(IBM.Data.DB2.IfxCursorType): Enva el CommandText a la Connection y crea un IfxResultSet en funcin de un IfxCursorType. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function ExecuteResultSet( _ cursorType As IfxCursorType _ ) As IfxResultSet [C#] public IfxResultSet
3-125
ExecuteResultSet( IfxCursorType cursorType ); [C++] public: IfxResultSet * ExecuteResultSet( IfxCursorType cursorType ); [JScript] public function ExecuteResultSet( cursorType : IfxCursorType ) : IfxResultSet ;
Parmetros cursorType Uno de los valores de IBM.Data.Informix.IfxCursorType. Valor de retorno Una instancia de IfxResultSet. Ejemplo [C#] El ejemplo siguiente demuestra cmo leer datos de un IfxResultSet desplazable.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxCursorType.Keyset); if (salesRS.Scrollable) { if (salesRS.ReadLast()) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } } return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Enumeracin IfxCursorType en la pgina 3-254 Tipos de cursor que puede utilizar la instancia de IfxResultSet. Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos.
3-126
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.ExecuteResultSet(IBM.Data.Ifx.IfxResultSetOptions): Enva el CommandText a la Connection y crea un IfxResultSet al tiempo que especifica IfxResultSetOptions. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function ExecuteResultSet( _ options As IfxResultSetOptions _ ) As IfxResultSet [C#] public IfxResultSet ExecuteResultSet( IfxResultSetOptions options ); [C++] public: IfxResultSet * ExecuteResultSet( IfxResultSetOptions options ); [JScript] public function ExecuteResultSet( options : IfxResultSetOptions ) : IfxResultSet ;
Parmetros options Uno de los valores de IBM.Data.Informix.IfxResultSetOptions. Valor de retorno Una instancia de IfxResultSet. Ejemplo [C#] El ejemplo siguiente demuestra cmo leer datos de un IfxResultSet desplazable.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted |
3-127
IfxResultSetOptions.Updatable); if (salesRS.Scrollable) { if (salesRS.ReadLast()) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } } return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.ExecuteResultSet(System.Data.CommandBehavior, IBM.Data.DB2.IfxCursorType): Enva el CommandText a la Connection y crea un IfxResultSet al tiempo que especifica CommandBehavior and a IfxCursorType. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function ExecuteResultSet( _ ByVal behavior As CommandBehavior, _ cursorType As IfxCursorType _ ) As IfxResultSet [C#] public IfxResultSet ExecuteResultSet( CommandBehavior behavior, IfxCursorType cursorType ); [C++] public: IfxResultSet * ExecuteResultSet( CommandBehavior behavior, IfxCursorType cursorType ); [JScript]
3-128
public function ExecuteResultSet( behavior : CommandBehavior, cursorType : IfxCursorType ) : IfxResultSet ;
Parmetros behavior Uno de los valores de System.Data.CommandBehavior. cursorType Uno de los valores de IBM.Data.Informix.IfxCursorType. Valor de retorno Una instancia de IfxResultSet. Ejemplo [C#] El ejemplo siguiente demuestra cmo leer datos de un IfxResultSet desplazable.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( CommandBehavior.CloseConnection, IfxCursorType.Keyset); if (salesRS.Scrollable) { if (salesRS.ReadLast()) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } } return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-129
Mtodo IfxCommand.ExecuteResultSet(System.Data.CommandBehavior, IBM.Data.DB2.IfxCursorType, bool): Enva el CommandText a la Connection y crea un IfxResultSet al tiempo que especifica CommandBehavior, IfxCursorType y un valor que determina si se cancelar la operacin si el cursor se reduce. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function ExecuteResultSet( _ ByVal behavior As CommandBehavior, _ cursorType As IfxCursorType, _ abortOnOptValueChg As Boolean _ ) As IfxResultSet [C#] public IfxResultSet ExecuteResultSet( CommandBehavior behavior, IfxCursorType cursorType, bool abortOnOptValueChg ); [C++] public: IfxResultSet * ExecuteResultSet( CommandBehavior behavior, IfxCursorType cursorType, bool abortOnOptValueChg ); [JScript] public function ExecuteResultSet( behavior : CommandBehavior, cursorType : IfxCursorType, abortOnOptValueChg : Boolean ) : IfxResultSet ;
Parmetros behavior Uno de los valores de System.Data.CommandBehavior. cursorType Uno de los valores de IBM.Data.Informix.IfxCursorType. abortOnOptValueChg Valor booleano que indica si debe emitirse una excepcin si el tipo de cursor se ha reducido (true) o debe permitirse que el cursor lea el conjunto de resultados sin emitir una excepcin (false). Valor de retorno Una instancia de IfxResultSet.
3-130
Ejemplo [C#] El ejemplo siguiente demuestra cmo leer datos de un IfxResultSet desplazable. Para las conexiones de bases de datos contra un servidor de datos DB2 para Linux, UNIX o Windows, este cdigo emitir una excepcin cuando el cursor IfxResultSet lea los datos. Esto es debido a que se ha pasado un valor true al parmetroabortOnOptValueChg.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( CommandBehavior.CloseConnection, IfxCursorType.Dynamic, true); if (salesRS.ReadLast()) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.ExecuteResultSet(System.Data.CommandBehavior, IBM.Data.DB2.IfxResultSetOptions): Enva el CommandText a la Connection y crea un IfxResultSet al tiempo que especifica CommandBehavior yIfxResultSetOptions. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function ExecuteResultSet( _ ByVal behavior As CommandBehavior, _ options As IfxResultSetOptions _
3-131
) As IfxResultSet [C#] public IfxResultSet ExecuteResultSet( CommandBehavior behavior, IfxResultSetOptions options ); [C++] public: IfxResultSet * ExecuteResultSet( CommandBehavior behavior, IfxResultSetOptions options ); [JScript] public function ExecuteResultSet( behavior : CommandBehavior, options : IfxResultSetOptions ) : IfxResultSet ;
Parmetros behavior Uno de los valores de System.Data.CommandBehavior. options Uno de los valores de IBM.Data.Informix.IfxResultSetOptions. Valor de retorno Una instancia de IfxResultSet. Ejemplo [C#] El ejemplo siguiente demuestra cmo leer datos de un IfxResultSet desplazable.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( CommandBehavior.CloseConnection, IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted | IfxResultSetOptions.Updatable); if (salesRS.ReadLast()) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0
3-132
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.ExecuteResultSet(System.Data.CommandBehavior, IBM.Data.DB2.IfxResultSetOptions, bool): Enva el CommandText a la Connection y crea un IfxResultSet al tiempo que especifica CommandBehavior, IfxResultSetOptions y un valor que determina si se cancelar la operacin si el cursor se reduce. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function ExecuteResultSet( _ ByVal behavior As CommandBehavior, _ options As IfxResultSetOptions, _ abortOnOptValueChg As Boolean _ ) As IfxResultSet [C#] public IfxResultSet ExecuteResultSet( CommandBehavior behavior, IfxResultSetOptions options, bool abortOnOptValueChg ); [C++] public: IfxResultSet * ExecuteResultSet( CommandBehavior behavior, IfxResultSetOptions options, bool abortOnOptValueChg ); [JScript] public function ExecuteResultSet( behavior : CommandBehavior, options : IfxResultSetOptions, abortOnOptValueChg : Boolean ) : IfxResultSet ;
Parmetros behavior Uno de los valores de System.Data.CommandBehavior. options Uno de los valores de IBM.Data.Informix.IfxResultSetOptions.
3-133
abortOnOptValueChg Valor booleano que indica si debe emitirse una excepcin si el tipo de cursor se ha reducido (true) o debe permitirse que el cursor lea el conjunto de resultados sin emitir una excepcin (false). Valor de retorno Una instancia de IfxResultSet. Ejemplo [C#] El ejemplo siguiente demuestra cmo leer datos de un IfxResultSet desplazable. Para las conexiones de bases de datos contra un servidor de datos DB2 para Linux, UNIX o Windows, este cdigo emitir una excepcin cuando el cursor IfxResultSet lea los datos. Esto es debido a que se ha pasado un valor true al parmetroabortOnOptValueChg.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( CommandBehavior.CloseConnection, IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted | IfxResultSetOptions.Updatable, true); if (salesRS.ReadLast()) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.ExecuteRow: Enva el CommandText a la Connection y crea un IfxRecord. Este mtodo est pensado para conjuntos de resultados con una sola fila.
3-134

Visual Basic] Public Function ExecuteRow () As IfxRecord [C#] public IfxRecord ExecuteRow() [C++] public: IfxRecord ExecuteRow () [JScript] public function ExecuteRow () : IfxRecord
Valor de retorno Instancia de IfxRecord que representa la primera (o nica) fila de un conjunto de resultados. Ejemplo [C#] El ejemplo siguiente demuestra cmo crear un IfxRecord y leer sus datos de columna.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT MAX(SALES) FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxRecord salesRec = cmd.ExecuteRow(); salesData = salesRec.GetIfxInt32(0).ToString(); return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxCommand.ExecuteScalar: Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta. Las columnas o filas extra se ignoran.
3-135

Visual Basic] NotOverridable Public Function ExecuteScalar() As Object [C#] public object ExecuteScalar(); [C++] public: __sealed Object* ExecuteScalar(); [JScript] public function ExecuteScalar() : Object;
Valor de retorno La primera columna de la primera fila del conjunto de resultados. Comentarios Utilice el mtodo ExecuteScalar para recuperar un nico valor (por ejemplo, un valor agregado) de una base de datos. Necesita menos cdigo que si se utiliza el mtodo ExecuteReader y, a continuacin, deben realizarse las operaciones necesarias para generar un solo valor a partir de los datos que un IfxDataReader devuelve. Se puede formatear una consulta ExecuteScalar como en el siguiente ejemplo de C#:
CommandText = "select count(*) as NumberOfEmployee from EMPLOYEE"; Int count = (int) ExecuteScalar();
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y, a continuacin, lo ejecuta utilizando ExecuteScalar. Al ejemplo se le pasa una serie que es una sentencia de SQL que devuelve un resultado agregado, y una serie para utilizarla para conectar con la base de datos.
[Visual Basic] Public Sub CreateMyIfxCommand(myScalarQuery As String, myConnection As IfxConnection) Dim myCommand As New IfxCommand(myScalarQuery, myConnection) myCommand.Connection.Open() Dim qryValue As object = myCommand.ExecuteScalar() myConnection.Close() End Sub CreateMyIfxCommand [C#] public void CreateMyIfxCommand(string myScalarQuery, IfxConnection myConnection) { IfxCommand myCommand = new IfxCommand(myScalarQuery, myConnection); myCommand.Connection.Open(); object qryValue = myCommand.ExecuteScalar(); myConnection.Close(); }
Consulta
3-136
Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbValue.cs DbValue.vb Mtodo IfxCommand.Prepare: Crea una versin preparada (o compilada) del mandato en la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Public Sub Prepare() [C#] public void Prepare(); [C++] public: __sealed void Prepare(); [JScript] public function Prepare();
Excepciones
Tipo de excepcin InvalidOperationException Condicin La conexin Connection no est establecida -o bienLa Connection no es IfxConnection.Open.
Comentarios Antes de llamar a Prepare, especifique el tipo de datos de cada parmetro de la sentencia que se va a preparar. Para cada parmetro que tenga un tipo de datos de longitud variable, la propiedad IfxParameter.Size debe establecerse en el tamao mximo necesario. Prepare devuelve un error si no se cumplen estas condiciones. Si invoca un mtodo Execute despus de llamar a Prepare, cualquier valor de parmetro que sea mayor que el valor especificado por la propiedad Size se trunca automticamente hasta que tenga el tamao original especificado del parmetro y no se devuelven errores de truncamiento.
3-137
Los parmetros de salida (preparados o no) deben tener un tipo de datos especificado por el usuario. Si especifica un tipo de datos de longitud variable, tambin deber especificar el valor mximo de Size. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una conexin de base de datos transfiriendo una serie de caracteres para conectar con la base de datos, crea un IfxCommand transfiriendo una serie de caracteres que es una sentencia SELECT de SQL y un objeto de conexin y abre la conexin. A continuacin, el ejemplo prepara el mandato (la sentencia SELECT de SQL que se ha pasado anteriormente) en la base de datos.
Visual Basic] Public Sub CreateMyIfxCommand(mySelectQuery As String, _ myConnectionString As String) Dim myConnection As New IfxConnection(myConnectionString) Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myCommand.Connection.Open() myCommand.Prepare() End Sub [C#] public void CreateMyIfxCommand(string mySelectQuery, string myConnectionString) { IfxConnection myConnection = new IfxConnection(myConnectionString); IfxCommand myCommand = new IfxCommand(mySelectQuery, myConnection); myCommand.Connection.Open(); myCommand.Prepare(); }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbUse.cs DbUse.vb Mtodo IfxCommand.ResetCommandTimeout: Restablece la propiedad CommandTimeout en el valor por omisin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-138
Sintaxis
Visual Basic] Public Sub ResetCommandTimeout() [C#] public void ResetCommandTimeout(); [C++] public: void ResetCommandTimeout(); [JScript] public function ResetCommandTimeout();
Comentarios El valor por omisin de CommandTimeout es 30 segundos. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand,define CommandTimeout, muestra la propiedad, restablece CommandTimeout y vuelve a mostrar la propiedad. Para hacer esto, el mtodo recibe una serie de caracteres que es una sentencia SELECT de SQL, y una serie de caracteres que se utiliza para conectar con la base de datos.
Visual Basic] Public Sub CreateMyIfxCommand(mySelectQuery As String, _ myConnectionString As String) Dim myConnection As New IfxConnection(myConnectionString) Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myCommand.CommandTimeout = 15 MessageBox.Show(myCommand.CommandTimeout.ToString()) myCommand.ResetCommandTimeout() MessageBox.Show(myCommand.CommandTimeout.ToString()) End Sub [C#] public void CreateMyIfxCommand(string mySelectQuery, string myConnectionString) { IfxConnection myConnection = new IfxConnection(myConnectionString); IfxCommand myCommand = new IfxCommand(mySelectQuery, myConnection); myCommand.CommandTimeout = 15; MessageBox.Show(myCommand.CommandTimeout.ToString()); myCommand.ResetCommandTimeout(); MessageBox.Show(myCommand.CommandTimeout.ToString()); }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxCommand
Las propiedades de la clase IfxCommand se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxCommand, consulte el tema Miembros de IfxCommand.
3-139
Propiedades pblicas
CommandText Obtiene o establece la sentencia de SQL, expresin de o procedimiento almacenado que se debe ejecutar contra la base de datos. Obtiene o establece el tiempo de espera antes de finalizar la ejecucin de un mandato y generar un error. Obtiene o establece un valor que indica cmo se interpreta la propiedad CommandText. Obtiene o establece la IfxConnection utilizada por esta instancia de IfxCommand. Obtiene el IContainer que contiene el Component. Determina si los valores del parmetro de solo salida asociados con IfxCommand se devolvern como tipos de datos DB2 nativos (especialmente, clases y estructuras en el espacio de nombres IBM.Data.IfxTypes). Obtiene o establece la DbConnection utilizada por esta instancia de IfxCommand. Obtiene el objeto DbParameterCollection. DbParameterCollection DbTransaction DesignTimeVisible Obtiene o establece la DbTransaction dentro de la cual se ejecuta IfxCommand. Obtiene o establece un valor booleano que indica si un IfxCommand generado por un adaptador de datos es visible. Obtiene IfxParameterCollection. Parameters Obtiene o establece el ISite de Component. Site (heredada de Component) Transaction UpdatedRowSource Obtiene o establece la IfxTransaction dentro de la cual se ejecuta IfxCommand. Obtiene o establece un valor que especifica cmo el mtodo Update debe aplicar resultados de mandato a DataRow.
CommandTimeout
CommandType
Connection Container (heredada de Component) IfxTypeOutput
DbConnection
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos.
3-140
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommand.CommandText: Obtiene o establece la sentencia de SQL, expresin de XQuery o procedimiento almacenado que se debe ejecutar para la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property CommandText As String [C#] public string CommandText {get; set;} [C++] public: __property String* get_CommandText(); public: __property void set_CommandText(String*); [JScript] public function get CommandText() : String; public function set CommandText(String);
Valor de la propiedad Sentencia de SQL, expresin de XQuery o procedimiento almacenado que se debe ejecutar. El valor por omisin es una serie de caracteres vaca (). Comentarios sobre el procedimiento almacenado Cuando el valor de la propiedad CommandType es StoredProcedure, la propiedad CommandText debe ser igual al nombre del procedimiento almacenado. El mtodo recomendado para invocar un procedimiento almacenado es utilizar CommandType.StoredProcedure. Un procedimiento es un objeto ejecutable almacenado en la base de datos. Generalmente, se trata de una o ms sentencias de SQL que se han precompilado. La sintaxis para invocar un procedimiento mediante CommandType.Text es
{[?=]call nombre-procedimiento[([parmetro][,[parmetro]]...)]}
donde nombre-procedimiento especifica el nombre de un procedimiento y parmetro especifica un parmetro de procedimiento. La secuencia de escape (las llaves) se deben especificar cuando se utiliza ?= para el parmetro de retorno. En otro caso, la secuencia de escape es opcional. El mandato ejecuta este procedimiento almacenado cuando se invoca uno de los mtodos Execute (por ejemplo, ExecuteReader o ExecuteNonQuery). Comentarios sobre la sentencia de SQL No puede definir las propiedades Connection, CommandType y CommandText si la conexin actual est ejecutando una operacin execute o fetch.
3-141
Cuando se pasan parmetros a sentencias de SQL o procedimientos almacenados invocados por un IfxCommand, IBM Data Server Provider for .NET permite la utilizacin de parmetros con nombre o parmetros posicionados que utilicen marcadores de parmetros. No se puede utilizar una combinacin de parmetros con nombre y parmetros posicionados en la misma sentencia de SQL. Cuando se utilizan parmetros con nombre en una IfxParameterCollection, debe especificarse el nombre del objeto de parmetro en la sentencia de SQL y aadirse el objeto de parmetro al objeto DB2Command. Por ejemplo:
IfxCommand cmd = new IfxCommand( "SELECT * FROM EMPLOYEE WHERE LASTNAME = @lastname AND WORKDEPT = @workdept", conn ); cmd.Parameters.Clear(); cmd.Parameters.Add( "@workdept", IfxType.SmallInt ); cmd.Parameters.Add( "@lastname", IfxType.VarChar, 15 ); IfxReader reader = cmd.ExecuteReader();
Los nombres de parmetro son sensibles a may/min, se les debe anteponer el smbolo @ y pueden estar constituidos por cualquier smbolo que se pueda utilizar como parte de una sentencia de SQL. En los casos en que el smbolo @ se utiliza como prefijo en un identificador de SQL para otros objetos de base de datos, estos tienen que estar delimitados o bien se tiene que desactivar el soporte de parmetros con nombre y slo se pueden utilizar parmetros posicionados. Para inhabilitar la utilizacin de parmetros con nombre, establezca en 0 la palabra clave db2netnamedparam de CLI. Puede hacer esto aadiendo la lnea siguiente al archivo db2cli.ini situado en el directorio %IfxPATH%: IfxNETNAMEDPARAM=0 Para marcadores de parmetros, se debe utilizar el signo de interrogacin (?) como marcador de posicin. Por ejemplo:
SELECT * FROM Customers WHERE CustomerID = ?
Como resultado, el orden en el que se aaden objetos IfxParameter a la IfxParameterCollection debe corresponder directamente con la posicin del signo de interrogacin (marcador de posicin) correspondiente al parmetro. Si un parmetro contiene un valor nulo, IBM Data Server Provider for .NET vincular ese parmetro como un valor nulo. Por ejemplo, IfxParameterCollection:
{1, null, 2}
pasado a la propiedad CommandText:

call sp(?, ?, ?)
hace que IBM Data Server Provider for .NET vincule el primer parmetro con el valor 1, el segundo parmetro con el valor nulo y el tercer parmetro con el valor 2. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y establece algunas de sus propiedades.
Visual Basic] Public Sub CreateMyIfxCommand() Dim myCommand As New IfxCommand()
3-142
myCommand.CommandText = "SELECT * FROM EMPLOYEE ORDER BY EMPNO" myCommand.CommandTimeout = 20 End Sub [C#] public void CreateMyIfxCommand() { IfxCommand myCommand = new IfxCommand(); myCommand.CommandText = "SELECT * FROM EMPLOYEE ORDER BY EMPNO"; myCommand.CommandTimeout = 20; }
Consulta http://publib.boulder.ibm.com/infocenter/db2luw/v9/topic/ com.ibm.db2.udb.apdv.cli.doc/doc/r0021005.htm Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommand.Connection en la pgina 3-146 Obtiene o establece la IfxConnection que utiliza esta instancia de IfxCommand. Propiedad IfxCommand.CommandTimeout Obtiene o establece el tiempo de espera antes de terminar el intento de ejecutar un mandato o la ejecucin de un mandato. Se genera un error tras la terminacin. Propiedad IfxCommand.CommandType en la pgina 3-145 Obtiene o establece un valor que indica cmo se interpreta la propiedad CommandText. Ejemplos TbUse.cs TbUse.vb Propiedad IfxCommand.CommandTimeout: Obtiene o establece el tiempo de espera antes de terminar el intento de ejecutar un mandato o la ejecucin de un mandato. Se genera un error tras la terminacin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property CommandTimeout As Integer [C#] public int CommandTimeout {get; set;} [C++] public: __property int get_CommandTimeout();
3-143
public: __property void set_CommandTimeout(int); [JScript] public function get CommandTimeout() : int; public function set CommandTimeout(int);
Valor de la propiedad El tiempo (en segundos) de espera para que el mandato se ejecute. El valor por omisin es 30 segundos. Excepciones
Tipo de excepcin ArgumentException Condicin El valor de propiedad asignado es inferior a 0.
Comentarios Un valor de cero (0) especifica que no hay lmite para el tiempo de espera, ms que indicar que no hay tiempo de espera y, por lo tanto, se debe evitar. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y define algunas de sus propiedades.
Visual Basic] Public Sub CreateMyIfxCommand() Dim mySelectQuery As String = "SELECT * FROM EMPLOYEE ORDER BY EMPNO" Dim myCommand As New IfxCommand(mySelectQuery) myCommand.CommandTimeout = 20 End Sub [C#] public void CreateMyIfxCommand() { string mySelectQuery = "SELECT * FROM EMPLOYEE ORDER BY EMPNO"; IfxCommand myCommand = new IfxCommand(mySelectQuery); myCommand.CommandTimeout = 20; }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommand.Connection en la pgina 3-146 Obtiene o establece la IfxConnection que utiliza esta instancia de IfxCommand. Propiedad IfxCommand.CommandText en la pgina 3-141 Obtiene o establece la sentencia de SQL, expresin de XQuery o procedimiento almacenado que se debe ejecutar para la base de datos.
3-144
Propiedad IfxCommand.CommandType Obtiene o establece un valor que indica cmo se interpreta la propiedad CommandText. Propiedad IfxCommand.CommandTimeout en la pgina 3-143 Obtiene o establece el tiempo de espera antes de terminar el intento de ejecutar un mandato o la ejecucin de un mandato. Se genera un error tras la terminacin. Propiedad IfxCommand.CommandType: Obtiene o establece un valor que indica cmo se interpreta la propiedad CommandText. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property CommandType As CommandType [C#] public CommandType CommandType {get; set;} [C++] public: __property CommandType get_CommandType(); public: __property void set_CommandType(CommandType); [JScript] public function get CommandType() : CommandType; public function set CommandType(CommandType);
Valor de la propiedad Uno de los valores de System.Data.CommandType. El valor por omisin es Texto. Excepciones
Tipo de excepcin ArgumentException Condicin El valor no era un CommandType vlido.
Comentarios Cuando el valor de la propiedad CommandType es StoredProcedure, el valor de la propiedad CommandText debe ser el nombre del procedimiento almacenado. El mandato ejecuta este procedimiento almacenado cuando se invoca uno de los mtodos Execute (por ejemplo, ExecuteReader o ExecuteNonQuery). No se pueden definir las propiedades Connection, CommandType y CommandText si la conexin actual est realizando una operacin execute o fetch. Cuando se pasan parmetros a sentencias de SQL o procedimientos almacenados invocados por un IfxCommand, IBM Data Server Provider for .NET permite la utilizacin de parmetros con nombre o parmetros posicionados que utilicen marcadores de parmetros.
3-145
Para obtener ms informacin, consulte el apartado Utilizacin de procedimientos almacenados con un Command en la documentacin del SDK de Microsoft(R) .NET Framework. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una instancia de un IfxCommand de clase derivada y establece algunas de las propiedades de la misma.
Visual Basic] Public Sub CreateMyIfxCommand() Dim myCommand As New IfxCommand() myCommand.CommandText = "SELECT * FROM EMPLOYEE ORDER BY EMPNO" myCommand.CommandType = CommandType.Text End Sub [C#] public void CreateMyIfxCommand() { IfxCommand myCommand = new IfxCommand(); myCommand.CommandText = "SELECT * FROM EMPLOYEE ORDER BY EMPNO"; myCommand.CommandType = CommandType.Text; }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommand.CommandText en la pgina 3-141 Obtiene o establece la sentencia de SQL, expresin de XQuery o procedimiento almacenado que se debe ejecutar para la base de datos. Propiedad IfxCommand.UpdatedRowSource en la pgina 3-155 Obtiene o establece un valor que especifica cmo el mtodo Update debe aplicar resultados de mandato a DataRow. Ejemplos SpClient.cs SpClient.vb Propiedad IfxCommand.Connection: Obtiene o establece la IfxConnection que utiliza esta instancia de IfxCommand. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Connection As IfxConnection
3-146
[C#] public IfxConnection Connection {get; set;} [C++] public: __property IfxConnection * get_Connection(); public: __property void set_Connection(IfxConnection *); [JScript] public function get Connection() : IfxConnection ; public function set Connection(IfxConnection );
Valor de la propiedad La conexin con una base de datos. El valor por omisin es un valor nulo. Excepciones
Tipo de excepcin InvalidOperationException Condicin La propiedad Connection se ha cambiado mientras una transaccin estaba en progreso.
Comentarios No puede definir las propiedades Connection, CommandType y CommandText si la conexin actual est ejecutando una operacin execute o fetch. Si establece Connection mientras una transaccin est en progreso y la propiedad Transaction no es nula, se emite una excepcin InvalidOperationException. Si establece Connection despus de confirmar o retrotraer la transaccin y la propiedad Transaction no es nula, la propiedad Transaction se establecer en un valor nulo. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y define algunas de sus propiedades.
Visual Basic] Public Sub CreateMyIfxCommand() Dim mySelectQuery As String = _ "SELECT * FROM EMPLOYEE ORDER BY EMPNO" Dim myCommand As New IfxCommand(mySelectQuery) myCommand.Connection = New IfxConnection _ ("DATABASE=SAMPLE;") End Sub [C#] public void CreateMyIfxCommand() { string mySelectQuery = "SELECT * FROM EMPLOYEE ORDER BY EMPNO"; IfxCommand myCommand = new IfxCommand(mySelectQuery); myCommand.Connection = new IfxConnection ("DATABASE=SAMPLE;"); }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos.
3-147
Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommand.CommandText en la pgina 3-141 Obtiene o establece la sentencia de SQL, expresin de XQuery o procedimiento almacenado que se debe ejecutar para la base de datos. Propiedad IfxCommand.CommandTimeout en la pgina 3-143 Obtiene o establece el tiempo de espera antes de terminar el intento de ejecutar un mandato o la ejecucin de un mandato. Se genera un error tras la terminacin. Propiedad IfxCommand.CommandType en la pgina 3-145 Obtiene o establece un valor que indica cmo se interpreta la propiedad CommandText. Propiedad IfxCommand.IfxTypeOutput: Determina si los valores del parmetro de solo salida asociados con IfxCommand se devolvern como tipos de datos DB2 nativos (especialmente, clases y estructuras en el espacio de nombres IBM.Data.IfxTypes). Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Public Overrides Property IfxTypeOutput As Boolean [C#] public override bool IfxTypeOutput { get; set; } [C++] public: virtual property bool IfxTypeOutput { bool get () override; void set (bool value) override; }
Valor de la propiedad Valor booleano que determina si las instancias de IfxParameter de slo salida asociadas devolvern los valores de columna como instancias del tipo de datos Informix nativo (por ejemplo, IfxString). Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand
3-148
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommand.DbConnection: Obtiene o establece la DbConnection utilizada por esta instancia de IfxCommand. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property DbConnection As DbConnection [C#] public DbConnection DbConnection {get; set;} [C++] public: __property DbConnection* get_DbConnection(); public: __property void set_DbConnection(DbConnection*); [JScript] public function get DbConnection() : DbConnection; public function set DbConnection(DbConnection);
Valor de la propiedad La conexin con la fuente de datos. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommand.DbParameterCollection: Obtiene el objeto DbParameterCollection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-149
Sintaxis
Visual Basic] Public Property DbParameterCollection As DbParameterCollection [C#] public DbParameterCollection DbParameterCollection {get;} [C++] public: __property DbParameterCollection* get_DbParameterCollection(); [JScript] public function get DbParameterCollection() : DbParameterCollection;
Valor de la propiedad Los parmetros de la sentencia de SQL o del procedimiento almacenado. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommand.DbTransaction: Obtiene o establece la DbTransaction dentro de la cual se ejecuta IfxCommand. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property DbTransaction As DbTransaction [C#] public DbTransaction DbTransaction {get; set;} [C++] public: __property DbTransaction* get_DbTransaction(); public: __property void set_DbTransaction(DbTransaction*); [JScript] public function get DbTransaction() : DbTransaction; public function set DbTransaction(DbTransaction);
Valor de la propiedad La transaccin en la que se ejecuta un objeto IfxCommand. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta
3-150
Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommand.DesignTimeVisible: Obtiene o establece un valor booleano que indica si un IfxCommand generado por un adaptador de datos es visible. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Property DesignTimeVisible As Boolean [C#] public override bool DesignTimeVisible { get; set; } [C++] public: virtual property bool DesignTimeVisible { bool get () override; void set (bool value) override; } [JScript] public override function get DesignTimeVisible () : boolean public override function set DesignTimeVisible (value : boolean)
Valor de la propiedad Obtiene o establece un valor booleano que indica si un IfxCommand generado por un adaptador de datos es visible. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxCommand.Parameters:
3-151
Obtiene la IfxParameterCollection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Parameters As IfxParameterCollection [C#] public IfxParameterCollection Parameters {get;} [C++] public: __property IfxParameterCollection * get_Parameters(); [JScript] public function get Parameters() : IfxParameterCollection;
Valor de la propiedad Los parmetros de la sentencia de SQL o del procedimiento almacenado. El valor por omisin es una coleccin vaca. Comentarios Cuando se pasan parmetros a sentencias de SQL o procedimientos almacenados invocados por un IfxCommand, IBM Data Server Provider for .NET permite la utilizacin de parmetros con nombre o parmetros posicionados que utilicen marcadores de parmetros. No se puede utilizar una combinacin de parmetros con nombre y parmetros posicionados en la misma sentencia de SQL. Parmetros con nombre Cuando utilice parmetros con nombre en IfxParameterCollection, especifique el nombre del objeto de parmetro en la sentencia de SQL. Por ejemplo:
SELECT * FROM EMPLOYEE WHERE FIRSTNME = @firstname AND LASTNAME = @lastname AND WORKDEPT = @workdept
Los nombres de parmetro son sensibles a may/min, se les debe anteponer el smbolo @ y pueden estar constituidos por cualquier smbolo que se pueda utilizar como parte de una sentencia de SQL. En los casos en que el smbolo @ se utiliza como prefijo en un identificador de SQL para otros objetos de base de datos, estos tienen que estar delimitados o bien se tiene que desactivar el soporte de parmetros con nombre y slo se pueden utilizar parmetros posicionados. Para desactivar el soporte a los parmetros con nombre, establezca la palabra clave de CLI db2netnamedparam en 0. Esto puede realizarse aadiendo la lnea siguiente al archivo db2cli.ini que se encuentra en la directorio %IfxPATH%:
DB2NETNAMEDPARAM=0
Parmetros posicionados Cuando se utilicen parmetros posicionados, utilice el marcador de parmetro signo de interrogacin (?). Por ejemplo:
SELECT * FROM EMPLOYEE WHERE EMPNO = ?
3-152
El orden en el que se aaden objetos IfxParameter a la IfxParameterCollection debe corresponder directamente con la posicin del signo de interrogacin (marcador de posicin) correspondiente al parmetro dentro del texto del mandato. Nota: Si los parmetros de la coleccin no coinciden con los requisitos de la consulta que se debe ejecutar, es posible que se produzca un error. Ejemplo [Visual Basic, C#] Los ejemplos siguientes crean un IfxCommand y visualizan los parmetros del mismo. Para hacer esto, el mtodo recibe una IfxConnection, una serie de caracteres de consulta que es una sentencia SELECT de SQL, y una matriz de objetos IfxParameter. Para estos ejemplos, la matriz contiene un solo objeto IfxParameter, denominado @param1.
Visual Basic] Using named parameters Public Sub CreateMyIfxCommand(myConnection As IfxConnection, _ mySelectQuery As String, myParamArray() As IfxParameter) Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myCommand.CommandText = "SELECT ID, NAME FROM STAFF WHERE ID = @param1" myCommand.Parameters.Add(myParamArray) Dim j As Integer For j = 0 To myCommand.Parameters.Count - 1 myCommand.Parameters.Add(myParamArray(j)) Next j Dim myMessage As String = "" Dim i As Integer For i = 0 To myCommand.Parameters.Count - 1 myMessage += myCommand.Parameters(i).ToString() + ControlChars.Cr Next i Console.WriteLine(myMessage) End Sub [C#] //Using named parameters public void CreateMyIfxCommand(IfxConnection myConnection, string mySelectQuery, IfxParameter[] myParamArray) { IfxCommand myCommand = new IfxCommand(mySelectQuery, myConnection); myCommand.CommandText = "SELECT ID, NAME FROM STAFF WHERE ID = @param1"; myCommand.Parameters.Add(myParamArray); for (int j=0; j<myParamArray.Length; j++) { myCommand.Parameters.Add(myParamArray[j]) ; } string myMessage = ""; for (int i = 0; i < myCommand.Parameters.Count; i++) { myMessage += myCommand.Parameters[i].ToString() + "\n"; } MessageBox.Show(myMessage); } [Visual Basic] Using positioned parameters Public Sub CreateMyIfxCommand(myConnection As IfxConnection, _ mySelectQuery As String, myParamArray() As IfxParameter) Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myCommand.CommandText = "SELECT ID, NAME FROM STAFF WHERE ID = ?" myCommand.Parameters.Add(myParamArray) Dim j As Integer For j = 0 To myCommand.Parameters.Count - 1 myCommand.Parameters.Add(myParamArray(j)) Next j
3-153
Dim myMessage As String = "" Dim i As Integer For i = 0 To myCommand.Parameters.Count - 1 myMessage += myCommand.Parameters(i).ToString() + ControlChars.Cr Next i Console.WriteLine(myMessage) End Sub [C#] //Using positioned parameters public void CreateMyIfxCommand(IfxConnection myConnection, string mySelectQuery, IfxParameter[] myParamArray) { IfxCommand myCommand = new IfxCommand(mySelectQuery, myConnection); myCommand.CommandText = "SELECT ID, NAME FROM STAFF WHERE ID = ?"; myCommand.Parameters.Add(myParamArray); for (int j=0; j<myParamArray.Length; j++) { myCommand.Parameters.Add(myParamArray[j]) ; } string myMessage = ""; for (int i = 0; i < myCommand.Parameters.Count; i++) { myMessage += myCommand.Parameters[i].ToString() + "\n"; } MessageBox.Show(myMessage); }
Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Ejemplos TbUse.cs TbUse.vb Propiedad IfxCommand.Transaction: Obtiene o establece la IfxTransaction dentro de la cual se ejecuta el IfxCommand. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Transaction As IfxTransaction [C#] public IfxTransaction
3-154
Transaction {get; set;} [C++] public: __property IfxTransaction * get_Transaction(); public: __property void set_Transaction(IfxTransaction *); [JScript] public function get Transaction() : IfxTransaction ; public function set Transaction(IfxTransaction );
Valor de la propiedad Una IfxTransaction. El valor por omisin es un valor nulo. Comentarios No se puede establecer la propiedad Transaction si ya est establecida en un valor especfico y el mandato est en ejecucin. Si se establece la propiedad Transaction en un objeto IfxTransaction que no est conectado a la misma IfxConnection que el objeto IfxCommand, se emitir una excepcin la prxima vez que intente ejecutar una sentencia. Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos TbUse.cs TbUse.vb Propiedad IfxCommand.UpdatedRowSource: Obtiene o establece un valor que especifica cmo el mtodo Update debe aplicar resultados de mandato a DataRow. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property UpdatedRowSource As UpdateRowSource [C#] public UpdateRowSource UpdatedRowSource {get; set;} [C++] public: __property UpdateRowSource get_UpdatedRowSource(); public: __property void set_UpdatedRowSource(UpdateRowSource);
3-155
[JScript] public function get UpdatedRowSource() : UpdateRowSource; public function set UpdatedRowSource(UpdateRowSource);
Valor de la propiedad Uno de los valores de System.Data.UpdateRowSource. Excepciones

Tipo de excepcin ArgumentException Condicin El valor que se ha entrado no era uno de los valores de UpdateRowSource.
Comentarios El valor por omisin de UpdateRowSource es Both a menos que el mandato se genere automticamente (como ocurre para IfxCommandBuilder), en cuyo caso el valor por omisin es None. Consulta Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Miembros de IfxCommand en la pgina 3-101 Visin general de IfxCommand Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxConnection
Representa una conexin abierta con una base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)

System.Object System.MarshalByRefObject System.ComponentModel.Component IBM.Data.Informix.IfxConnection

System.Object System.MarshalByRefObject System.ComponentModel.Component System.Data.Common.DbConnection IBM.Data.DB2.IfxConnection
3-156

Visual Basic] NotInheritable Public Class IfxConnection Inherits Component Implements ICloneable, IDbConnection [C#] public sealed class IfxConnection : Component, ICloneable, IDbConnection [C++] public __gc __sealed class IfxConnection : public Component, ICloneable, IDbConnection [JScript] public class IfxConnection extends Component implements ICloneable, IDbConnection

Visual Basic] NotInheritable Public Class IfxConnection Inherits DbConnection Implements ICloneable, IDbConnection [C#] public sealed class IfxConnection : Component, ICloneable, IDbConnection [C++] public __gc __sealed class IfxConnection : public Component, ICloneable, IDbConnection [JScript] public class IfxConnection extends Component implements ICloneable, IDbConnection
Comentarios
Un objeto IfxConnection representa una conexin exclusiva a la base de datos especificada en la serie de conexin. En el caso de un sistema de bases de datos cliente/servidor, es equivalente a una conexin de red con el servidor. El objeto IfxConnection utiliza recursos nativos. Debe cerrar siempre explcitamente cualquier objeto IfxConnection abierto llamando a Close o Dispose antes de que el objeto IfxConnection pase a estar fuera de mbito. No hacerlo as dejar la liberacin de estos recursos nativos a la recopilacin de basura, que puede no liberarlos inmediatamente. Esto, a su vez, puede hacer que finalmente IBM Data Provider for .NET o el servidor de datos se queden sin recursos o alcancen un lmite mximo, lo que dara como resultado anomalas espordicas. Por ejemplo, podran producirse errores relacionados con Maximum Connections mientras un nmero de conexiones estn a la espera de ser suprimidas por el recolector de basura. Cerrar explcitamente las conexiones llamando a Close o Dispose permite un uso ms eficaz de recursos nativos, aumentando la escalabilidad y mejorando el rendimiento general de la aplicacin. Nota: Para desplegar aplicaciones de alto rendimiento, con frecuencia es necesario utlizar el agrupamiento de conexiones. Sin embargo, cuando utilice IBM Data Provider for .NET, no necesitar habilitar el agrupamiento de conexiones porque el proveedor las agrupa por omisin. Si uno de los mtodos Execute de la clase IfxCommand da lugar a una IfxException muy grave, es posible que la IfxConnection se cierre. Sin embargo, el usuario puede reabrir la conexin y continuar. Una aplicacin que crea una instancia del objeto IfxConnection puede que necesite que todos los llamadores directos e indirectos tengan el permiso adecuado para el
3-157
cdigo estableciendo peticiones de seguridad declarativas o imperativas. IfxConnection crea requisitos de seguridad utilizando el objeto IfxPermission. Los usuarios pueden verificar si su cdigo tiene los permisos adecuados utilizando el objeto IfxPermissionAttribute. Los usuarios y los administradores tambin pueden utilizar la Code Access Security Policy Tool (Caspol.exe - Herramienta de poltica de seguridad de acceso al cdigo) para modificar la poltica de seguridad a niveles de mquina, usuario y empresa. Para obtener ms informacin, consulte el apartado Proteccin de aplicaciones en la documentacin del SDK de Microsoft .NET Framework.
Ejemplo
[Visual Basic, C#] El ejemplo siguiente crea un IfxCommand y una IfxConnection. La IfxConnection se abre y se define como la propiedad IfxCommand.Connection. A continuacin, el ejemplo llama a IfxCommand.ExecuteNonQuery, y cierra la conexin. Para hacer esto, ExecuteNonQuery recibe una serie de caracteres de conexin y serie de caracteres de consulta que es una sentencia INSERT de SQL.
[Visual Basic] Public Sub InsertRow(myConnectionString As String) If the connection string is null, use a default. If myConnectionString = "" Then myConnectionString = "DATABASE=SAMPLE;" End If Dim myConn As New IfxConnection(myConnectionString) Dim myInsertQuery As String = "INSERT INTO STAFF (ID, NAME) Values(...)" Dim myIfxCommand As New IfxCommand(myInsertQuery) myIfxCommand.Connection = myConn myConn.Open() myIfxCommand.ExecuteNonQuery() myConn.Close() End Sub [C#] public void InsertRow(string myConnectionString) { // If the connection string is null, use a default. if(myConnectionString == "") { myConnectionString = "DATABASE=SAMPLE;"; } IfxConnection myConn = new IfxConnection(myConnectionString); string myInsertQuery = "INSERT INTO STAFF (ID, NAME) Values(...)"; IfxCommand myIfxCommand = new IfxCommand(myInsertQuery); myIfxCommand.Connection = myConn; myConn.Open(); myIfxCommand.ExecuteNonQuery(); myConn.Close(); }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta
3-158
Miembros de IfxConnection Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Ejemplos DbUse.cs DbUse.vb
Miembros de IfxConnection
Las tablas siguientes listan los miembros expuestos por la clase IfxConnection.
Nombre IfxConnection Descripcin Sobrecargado. Inicializa una nueva instancia de la clase IfxConnection.
Propiedades pblicas
Nombre CacheData Descripcin Obtiene o establece un valor booleano que indica si se utiliza la colocacin de datos en antememoria. Obtiene un valor booleano que indica que el encadenamiento est activo. Obtiene o establece la serie de caracteres que contiene la serie de contabilidad del cliente. Obtiene o establece la serie de caracteres que contiene el nombre de la aplicacin cliente. Obtiene o establece la serie de caracteres que contiene el ID de usuario del cliente. Obtiene o establece la serie de caracteres que contiene el nombre de la estacin de trabajo cliente. Obtiene o establece la serie de caracteres utilizada para abrir una conexin de base de datos. Obtiene el IContainer que contiene el Component. Obtiene o establece un valor que determina el lmite de tiempo que una aplicacin debe esperar para establecer una conexin.
Chaining ClientAccountingInformation ClientApplicationInformation ClientUser ClientWorkstation
ConnectionString
Container (heredada de Component) ConnectionTimeout
3-159
Nombre Database
Descripcin Obtiene el nombre de la base de datos actual o de la base de datos que se va a utilizar despus de abrir una conexin. Obtiene el nombre de la base de datos actual o de la base de datos que se va a utilizar despus de abrir una conexin. Obtiene una serie de caracteres que contiene la versin del servidor al que est conectado el cliente. Obtiene una serie de caracteres que contiene la versin secundaria del servidor al que est conectado el cliente. Obtiene una serie de caracteres que contiene la versin principal del servidor al que est conectado el cliente. Obtiene una serie de caracteres que contiene la versin de revisin del servidor al que est conectado el cliente. Obtiene una serie que contiene el tipo de servidor al que el cliente est conectado. Obtiene una serie de caracteres que contiene la versin del servidor al que est conectado el cliente. Obtiene o establece el ISite de Component.
DataSource
ServerBuildVersion
ServerMinorVersion
ServerMajorVersion
ServerRevisionVersion
ServerType ServerVersion
Site (heredada de Component) Obtiene el estado actual de la conexin. State
Mtodos pblicos
Nombre BeginChain Descripcin Marca el inicio de una cadena de sentencias insert, update y delete que se enviarn al servidor de bases de datos. Sobrecargado. Inicia una transaccin en la base de datos. Cambia la base de datos actual asociada con una IfxConnection abierta. Cierra la conexin con la base de datos. Este es el mtodo preferido de cerrar cualquier conexin abierta. Crea y devuelve un objeto IfxCommand asociado con IfxConnection. Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Sobrecargado. Libera los recursos utilizados por Component.
BeginTransaction ChangeDatabase Close
CreateCommand CreateObjRef (heredado de MarshalByRefObject)
Dispose (heredado de Component)
3-160
Nombre DropDTD EndChain
Descripcin Elimina la DTD registrada en la base de datos. Marca el final de una cadena de sentencias insert, update y delete que se enviarn al servidor de bases de datos. Inscribe en la transaccin especificada como transaccin distribuida. Sobrecargado. Inscribe la transaccin especificada. Sobrecargado. Determina si dos instancias de Object son iguales. Obtiene la DTD registrada en la base de datos. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el Type de la instancia actual.
EnlistDistributedTransaction EnlistTransaction (heredado de DbConnection) Equals (heredado de Object) GetDTD GetHashCode (heredado de Object)
GetLifetimeService (heredado de MarshalByRefObject) GetType (heredado de Object) GetSchema()
Sobrecargado. Devuelve una DataTable con metadatos para la fuente de datos asociada con esta instancia de IfxConnection. Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Abre una conexin con una base de datos mediante los valores de propiedad especificados por ConnectionString. Registra la DTD en la base de datos.
InitializeLifetimeService (heredado de MarshalByRefObject) Open
RegisterDTD ReleaseObjectPool Indica que la agrupacin de objetos IfxConnection se puede liberar cuando se libere la ltima conexin subyacente. Devuelve una String que representa el Object actual.
Sucesos pblicos
Nombre Disposed (heredado de Component) Descripcin Aade un manejador de sucesos para escuchar al suceso Disposed en el componente. Se produce cuando IBM Data Server Provider for .NET enva un aviso o un mensaje informativo.
InfoMessage
3-161
Nombre StateChange
Descripcin Se produce cuando cambia el estado de la conexin.
Nombre DesignMode (heredada de Component) Events (heredada de Component) Descripcin Obtiene un valor que indica si el Component est actualmente en modalidad de diseo. Obtiene la lista de manejadores de sucesos que estn conectados a este Component.
Mtodos protegidos
Nombre Dispose Descripcin Sobrecargado. Alterado temporalmente. Libera los recursos utilizados por IfxConnection. Alterado temporalmente. Permite que un Object intente liberar recursos y realizar otras operaciones de limpieza antes de que el Object sea reclamado para la recopilacin de basura. En C# y Microsoft Visual C++, los finalizadores se expresan utilizando sintaxis de destructor. GetService (heredado de Component) Devuelve un objeto que representa un servicio proporcionado por el Component o por su Container. Crea una copia superficial del Object actual. MemberwiseClone (heredado de Object)
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Constructor de IfxConnection
Inicializa una nueva instancia de la clase IfxConnection.
Nombre New() Descripcin Inicializa una nueva instancia de la clase IfxConnection.
3-162
Nombre New(String)
Descripcin Inicializa una nueva instancia de la clase IfxConnection con la serie de conexin especificada.
Ejemplo
[Visual Basic, C#] El ejemplo siguiente crea y abre una IfxConnection. Nota: [Visual Basic, C#] Este ejemplo muestra cmo utilizar una de las versiones sobrecargadas del constructor de IfxConnection. Para obtener otros ejemplos que pudieran estar disponibles, consulte los temas de sobrecarga individuales.
Visual Basic] Public Sub CreateIfxConnection() Dim myConnString As String = "DATABASE=SAMPLE;" Dim myConnection As New IfxConnection(myConnString) myConnection.Open() End Sub [C#] public void CreateIfxConnection() { string myConnString = "DATABASE=SAMPLE;"; IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open(); }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos TbUse.cs TbUse.vb Constructor de IfxConnection (): Inicializa una nueva instancia de la clase IfxConnection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New() [C#]
3-163
public IfxConnection(); [C++] public: IfxConnection(); [JScript] public function IfxConnection();
Comentarios Cuando se crea una nueva instancia de IfxConnection, las propiedades de lectura/escritura se establecen en los valores iniciales siguientes a menos que se definan especficamente mediante sus palabras clave asociadas en la propiedad ConnectionString.
Propiedades ConnectionString Database Valor inicial serie vaca () serie vaca ()
Slo puede cambiar el valor de estas propiedades utilizando la propiedad ConnectionString. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea y abre una IfxConnection.
Visual Basic] Public Sub CreateIfxConnection() Dim myConnection As New IfxConnection() myConnection.ConnectionString = "DATABASE=SAMPLE;" myConnection.Open() End Sub [C#] public void CreateIfxConnection() { IfxConnection myConnection = new IfxConnection(); myConnection.ConnectionString = "DATABASE=SAMPLE;"; myConnection.Open(); }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxConnection en la pgina 3-162 Inicializa una nueva instancia de la clase IfxConnection. Constructor de IfxConnection (String): Inicializa una nueva instancia de la clase IfxConnection con la serie de conexin especificada.
3-164

Visual Basic] Public Sub New( _ ByVal connectionString As String _ ) [C#] public IfxConnection( string connectionString ); [C++] public: IfxConnection( String* connectionString ); [JScript] public function IfxConnection( connectionString : String );
Parmetros connectionString La conexin utilizada para abrir la base de datos. Comentarios Cuando se crea una nueva instancia de IfxConnection, las propiedades de lectura/escritura se establecen en los valores iniciales siguientes a menos que se definan especficamente mediante sus palabras clave asociadas en la propiedad ConnectionString.
Propiedades ConnectionString Database Valor inicial connectionString serie vaca ()
Slo puede cambiar el valor de estas propiedades utilizando la propiedad ConnectionString. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea y abre una IfxConnection.
Visual Basic] Public Sub CreateIfxConnection() Dim myConnString As String = "DATABASE=SAMPLE;" Dim myConnection As New IfxConnection(myConnString) myConnection.Open() End Sub [C#] public void CreateIfxConnection() { string myConnString = "DATABASE=SAMPLE;";
3-165
IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open(); }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxConnection en la pgina 3-162 Inicializa una nueva instancia de la clase IfxConnection. Ejemplos TbUse.cs TbUse.vb
Mtodos de conexin de Ifx

Los mtodos de la clase IfxConnection se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxConnection, consulte el tema IfxConnection Members.
Mtodos pblicos
BeginTransaction ChangeDatabase Close Sobrecargado. Inicia una transaccin en la base de datos. Cambia la base de datos actual asociada con una conexin Ifx abierta. Cierra la conexin con la base de datos. Este es el mtodo preferido de cerrar cualquier conexin abierta. Crea y devuelve un objeto IfxCommand asociado a IfxConnection. Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Elimina la DTD registrada en la base de datos. Sobrecargado. Libera los recursos utilizados por Component. Inscribe en la transaccin especificada como transaccin distribuida. Sobrecargado. Inscribe la transaccin especificada. Sobrecargado. Determina si dos instancias de Object son iguales.
CreateCommand CreateObjRef (heredado de MarshalByRefObject)
DropDTD Dispose (heredado de Component) EnlistDistributedTransaction EnlistTransaction (heredado de DbConnection) Equals (heredado de Object)
3-166
GetDTD GetHashCode (heredado de Object)
Obtiene la DTD registrada en la base de datos. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el Type de la instancia actual.
GetLifetimeService (heredado de MarshalByRefObject) GetType (heredado de Object) GetSchema()
Sobrecargado. Devuelve una DataTable con metadatos para la fuente de datos asociada con esta instancia de IfxConnection. Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Abre una conexin con una base de datos mediante los valores de propiedad especificados por ConnectionString. Registra la DTD en la base de datos.
InitializeLifetimeService (heredado de MarshalByRefObject) Open
RegisterDTD ReleaseObjectPool Indica que la agrupacin de objetos IfxConnection se puede liberar cuando se libere la ltima conexin subyacente. Devuelve una String que representa el Object actual.
Mtodos protegidos
Dispose Sobrecargado. Alterado temporalmente. Libera los recursos utilizados por IfxConnection. Alterado temporalmente. Permite que un Object intente liberar recursos y realizar otras operaciones de limpieza antes de que el Object sea reclamado para la recopilacin de basura. En C# y Microsoft(R) Visual C++(R), los finalizadores se expresan utilizando sintaxis de destructor. GetService (heredado de Component) Devuelve un objeto que representa un servicio proporcionado por el Component o por su Container. Crea una copia superficial del Object actual. MemberwiseClone (heredado de Object)
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos.
3-167
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.BeginChain: Marca el inicio de una cadena de sentencias insert, update y delete que se enviarn al servidor de bases de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub BeginChain() [C#] public void BeginChain(); [C++] public: void BeginChain(); [JScript] public function BeginChain();
Excepciones
Tipo de excepcin InvalidOperationException Condicin La conexin no est abierta.
Comentarios Si necesita ejecutar un lote grande de sentencias insert, update y delete, puede mejorar el rendimiento de la aplicacin encadenando las sentencias de SQL y de esta forma reduciendo el nmero de flujos de red al servidor de bases de datos. Antes de llamar al mtodo BeginChain para activar el encadenamiento, el objeto IfxConnection debe estar abierto. Despus de llamar al mtodo BeginChain, las sentencias insert, update y delete que ejecute para IfxConnection se colocarn en el cliente hasta que se llame al mtodo EndChain. Despus de llamar al mtodo EndChain, estas sentencias se enviarn al servidor de bases de datos y se ejecutarn. Tanto si el encadenamiento est activo como inactivo, puede ejecutar sentencias insert, update y delete utilizando el mtodo IfxCommandClass.ExecuteNonQuery. Pero cuando el encadenamiento est activo, todas las llamadas a IfxCommand.ExecuteNonQuery devolvern -1. Debido a que todas las sentencias encadenadas se ejecutan juntas despus de que se llame al mtodo EndChain, se desconoce el nmero de filas afectadas para una sentencia determinada. Las sentencias encadenadas se pueden ejecutar desde mltiples objetos IfxCommand o desde un nico objeto IfxCommand. Todos los objetos IfxCommand que se utilizan para ejecutar una serie de sentencias encadenadas se deben crear desde la misma IfxConnection donde se ha activado el encadenamiento.
3-168
Para las conexiones a servidores de bases de datos que soportan el encadenamiento, la propiedad Chaining se establece en true cuando se llama al mtodo BeginChain y se restablece de nuevo en false cuando se llama al mtodo EndChain. Existen algunos servidores de datos que no dan soporte al encadenamiento. Si un servidor no soporta el encadenamiento, IBM Data Server Provider for .NET pasar por alto las peticiones BeginChain y EndChain, dejar la propiedad IfxConnection.Chaining en un estado de false y enviar todas las sentencias al servidor de bases de datos individualmente. Puede determinar si el encadenamiento est activo examinando la propiedad Chaining. No hay ningn lmite respecto del nmero de sentencias que se pueden encadenar para un objeto IfxConnection individual. Sin embargo, despus de que se hayan puesto en cola 2.147.483.646 sentencias, IBM Data Provider for .NET cierra internamente la cadena, enva las sentencias y reinicia la cadena. De forma adicional, una vez que se ha llenado el almacenamiento intermedio de comunicaciones entre la aplicacin y el servidor de bases de datos (normalmente de 32 KB), el contenido del almacenamiento intermedio se enva al servidor y se guarda all hasta que se llama a EndChain. Puede ajustar el tamao de este almacenamiento intermedio de comunicaciones con el parmetro de configuracin rqrioblk. Para un rendimiento ptimo, utilice los marcadores de parmetro en las sentencias insert, update y delete. Ejemplo [Visual Basic, C#] El ejemplo siguiente utiliza el encadenamiento para insertar 10000 filas en la tabla STAFF.
[Visual Basic] Dim con As IfxConnection = new IfxConnection("DATABASE=sample;") Dim cmd As IfxCommand = con.CreateCommand() con.Open() Initialize an insert statement using parameter markers cmd.CommandText = "INSERT INTO STAFF(ID) VALUES( ? )" Add a parameter Dim p1 As IfxParameter = cmd.Parameters.Add("@ID", IfxType.Integer ) Start the chain con.BeginChain() Try Loop to add 10000 rows Dim I As Int32 For I = 1 To 10000 Set the parameter value p1.Value = I Execute the command. Since chaining is active, this statement is now added to the chain cmd.ExecuteNonQuery() Next I Execute the chain con.EndChain() Catch db2Ex As IfxException Dim db2Error As IfxError Loop through all the errors
3-169
For Each db2Error in db2Ex.Errors Console.WriteLine("SQLSTATE =" & db2Error.SQLState ) Console.WriteLine("NativeErr=" & db2Error.NativeError ) Console.WriteLine("RowNumber=" & db2Error.RowNumber ) Console.WriteLine( db2Error.Message ) Next IfxError Finally Explicitly turn chaining off in case it is still on If (con.Chaining) Then con.EndChain() End If End Try con.Close()[C#] DB2Connection con = new IfxConnection("DATABASE=sample;"); DB2Command cmd = con.CreateCommand(); con.Open(); // Initialize an insert statement using parameter markers cmd.CommandText = "INSERT INTO STAFF(ID) VALUES( ? )"; // Add a parameter DB2Parameter p1 = cmd.Parameters.Add("@ID", IfxType.Integer ); // Start the chain con.BeginChain(); try { // Loop to add 10000 rows for( Int32 i = 1; i <= 10000; i++ ) { // Set the parameter value p1.Value = i; // Execute the command. // Since chaining is active, this statement is now added // to the chain cmd.ExecuteNonQuery(); } // Execute the chain con.EndChain(); } catch( IfxException db2Ex ) { // Loop through all the errors foreach( IfxError db2Error in db2Ex.Errors ) { Console.WriteLine("SQLSTATE =" + db2Error.SQLState ); Console.WriteLine("NativeErr=" + db2Error.NativeError ); Console.WriteLine("RowNumber=" + db2Error.RowNumber ); Console.WriteLine( db2Error.Message ); } } finally { // Explicitly turn chaining off in case it is still on if( con.Chaining ) { con.EndChain(); } } con.Close();
Consulta
3-170
Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.EndChain en la pgina 3-183 Marca el final de una cadena de sentencias insert, update y delete que se enviarn al servidor de bases de datos. Ejemplos TbUse.cs TbUse.vb Mtodo IfxConnection.BeginTransaction: Inicia una transaccin en la base de datos. Lista de sobrecargas
Nombre BeginTransaction() BeginTransaction(IsolationLevel) Descripcin Inicia una transaccin en la base de datos. Inicia una transaccin en la base de datos con el valor IsolationLevel especificado.
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection y una IfxTransaction. Tambin muestra cmo utilizar los mtodos BeginTransaction, IfxTransaction.Commit y IfxTransaction.Rollback. Nota: [Visual Basic, C#] Este ejemplo muestra cmo utilizar una de las versiones sobrecargadas de BeginTransaction. Para obtener otros ejemplos que pudieran estar disponibles, consulte los temas de sobrecarga individuales.
Visual Basic] Public Sub RunIfxTransaction(myConnString As String) Dim myConnection As New IfxConnection(myConnString) myConnection.Open() Dim myCommand As New IfxCommand() Dim myTrans As IfxTransaction Start a local transaction myTrans = myConnection.BeginTransaction(IsolationLevel.ReadCommitted) Assign transaction object for a pending local transaction myCommand.Transaction = myTrans Try myCommand.CommandText = "Insert into STAFF (ID, NAME) VALUES (...)" myCommand.ExecuteNonQuery() myCommand.CommandText = "Insert into STAFF (ID, NAME) VALUES (...)" myCommand.ExecuteNonQuery() myTrans.Commit() Console.WriteLine("Both records are written to database.")
3-171
Catch e As Exception myTrans.Rollback() Console.WriteLine(e.ToString()) Console.WriteLine("Neither record was written to database.") Finally myConnection.Close() End Try End Sub [C#] public void RunIfxTransaction(string myConnString) { IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open(); IfxCommand myCommand = new IfxCommand(); IfxTransaction myTrans; // Start a local transaction myTrans = myConnection.BeginTransaction(IsolationLevel.ReadCommitted); // Assign transaction object for a pending local transaction myCommand.Transaction = myTrans; try { myCommand.CommandText = "Insert into STAFF (ID, NAME) VALUES (...)"; myCommand.ExecuteNonQuery(); myCommand.CommandText = "Insert into STAFF (ID, NAME) VALUES (...)"; myCommand.ExecuteNonQuery(); myTrans.Commit(); Console.WriteLine("Both records are written to database."); } catch(Exception e) { myTrans.Rollback(); Console.WriteLine(e.ToString()); Console.WriteLine("Neither record was written to database."); } finally { myConnection.Close(); } }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos TbUse.cs TbUse.vb Mtodo IfxConnection.BeginTransaction (): Inicia una transaccin en la base de datos.
3-172

Visual Basic] Overloads Public Function BeginTransaction() As IfxTransaction [C#] public IfxTransaction BeginTransaction(); [C++] public: IfxTransaction * BeginTransaction(); [JScript] public function BeginTransaction() : IfxTransaction ;
Valor de retorno Un objeto que representa la nueva transaccin. Excepciones

Tipo de excepcin InvalidOperationException Condicin Una transaccin est actualmente activa. No se da soporte a transacciones paralelas.
Comentarios Para confirmar o retrotraer la transaccin, debe utilizar explcitamente IfxTransaction.Commit o IfxTransaction.Rollback . Nota: Si no especifica un nivel de aislamiento, se utilizar el nivel de aislamiento por omisin para IBM Data Server Provider for .NET. Para obtener informacin sobre cmo definir el nivel de aislamiento con el mtodo BeginTransaction, consulte Mtodo BeginTransaction (IsolationLevel). Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection y una IfxTransaction. Tambin muestra cmo utilizar BeginTransaction, IfxTransaction.Commit y IfxTransaction.Rollback .
Visual Basic] Public Sub RunIfxTransaction(myConnString As String) Dim myConnection As New IfxConnection(myConnString) myConnection.Open() Dim myCommand As New IfxCommand() Dim myTrans As IfxTransaction Start a local transaction myTrans = myConnection.BeginTransaction() Assign transaction object for a pending local transaction myCommand.Transaction = myTrans Try
3-173
myCommand.CommandText = "Insert into STAFF (ID, NAME) VALUES (...)" myCommand.ExecuteNonQuery() myCommand.CommandText = "Insert into STAFF (ID, NAME) VALUES (...)" myCommand.ExecuteNonQuery() myTrans.Commit() Console.WriteLine("Both records are written to database.") Catch e As Exception myTrans.Rollback() Console.WriteLine(e.ToString()) Console.WriteLine("Neither record was written to database.") Finally myConnection.Close() End Try End Sub [C#] public void RunIfxTransaction(string myConnString) { IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open(); IfxCommand myCommand = new IfxCommand(); IfxTransaction myTrans; // Start a local transaction myTrans = myConnection.BeginTransaction(); // Assign transaction object for a pending local transaction myCommand.Transaction = myTrans; try { myCommand.CommandText = "Insert into STAFF (ID, NAME) VALUES (...)"; myCommand.ExecuteNonQuery(); myCommand.CommandText = "Insert into STAFF (ID, NAME) VALUES (...)"; myCommand.ExecuteNonQuery(); myTrans.Commit(); Console.WriteLine("Both records are written to database."); } catch(Exception e) { myTrans.Rollback(); Console.WriteLine(e.ToString()); Console.WriteLine("Neither record was written to database."); } finally { myConnection.Close(); } }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.BeginTransaction en la pgina 3-171 Inicia una transaccin en la base de datos. Ejemplos
3-174
TbUse.cs TbUse.vb Mtodo IfxConnection.BeginTransaction (IsolationLevel): Inicia una transaccin en la base de datos con el valor IsolationLevel especificado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overloads Public Function BeginTransaction( _ ByVal isolevel As IsolationLevel _ ) As IfxTransaction [C#] public IfxTransaction BeginTransaction( IsolationLevel isolevel ); [C++] public: IfxTransaction * BeginTransaction( IsolationLevel isolevel ); [JScript] public function BeginTransaction( isolevel : IsolationLevel ) : IfxTransaction ;
Parmetros isolevel El nivel de aislamiento de transaccin para esta conexin. Si no especifica un nivel de aislamiento, se utilizar el nivel de aislamiento por omisin para IBM Data Server Provider for .NET. Valor de retorno Un objeto que representa la nueva transaccin. Excepciones
Tipo de excepcin InvalidOperationException Condicin Una transaccin est actualmente activa. No se da soporte a transacciones paralelas.
Comentarios Para confirmar o retrotraer la transaccin, debe utilizar explcitamente los mtodos IfxTransaction.Commit o IfxTransaction.Rollback.
3-175
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection y una IfxTransaction. Tambin muestra cmo utilizar BeginTransaction, IfxTransaction.Commit y IfxTransaction.Rollback .
Visual Basic] Public Sub RunIfxTransaction(myConnString As String) Dim myConnection As New IfxConnection(myConnString) myConnection.Open() Dim myCommand As New IfxCommand() Dim myTrans As IfxTransaction Start a local transaction myTrans = myConnection.BeginTransaction(IsolationLevel.ReadCommitted) Assign transaction object for a pending local transaction myCommand.Transaction = myTrans Try myCommand.CommandText = "Insert into STAFF (ID, NAME) VALUES (...)" myCommand.ExecuteNonQuery() myCommand.CommandText = "Insert into STAFF (ID, NAME) VALUES (...)" myCommand.ExecuteNonQuery() myTrans.Commit() Console.WriteLine("Both records are written to database.") Catch e As Exception myTrans.Rollback() Console.WriteLine(e.ToString()) Console.WriteLine("Neither record was written to database.") Finally myConnection.Close() End Try End Sub [C#] public void RunIfxTransaction(string myConnString) { IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open(); IfxCommand myCommand = new IfxCommand(); IfxTransaction myTrans; // Start a local transaction myTrans = myConnection.BeginTransaction(IsolationLevel.ReadCommitted); // Assign transaction object for a pending local transaction myCommand.Transaction = myTrans; try { myCommand.CommandText = "Insert into STAFF (ID, NAME) VALUES (...)"; myCommand.ExecuteNonQuery(); myCommand.CommandText = "Insert into STAFF (ID, NAME) VALUES (...)"; myCommand.ExecuteNonQuery(); myTrans.Commit(); Console.WriteLine("Both records are written to database."); } catch(Exception e) { myTrans.Rollback(); Console.WriteLine(e.ToString()); Console.WriteLine("Neither record was written to database."); } finally
3-176
{ myConnection.Close(); } }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.BeginTransaction en la pgina 3-171 Inicia una transaccin en la base de datos. Mtodo IfxTransaction.Commit en la pgina 3-706 Confirma la transaccin de base de datos. Mtodo IfxTransaction.Rollback en la pgina 3-709 Retrotrae una transaccin desde un estado pendiente. Mtodo IfxConnection.ChangeDatabase: Cambia la base de datos actual asociada con una IfxConnection abierta. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Public Sub ChangeDatabase( _ ByVal value As String _ ) Implements IDbConnection.ChangeDatabase [C#] public void ChangeDatabase( string value ); [C++] public: __sealed void ChangeDatabase( String* value ); [JScript] public function ChangeDatabase( value : String );
Implementa: IDbConnection.ChangeDatabase Parmetros value El nombre de la base de datos.
3-177
Excepciones
Tipo de excepcin ArgumentException InvalidOperationException IfxException Condicin El nombre de la base de datos no es vlido. La conexin no est abierta. No se puede cambiar la base de datos.
Comentarios El parmetro value debe contener un nombre de base de datos vlido, y no puede contener un valor nulo, una serie vaca () ni una serie con slo caracteres en blanco. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection y cambia la base de datos actual.
Visual Basic] Public Sub CreateIfxConnection() Dim myConnString As String = _ "DATABASE=SAMPLE" Dim myConnection As New IfxConnection(myConnString) myConnection.Open() myConnection.ChangeDatabase("SAMPLE2") MessageBox.Show("Database: " + myConnection.Database.ToString()) myConnection.Close()[C#] public void CreateIfxConnection() { string myConnString = "DATABASE=SAMPLE"; IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open(); myConnection.ChangeDatabase("SAMPLE2"); MessageBox.Show("Database: " + myConnection.Database.ToString()); myConnection.Close(); }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.Database en la pgina 3-208 Obtiene el nombre de la base de datos actual o de la base de datos que se va a utilizar despus de abrir una conexin. Mtodo IfxConnection.Close: Cierra la conexin con la base de datos. Este es el mtodo preferido de cerrar cualquier conexin abierta.
3-178

Visual Basic] NotOverridable Public Sub Close() Implements IDbConnection.Close [C#] public void Close(); [C++] public: __sealed void Close(); [JScript] public function Close();
Implementa: IDbConnection.Close Comentarios El mtodo Close retrotrae cualquier transaccin pendiente. A continuacin, libera la conexin con la agrupacin de conexiones o cierra la conexin si el agrupamiento de conexiones est inhabilitado. Si se invoca Close mientras se trata un StateChange, no se emiten sucesos StateChange adicionales. Una aplicacin puede invocar Close ms de una vez sin generar una excepcin. Nota: Cuando utiliza IBM Data Server Provider for .NET, no necesita habilitar la agrupacin de conexiones, pues est activada por omisin. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection, la abre, muestra algunas de sus propiedades y, a continuacin, cierra la conexin.
Visual Basic] Public Sub CreateIfxConnection(myConnString As String) Dim myConnection As New IfxConnection(myConnString) myConnection.Open() MessageBox.Show("State: " + myConnection.State.ToString()) myConnection.Close() End Sub [C#] public void CreateIfxConnection(string myConnString) { IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open(); MessageBox.Show("State: " + myConnection.State.ToString()); myConnection.Close(); }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-179
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.Open en la pgina 3-193 Abre una conexin con una base de datos con los valores de propiedad especificados por ConnectionString. Ejemplos DbUse.cs DbUse.vb Mtodo IfxConnection.CreateCommand: Crea y devuelve un objeto IfxCommand asociado con IfxConnection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function CreateCommand() As IfxCommand [C#] public IfxCommand CreateCommand(); [C++] public: IfxCommand * CreateCommand(); [JScript] public function CreateCommand() : IfxCommand ;
Valor de retorno Un objeto IfxCommand. Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos TbUse.cs TbUse.vb Mtodo IfxConnection.Dispose: Libera los recursos utilizados por IfxConnection.
3-180
Nombre Dispose(Boolean) Descripcin Libera los recursos no gestionados y, opcionalmente, los gestionados utilizados por IfxConnection. Heredado de Component.
Dispose()
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection y luego se deshace de la misma. Nota: [Visual Basic, C#] Este ejemplo muestra cmo utilizar una de las versiones sobrecargadas de Dispose. Para obtener otros ejemplos que pudieran estar disponibles, consulte los temas de sobrecarga individuales.
Visual Basic] Public Sub IfxConnectionHereAndGone() Dim myConnection As New IfxConnection() myConnection.Open() Calling Dispose also calls IfxConnection.Close. myConnection.Dispose() End Sub [C#] public void IfxConnectionHereAndGone() { IfxConnection myConnection = new IfxConnection(); myConnection.Open(); //Calling Dispose also calls IfxConnection.Close. myConnection.Dispose(); }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.Dispose (Boolean): Libera los recursos no gestionados y, opcionalmente, los gestionados utilizados por IfxConnection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-181
Sintaxis
Parmetros disposing Comentarios El mtodo pblico Dispose y el mtodo Finalize llaman a este mtodo. Dispose() invoca al mtodo protegido Dispose(Boolean) con el parmetro disposing establecido en true. Finalize invoca a Dispose con disposing establecido en false. Cuando el parmetro disposing es true, el mtodo libera todos los recursos retenidos por cualquier objetos gestionado referenciado por este IfxCommand. Lo hace invocando el mtodo Dispose() de cada objeto referenciado. Notas para los herederos: Otros objetos pueden llamar varias veces a Dispose. Al alterar temporalmente Dispose(Boolean), tenga cuidado de no hacer referencia a objetos que se hayan desechado anteriormente en una llamada previa a Dispose. Para obtener ms informacin sobre cmo implementar Dispose(Boolean), consulte Implementacin del mtodo Dispose en la documentacin del SDK de Microsoft(R) .NET. Llamar a Dispose en un objeto IfxConnection es diferente de llamar a Close. Por ejemplo, Dispose borra la serie de caracteres de conexin mientras que Close no la borra. Para obtener ms informacin acerca de Dispose y Finalize, consulte Limpieza de recursos no gestionados y Alteracin temporal del mtodo Finalize en la documentacin del SDK de .NET Framework. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection y, a continuacin, se deshace de la misma.
Visual Basic] Public Sub IfxConnectionHereAndGone() Dim myConnection As New IfxConnection() myConnection.Open() Calling Dispose also calls IfxConnection.Close.
3-182
myConnection.Dispose() End Sub [C#] public void IfxConnectionHereAndGone() { IfxConnection myConnection = new IfxConnection(); myConnection.Open(); //Calling Dispose also calls IfxConnection.Close. myConnection.Dispose(); }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.Dispose en la pgina 3-180 Libera los recursos utilizados por IfxConnection. Mtodo IfxConnection.DropDTD: Elimina la DTD registrada en la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Parmetros Valor de retorno Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.EndChain: Marca el final de una cadena de sentencias insert, update y delete que se enviarn al servidor de bases de datos.
3-183

Visual Basic] Public Sub EndChain() [C#] public void EndChain(); [C++] public: void EndChain(); [JScript] public function EndChain();
Comentarios Para ejecutar todas las sentencias acumuladas desde la llamada al mtodo BeginChain, llame al mtodo EndChain. Ejemplo [Visual Basic, C#] El ejemplo siguiente utiliza el encadenamiento para insertar 10000 filas en la tabla STAFF.
Visual Basic] Dim con As IfxConnection = new IfxConnection("DATABASE=sample;") Dim cmd As IfxCommand = con.CreateCommand() con.Open() Initialize an insert statement using parameter markers cmd.CommandText = "INSERT INTO STAFF(ID) VALUES( ? )" Add a parameter Dim p1 As IfxParameter = cmd.Parameters.Add("@ID", IfxType.Integer ) Start the chain con.BeginChain() Try Loop to add 10000 rows Dim I As Int32 For I = 1 To 10000 Set the parameter value p1.Value = I Execute the command. Since chaining is active, this statement is now added to the chain cmd.ExecuteNonQuery() Next I Execute the chain con.EndChain() Catch db2Ex As IfxException Dim db2Error As IfxError Loop through all the errors For Each db2Error in db2Ex.Errors Console.WriteLine("SQLSTATE =" & db2Error.SQLState ) Console.WriteLine("NativeErr=" & db2Error.NativeError ) Console.WriteLine("RowNumber=" & db2Error.RowNumber ) Console.WriteLine( db2Error.Message ) Next IfxError
3-184
Finally Explicitly turn chaining off in case it is still on If (con.Chaining) Then con.EndChain() End If End Try con.Close()[C#] DB2Connection con = new IfxConnection("DATABASE=sample;"); DB2Command cmd = con.CreateCommand(); con.Open(); // Initialize an insert statement using parameter markers cmd.CommandText = "INSERT INTO STAFF(ID) VALUES( ? )"; // Add a parameter DB2Parameter p1 = cmd.Parameters.Add("@ID", IfxType.Integer ); // Start the chain con.BeginChain(); try { // Loop to add 10000 rows for( Int32 i = 1; i <= 10000; i++ ) { // Set the parameter value p1.Value = i; // Execute the command. // Since chaining is active, this statement is now added // to the chain cmd.ExecuteNonQuery(); } // Execute the chain con.EndChain(); } catch( IfxException db2Ex ) { // Loop through all the errors foreach( IfxError db2Error in db2Ex.Errors ) { Console.WriteLine("SQLSTATE =" + db2Error.SQLState ); Console.WriteLine("NativeErr=" + db2Error.NativeError ); Console.WriteLine("RowNumber=" + db2Error.RowNumber ); Console.WriteLine( db2Error.Message ); } } finally { // Explicitly turn chaining off in case it is still on if( con.Chaining ) { con.EndChain(); } } con.Close();
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection.
3-185
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.BeginChain en la pgina 3-168 Marca el inicio de una cadena de sentencias insert, update y delete que se enviarn al servidor de bases de datos. Mtodo IfxConnection.EnlistDistributedTransaction: Inscribe en la transaccin especificada como transaccin distribuida. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub EnlistDistributedTransaction( _ ByVal transaction As ITransaction _ ) [C#] public void EnlistDistributedTransaction( ITransaction transaction ); [C++] public: void EnlistDistributedTransaction( ITransaction* transaction ); [JScript] public function EnlistDistributedTransaction( transaction : ITransaction );
Parmetros transaction Una referencia a una transaccin existente en la que inscribir. Comentarios Puede inscribir en una transaccin distribuida existente utilizando el mtodo EnlistDistributedTransaction si la inscripcin automtica est inhabilitada. La inscripcin en una transaccin distribuida garantiza que, si la transaccin se confirma o se retrotrae, las modificaciones que realiza el cdigo en la fuente de datos tambin se confirman o se retrotraen. PRECAUCIN: EnlistDistributedTransaction devuelve una excepcin si la IfxConnection ya ha iniciado una transaccin utilizando BeginTransaction. Sin embargo, si la transaccin es una transaccin local iniciada en la fuente de datos (por ejemplo, ejecutando explcitamente la sentencia BEGIN TRANSACTION mediante un objeto IfxCommand), EnlistDistributedTransaction retrotrae la transaccin local e inscribe en la transaccin distribuida existente, segn se solicite. El usuario no recibe aviso de que la transaccin local se ha retrotrado, y debe utilizar BeginTransaction para gestionar las transacciones locales no iniciadas.
3-186
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.GetDTD: Obtiene la DTD registrada en la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Parmetros Valor de retorno Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.GetSchema: Devuelve una DataTable con metadatos para la fuente de datos asociada con esta instancia de IfxConnection. Lista de sobrecargas
Nombre GetSchema() Descripcin Devuelve una DataTable con metadatos para la fuente de datos asociada con esta instancia de IfxConnection. Devuelve una DataTable con un conjunto especificado de metadatos para la fuente de datos asociada con esta instancia de IfxConnection.
GetSchema(String)
3-187
Nombre GetSchema(String, String[])
Descripcin Devuelve una DataTable con un conjunto especificado de metadatos para la fuente de datos asociada con esta instancia de IfxConnection.
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.GetSchema (): Devuelve una DataTable con metadatos para la fuente de datos asociada con esta instancia de IfxConnection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function GetSchema As DataTable [C#] public override DataTable GetSchema () [C++] public: virtual DataTable^ GetSchema () override [JScript] public override function GetSchema () : DataTable
Valor de retorno instancia de DataTable, que contiene metadatos para la fuente de datos asociada con esta instancia de IfxConnection. Ejemplo [C#] La siguiente lnea de cdigo demuestra cmo recuperar los metadatos disponibles para la fuente de datos asociada con esta instancia de IfxConnection. Esta sobrecarga particular de GetSchema (sin parmetros) da como resultado la recuperacin de una lista de las colecciones de metadatos soportados para la fuente de datos.
3-188
[C#] DataTable table2 = conn.GetSchema();
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.GetSchema (String): Devuelve una DataTable con un conjunto especificado de metadatos para la fuente de datos asociada con esta instancia de IfxConnection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function GetSchema ( _ collectionName As String _ ) As DataTable [C#] public override DataTable GetSchema ( string collectionName ); [C++] public: virtual DataTable^ GetSchema ( String collectionName ) override [JScript] public override function GetSchema ( collectionName : String ) : DataTable
Parmetros collectionName Especifica el conjunto de metadatos fuente de datos que se deben devolver. La tabla siguiente lista las propiedades de series de caracteres de solo lectura que puede utilizar para identificar la coleccin de metadatos que GetSchema devolver.
Nombre de la coleccin IfxMetaDataCollectionNames.MetaDataCollections Descripcin Lista de colecciones de metadatos soportadas por IBM Data Provider for .NET.
3-189
Nombre de la coleccin IfxMetaDataCollectionNames.Restrictions
Descripcin Para cada coleccin de metadatos, lista de calificadores que puede utilizar para restringir el alcance de los metadatos solicitados. Informacin acerca de la fuente de datos asociada con esta instancia de IfxConnection. Lista de todos los tipos de datos soportados por las bases de datos de la familia DB2. Lista de todas las palabras reservadas para el dialecto de SQL de la familia DB2. Lista de las tablas de la fuente de datos asociada con esta instancia de IfxConnection. Lista de los privilegios de la tabla de la fuente de datos asociada con esta instancia de IfxConnection. Lista de las columnas de la tabla de la fuente de datos asociada con esta instancia de IfxConnection. Lista de los privilegios de la columna de la fuente de datos asociada con esta instancia de IfxConnection. Lista de los procedimientos almacenados de la fuente de datos asociada con esta instancia de IfxConnection. Lista de los parmetros de procedimiento almacenado de la fuente de datos asociada con esta instancia de IfxConnection. Lista de las claves primarias de la tabla de la fuente de datos asociada con esta instancia de IfxConnection. Lista de las claves forneas de la tabla de la fuente de datos asociada con esta instancia de IfxConnection. Lista de los ndices de la fuente de datos asociada con esta instancia de IfxConnection. Lista de los esquemas de la fuente de datos asociada con esta instancia de IfxConnection.
IfxMetaDataCollectionNames.DataSourceInformation IfxMetaDataCollectionNames.DataTypes IfxMetaDataCollectionNames.ReservedWords IfxMetaDataCollectionNames.Tables IfxMetaDataCollectionNames.TablePrivileges
IfxMetaDataCollectionNames.Columns
IfxMetaDataCollectionNames.ColumnPrivileges
IfxMetaDataCollectionNames.Procedures
IfxMetaDataCollectionNames.ProcedureParameters
IfxMetaDataCollectionNames.PrimaryKeys
IfxMetaDataCollectionNames.ForeignKeys
IfxMetaDataCollectionNames.Indexes IfxMetaDataCollectionNames.Schemas
Valor de retorno instancia de DataTable, que contiene informacin sobre las bases de datos visibles de la familia DB2. Ejemplo [C#] La siguiente lnea de cdigo demuestra cmo recuperar los metadatos disponibles para la fuente de datos asociada con esta instancia de IfxConnection. El uso de esta sobrecarga determinada de GetSchema (con un parmetro String) da como resultado la recuperacin de una lista de procedimientos almacenados catalogados en la fuente de datos.
3-190
[C#] DataTable proctable = conn.GetSchema(IfxMetaDataCollectionNames.Procedures);
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.GetSchema (String, String[]): Devuelve una DataTable con un conjunto especificado de metadatos para la fuente de datos asociada con esta instancia de IfxConnection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function GetSchema ( _ collectionName As String, _ restrictionValues As String() _ ) As DataTable [C#] public override DataTable GetSchema ( string collectionName, string[] restrictionValues ); [C++] public: virtual DataTable^ GetSchema ( String collectionName, array<String^>^ restrictionValues ) override [JScript] public override function GetSchema ( collectionName : String, restrictionValues : String[] ) : DataTable
Parmetros collectionName Especifica el conjunto de metadatos fuente de datos que se deben devolver. La tabla siguiente lista las propiedades de series de caracteres de solo lectura que puede utilizar para identificar la coleccin de metadatos que GetSchema devolver.
3-191
Nombre de la coleccin IfxMetaDataCollectionNames.MetaDataCollections IfxMetaDataCollectionNames.Restrictions
Descripcin Lista de colecciones de metadatos soportadas por IBM Data Provider for .NET. Para cada coleccin de metadatos, lista de calificadores que puede utilizar para restringir el alcance de los metadatos solicitados. Informacin acerca de la fuente de datos asociada con esta instancia de IfxConnection. Lista de todos los tipos de datos soportados por las bases de datos de la familia DB2. Lista de todas las palabras reservadas para el dialecto de SQL de la familia DB2. Lista de las tablas de la fuente de datos asociada con esta instancia de IfxConnection. Lista de los privilegios de la tabla de la fuente de datos asociada con esta instancia de IfxConnection. Lista de las columnas de la tabla de la fuente de datos asociada con esta instancia de IfxConnection. Lista de los privilegios de la columna de la fuente de datos asociada con esta instancia de IfxConnection. Lista de los procedimientos almacenados de la fuente de datos asociada con esta instancia de IfxConnection. Lista de los parmetros de procedimiento almacenado de la fuente de datos asociada con esta instancia de IfxConnection. Lista de las claves primarias de la tabla de la fuente de datos asociada con esta instancia de IfxConnection. Lista de las claves forneas de la tabla de la fuente de datos asociada con esta instancia de IfxConnection. Lista de los ndices de la fuente de datos asociada con esta instancia de IfxConnection. Lista de los esquemas de la fuente de datos asociada con esta instancia de IfxConnection.
IfxMetaDataCollectionNames.DataSourceInformation IfxMetaDataCollectionNames.DataTypes IfxMetaDataCollectionNames.ReservedWords IfxMetaDataCollectionNames.Tables IfxMetaDataCollectionNames.TablePrivileges
IfxMetaDataCollectionNames.Columns
IfxMetaDataCollectionNames.ColumnPrivileges
IfxMetaDataCollectionNames.Procedures
IfxMetaDataCollectionNames.ProcedureParameters
IfxMetaDataCollectionNames.PrimaryKeys
IfxMetaDataCollectionNames.ForeignKeys
IfxMetaDataCollectionNames.Indexes IfxMetaDataCollectionNames.Schemas
restrictionValues Puede refinar el conjunto de metadatos devuelto por el mtodo GetSchema asignando valores para las restricciones especficas de la coleccin de metadatos aplicables. Pase estos valores de restricciones al mtodo GetSchema como una matriz String. Para ver la lista de restricciones para cada coleccin de metadatos, lea la DataTable generada por el siguiente cdigo:
DataTable resttable = conn.GetSchema(IfxMetaDataCollectionNames.Restrictions);
3-192
Valor de retorno instancia de DataTable, que contiene informacin sobre las bases de datos visibles de la familia DB2. Ejemplo [C#] La siguiente lnea de cdigo demuestra cmo recuperar los metadatos disponibles para la fuente de datos asociada con esta instancia de IfxConnection. El uso de esta sobrecarga determinada de GetSchema (con un parmetro String y un parmetro de matriz String) da como resultado la recuperacin de una lista de las tablas de la fuente de datos asociada con el esquema ERIK.
[C#] DataTable eriktab = conn.GetSchema(IfxMetaDataCollectionNames.Tables, new string[4] { null, "ERIK", null, null } );
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.Open: Abre una conexin con una base de datos con los valores de propiedad especificados por ConnectionString. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Public Sub Open() Implements IDbConnection.Open [C#] public void Open(); [C++] public: __sealed void Open(); [JScript] public function Open();
Implementa: IDbConnection.Open
3-193
Excepciones
Tipo de excepcin InvalidOperationException IfxException Condicin La conexin ya est abierta. Se ha producido un error de nivel de conexin al abrir la conexin.
Comentarios IfxConnection obtiene una conexin abierta de la agrupacin de conexiones si la agrupacin de conexiones est activada y hay disponible una conexin. En otro caso, establece una nueva conexin con la base de datos. Nota: Si IfxConnection queda fuera del mbito, la conexin que representa no se cierra automticamente. Por tanto, debe cerrar explcitamente la conexin invocando Close o Dispose. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection, la abre, muestra algunas de sus propiedades y, a continuacin, cierra la conexin.
[Visual Basic] Public Sub CreateIfxConnection(myConnString As String) Dim myConnection As New IfxConnection(myConnString) myConnection.Open() MessageBox.Show("ServerVersion: " + myConnection.ServerVersion _ + ControlChars.Cr + "State: " + myConnection.State.ToString()) myConnection.Close() End Sub [C#] public void CreateIfxConnection(string myConnString) { IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open(); MessageBox.Show("ServerVersion: " + myConnection.ServerVersion + "\nState: " + myConnection.State.ToString()); myConnection.Close(); }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.Close en la pgina 3-178 Cierra la conexin con la base de datos. Este es el mtodo preferido de cerrar cualquier conexin abierta. Ejemplos TbUse.cs TbUse.vb
3-194
Mtodo IfxConnection.RegisterDTD: Registra la DTD en la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Parmetros Valor de retorno Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.ReleaseObjectPool: Indica que los recursos de la agrupacin de conexiones se pueden liberar cuando la ltima conexin subyacente se libere. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Sub ReleaseObjectPool() [C#] public static void ReleaseObjectPool(); [C++] public: static void ReleaseObjectPool(); [JScript] public static function ReleaseObjectPool();
Comentarios Se puede llamar a ReleaseObjectPool para liberar los recursos de la agrupacin de conexiones. Puede llamar a este mtodo si, por ejemplo, el objeto de conexin no se va a volver a utilizar. Cuando todas las conexiones de la agrupacin estn cerradas, se puede eliminar la agrupacin. Tenga en cuenta que simplemente llamar al mtodo no libera en realidad las conexiones activas que existan en la agrupacin. Lo siguiente se debe producir antes de disponer de la agrupacin finalmente: 1. Llame a Close para liberar el objeto IfxConnection del entorno.
3-195
2. Deje que cada objeto de conexin exceda el tiempo de espera. 3. Invoque ReleaseObjectPool. 4. Invoque la recogida de basura. En cambio, si invoca Close para todas las conexiones activas e invoca la recogida de basura, pero no invoca ReleaseObjectPool, los recursos reservados para la agrupacin seguirn estando disponibles. Despus de liberar una agrupacin, cuando se realiza una peticin para una nueva IfxConnection, se crea una nueva agrupacin. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection, la abre, visualiza algunas de sus propiedades, cierra la conexin y libera la agrupacin de objetos para conservar recursos.
Visual Basic] Public Sub CreateIfxConnection(myConnString As String) Dim myConnection As New IfxConnection(myConnString) myConnection.Open() MessageBox.Show("State: " + myConnection.State.ToString()) myConnection.Close() IfxConnection.ReleaseObjectPool() End Sub [C#] public void CreateIfxConnection(string myConnString) { IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open(); MessageBox.Show("State: " + myConnection.State.ToString()); myConnection.Close(); IfxConnection.ReleaseObjectPool(); }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de conexin de Ifx

Las propiedades de la clase IfxConnection se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxConnection, consulte el tema IfxConnection Members.
Propiedades pblicas
CacheData Obtiene o establece un valor booleano que indica si se utiliza la colocacin de datos en antememoria.
3-196
Chaining ClientAccountingInformation ClientApplicationInformation ClientUser ClientWorkstation
Obtiene un valor booleano que indica que el encadenamiento est activo. Obtiene o establece la serie de caracteres que contiene la serie de contabilidad del cliente. Obtiene o establece la serie de caracteres que contiene el nombre de la aplicacin cliente. Obtiene o establece la serie de caracteres que contiene el ID de usuario del cliente. Obtiene o establece la serie de caracteres que contiene el nombre de la estacin de trabajo cliente. Obtiene o establece la serie de caracteres utilizada para abrir una conexin de base de datos. Obtiene el IContainer que contiene el Component. Obtiene o establece un valor que determina el lmite de tiempo que una aplicacin debe esperar para establecer una conexin. Obtiene el nombre de la base de datos actual o de la base de datos que se va a utilizar despus de abrir una conexin. Obtiene el nombre de la base de datos actual o de la base de datos que se va a utilizar despus de abrir una conexin. Obtiene una serie de caracteres que contiene la versin del servidor al que est conectado el cliente. Obtiene una serie de caracteres que contiene la versin secundaria del servidor al que est conectado el cliente. Obtiene una serie de caracteres que contiene la versin principal del servidor al que est conectado el cliente. Obtiene una serie de caracteres que contiene la versin de revisin del servidor al que est conectado el cliente. Obtiene una serie que contiene el tipo de servidor al que el cliente est conectado. Obtiene una serie de caracteres que contiene la versin del servidor al que est conectado el cliente. Obtiene o establece el ISite de Component.
ConnectionString
Container (heredada de Component) ConnectionTimeout
Database
DataSource
ServerBuildVersion
ServerMinorVersion
ServerMajorVersion
ServerRevisionVersion
ServerType ServerVersion
Site (heredada de Component) Obtiene el estado actual de la conexin. State
3-197
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.CacheData: Obtiene o establece un valor booleano que indica si se utiliza la colocacin de datos en antememoria. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property CacheData As Boolean [C#] public bool CacheData {get;} [C++] public: __property bool get_CacheData(); [JScript] public function get CacheData() : Boolean;
Valor de la propiedad True si el encadenamiento est activo; de lo contrario, false. Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.Chaining:
3-198
Obtiene un valor booleano que indica que el encadenamiento est activo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Chaining As Boolean [C#] public bool Chaining {get;} [C++] public: __property bool get_Chaining(); [JScript] public function get Chaining() : Boolean;
Valor de la propiedad True si el encadenamiento est activo. El encadenamiento est activo para un objeto IfxConnection si la aplicacin ha llamado al mtodo BeginChain del objeto pero no ha llamado a su mtodo EndChain. False si el encadenamiento no est activo. Ejemplo [Visual Basic, C#] El ejemplo siguiente utiliza el encadenamiento para insertar 10000 filas en la tabla STAFF.
Visual Basic] Dim con As IfxConnection = new IfxConnection("DATABASE=sample;") Dim cmd As IfxCommand = con.CreateCommand() con.Open() Initialize an insert statement using parameter markers cmd.CommandText = "INSERT INTO STAFF(ID) VALUES( ? )" Add a parameter Dim p1 As IfxParameter = cmd.Parameters.Add("@ID", IfxType.Integer ) Start the chain con.BeginChain() Try Loop to add 10000 rows Dim I As Int32 For I = 1 To 10000 Set the parameter value p1.Value = I Execute the command. Since chaining is active, this statement is now added to the chain cmd.ExecuteNonQuery() Next I Execute the chain con.EndChain() Catch db2Ex As IfxException Dim db2Error As IfxError Loop through all the errors
3-199
For Each db2Error in db2Ex.Errors Console.WriteLine("SQLSTATE =" & db2Error.SQLState ) Console.WriteLine("NativeErr=" & db2Error.NativeError ) Console.WriteLine("RowNumber=" & db2Error.RowNumber ) Console.WriteLine( db2Error.Message ) Next IfxError Finally Explicitly turn chaining off in case it is still on If (con.Chaining) Then con.EndChain() End If End Try con.Close()[C#] DB2Connection con = new IfxConnection("DATABASE=sample;"); DB2Command cmd = con.CreateCommand(); con.Open(); // Initialize an insert statement using parameter markers cmd.CommandText = "INSERT INTO STAFF(ID) VALUES( ? )"; // Add a parameter DB2Parameter p1 = cmd.Parameters.Add("@ID", IfxType.Integer ); // Start the chain con.BeginChain(); try { // Loop to add 10000 rows for( Int32 i = 1; i <= 10000; i++ ) { // Set the parameter value p1.Value = i; // Execute the command. // Since chaining is active, this statement is now added // to the chain cmd.ExecuteNonQuery(); } // Execute the chain con.EndChain(); } catch( IfxException db2Ex ) { // Loop through all the errors foreach( IfxError db2Error in db2Ex.Errors ) { Console.WriteLine("SQLSTATE =" + db2Error.SQLState ); Console.WriteLine("NativeErr=" + db2Error.NativeError ); Console.WriteLine("RowNumber=" + db2Error.RowNumber ); Console.WriteLine( db2Error.Message ); } } finally { // Explicitly turn chaining off in case it is still on if( con.Chaining ) { con.EndChain(); } } con.Close();
Consulta
3-200
Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.BeginChain en la pgina 3-168 Marca el inicio de una cadena de sentencias insert, update y delete que se enviarn al servidor de bases de datos. Propiedad IfxConnection.ClientAccountingInformation: Obtiene o establece la serie de caracteres que contiene la serie de contabilidad del cliente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property ClientAccountingInformation As String [C#] public string ClientAccountingInformation {get; set;} [C++] public: __property String* get_ClientAccountingInformation(); public: __property void set_ClientAccountingInformation(String*); [JScript] public function get ClientAccountingInformation() : String; public function set ClientAccountingInformation(String);
Valor de la propiedad La serie de contabilidad de cliente. El valor por omisin es una serie de caracteres vaca (). Este valor slo cambia cuando la aplicacin lo actualiza explcitamente. Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.ClientApplicationInformation: Obtiene o establece la serie de caracteres que contiene el nombre de la aplicacin cliente.
3-201

Visual Basic] Public Property ClientApplicationInformation As String [C#] public string ClientApplicationInformation {get; set;} [C++] public: __property String* get_ClientApplicationInformation(); public: __property void set_ClientApplicationInformation(String*); [JScript] public function get ClientApplicationInformation() : String; public function set ClientApplicationInformation(String);
Valor de la propiedad El nombre de aplicacin de cliente. El valor por omisin es una serie de caracteres vaca (). Este valor slo cambia cuando la aplicacin lo actualiza explcitamente. Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.ClientUser: Obtiene o establece la serie de caracteres que contiene el ID de usuario del cliente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property ClientUser As String [C#] public string ClientUser {get; set;} [C++] public: __property String* get_ClientUser(); public: __property void set_ClientUser(String*); [JScript] public function get ClientUser() : String; public function set ClientUser(String);
Valor de la propiedad El ID de usuario de cliente. El valor por omisin es una serie de caracteres vaca (). Este valor slo cambia cuando la aplicacin lo actualiza explcitamente.
3-202
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.ClientWorkStation: Obtiene o establece la serie de caracteres que contiene el nombre de la estacin de trabajo cliente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property ClientWorkStation As String [C#] public string ClientWorkStation {get; set;} [C++] public: __property String* get_ClientWorkStation(); public: __property void set_ClientWorkStation(String*); [JScript] public function get ClientWorkStation() : String; public function set ClientWorkStation(String);
Valor de la propiedad El nombre de la estacin de trabajo de cliente. El valor por omisin es una serie de caracteres vaca (). Este valor slo cambia cuando la aplicacin lo actualiza explcitamente. Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.ConnectionString: Obtiene o establece la serie de caracteres utilizada para abrir una conexin de base de datos. Espacio de nombres: IBM.Data.Informix
3-203

Visual Basic] Public Property ConnectionString As String Implements _ IDbConnection.ConnectionString [C#] public string ConnectionString {get; set;} [C++] public: __property String* get_ConnectionString(); public: __property void set_ConnectionString(String*); [JScript] public function get ConnectionString() : String; public function set ConnectionString(String);
Implementa: IDbConnection.ConnectionString Valor de la propiedad La serie de conexin que incluye valores, tales como el nombre de la base de datos, necesarios para establecer la conexin inicial. El valor por omisin es una serie de caracteres vaca (). La longitud mxima es 1024 caracteres. Comentarios La ConnectionString se puede establecer solamente cuando la conexin se cierra. Puede utilizar la propiedad ConnectionString para conectar con cualquier servidor de datos soportado. Las palabras clave soportadas son las siguientes. Nota: Las palabras clave no son sensibles a las maysculas y minsculas.
Palabra clave Database User ID; UID Password; PWD Server Authentication SERVER Valor por omisin Descripcin alias de base de datos (para base de datos catalogada) ID de usuario contrasea nombre de servidor con nmero de puerto opcional para conexin directa (<nombre de servidor/direccin IP>[:<puerto>]) Tipo de autenticacin que se debe utilizar. Valores aceptables: v SERVER v SERVER_ENCRYPT v DATA_ENCRYPT v KERBEROS v GSSPLUGIN Connection Lifetime Connection Reset 60 false la cantidad de tiempo (segundos) que la conexin puede permanecer inactiva en la agrupacin de conexiones true - esta conexin en particular se colocar en la agrupacin de conexiones cuando se cierre false - esta conexin en particular no se colocar en la agrupacin de conexiones cuando se cierre
3-204
Palabra clave Connection Timeout; Connect Timeout; Timeout
Valor por omisin Descripcin 0 El tiempo (en segundos) que se debe esperar para que se establezca la conexin con la base de datos. El valor 0 indica que no existe ningn lmite de tiempo para establecer la conexin con la base de datos. Si el redireccionamiento del cliente est habilitado, el tiempo mximo de espera ser aproximadamente el doble del tiempo de espera de conexin especificado, pues habr un segundo intento de conexin con el servidor alternativo. nombre de esquema; todos los objetos de SQL no calificados utilizados con la conexin actual, se calificarn con este nombre de esquema true true - Se permite la inscripcin a Distributed Transaction Coordinator (DTC) (slo habr inscripcin si hay una transaccin COM+ en progreso en el momento de la conexin) false - No se permite la inscripcin a Distributed Transaction Coordinator (DTC)
CurrentSchema Enlist
Interrupt
Modalidad de proceso de interrupciones. Estos son los valores de palabra clave vlidos: 0 1 Inhabilita el proceso de interrupciones. Se admite la utilizacin de interrupciones. En esta modalidad, si el servidor puede admite la utilizacin de interrupciones, se enviar una interrupcin. En otro caso, se cierra la conexin. La emisin de un interrupcin produce el cierre de una conexin, sin importar si el servidor puede o no manejar excepciones.
2 Isolation Level; IsolationLevel
nivel de aislamiento para la conexin. Valores posibles: v ReadCommitted v ReadUncommitted v RepeatableRead v Serializable Esta palabra clave slo est soportada para aplicaciones que participan en una transaccin distribuida, tal como una aplicacin COM+. Para aplicaciones que no participan en una transaccin distribuida, esta palabra clave no est soportada y se emite una excepcin InvalidArgument.
Max Pool Size Min Pool Size Persist Security Info
sin mximo 0 false
tamao mximo de agrupacin tamao mnimo de agrupacin true - permite devolver informacin sensible a la seguridad, tal como la contrasea, formando parte de la serie de conexin despus de que la conexin se haya abierto o si la conexin nunca ha estado en estado de abierto. false - no se devuelve informacin sensible a la seguridad, formando parte de la serie de conexin. Se recomienda encarecidamente false.
Pooling
true
conmutador de agrupacin de conexiones (true/false)
Muchos de los valores especificados en la serie de caracteres tienen propiedades correspondientes de slo lectura, (por ejemplo, DATABASE=MyDB, que corresponde a la propiedad >Database). Cuando se define la serie de caracteres de conexin, todas estas propiedades se actualizan, excepto cuando se detecta un error. En ese caso, no se actualiza ninguna de las propiedades. Las propiedades de IfxConnection (tales como Database) solo devuelven valores por omisin o los valores especificados en ConnectionString.
3-205
La validacin de la serie de conexin se produce cuando sta se establece. El restablecimiento de ConnectionString en una conexin cerrada restablece todos los valores de serie de conexin (y las propiedades relacionadas), incluyendo la contrasea. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection y define algunas de sus propiedades en la serie de conexin.
[Visual Basic] Public Sub CreateIfxConnection() Dim myConnString As String = _ "DATABASE=SAMPLE;" Dim myConnection As New IfxConnection(myConnString) myConnection.Open() MessageBox.Show("ServerVersion: " + myConnection.ServerVersion _ + ControlChars.Cr + "Database: " + myConnection.Database.ToString()) myConnection.Close() End Sub [C#] public void CreateIfxConnection() { string myConnString = "DATABASE=SAMPLE;"; IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open(); MessageBox.Show("ServerVersion: " + myConnection.ServerVersion + "\nDatabase: " + myConnection.Database.ToString()); myConnection.Close(); }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.ConnectionTimeout: Obtiene un valor que determina el lmite de tiempo que una aplicacin debe esperar para establecer una conexin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis de .NET Framework 1.1
Visual Basic] Public Property ConnectionTimeout As Integer [C#] public int ConnectionTimeout {get; set;} [C++]
3-206
public: __property int get_ConnectionTimeout(); public: __property void set_ConnectionTimeout(int); [JScript] public function get ConnectionTimeout() : int; public function set ConnectionTimeout(int);

Visual Basic] Overrides Public ReadOnly Property ConnectionTimeout As Integer [C#] public override int ConnectionTimeout {get;} [C++] public: __property virtual int get_ConnectionTimeout(); [JScript] public function get ConnectionTimeout() : int;
Valor de la propiedad El tiempo (en segundos) que debe esperarse mientras se intenta establecer una conexin antes de terminar el intento e informar sobre un error. El valor por omisin es 0, que indica que no existe ningn lmite de tiempo para establecer la conexin con la base de datos. Excepciones
Tipo de excepcin ArgumentException Condicin El valor definido es menor que 0.
Comentarios Si el redireccionamiento del cliente est habilitado, el tiempo mximo de espera ser aproximadamente el doble del tiempo de espera de conexin especificado, pues habr un segundo intento de conexin con el servidor alternativo. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection utilizando la palabra clave de tiempo de conexin y, a continuacin, comprueba el ConnectionTime
[Visual Basic] Public Sub CreateIfxConnection() Dim conn As New IfxConnection("Database=SAMPLE;Connect Timeout=30") conn.Open() Dim timeout As Integer = conn.ConnectionTimeout End Sub [C#] public void CreateIfxConnection() { IfxConnection conn = new IfxConnection("Database=SAMPLE;Connect Timeout=30"); conn.Open(); int timeout = conn.ConnectionTimeout; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta
3-207
Propiedad IfxConnection.ConnectionString en la pgina 3-203 Obtiene o establece la serie de caracteres utilizada para abrir una conexin de base de datos. Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.DataSource: Obtiene el nombre de la base de datos actual o de la base de datos que se va a utilizar despus de abrir una conexin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides ReadOnly Property DataSource As String [C#] public override string DataSource { get; } [C++] public: virtual property String^ DataSource { String^ get () override; } [JScript] public override function get DataSource () : String
Valor de la propiedad El nombre de la base de datos actual. El valor por omisin es una serie vaca () hasta que se abra la conexin. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.Database:
3-208
Obtiene el nombre de la base de datos actual o de la base de datos que se va a utilizar despus de abrir una conexin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Database As String IDbConnection.Database [C#] public string Database {get;} [C++] public: __property String* get_Database(); [JScript] public function get Database() : String; Implements _
Implementa: IDbConnection.Database Valor de la propiedad El nombre de la base de datos actual. El valor por omisin es una serie vaca () hasta que se abra la conexin. Comentarios Inicialmente, la propiedad Database se establece en la serie de conexin. La propiedad Database se puede actualizar utilizando el mtodo ChangeDatabase. Si cambia la base de datos actual utilizando el mtodo ChangeDatabase, se enviar un mensaje informativo y se actualizar la propiedad. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection y cambia la base de datos actual.
Visual Basic] Public Sub CreateIfxConnection() Dim myConnString As String = _ "DATABASE=SAMPLE" Dim myConnection As New IfxConnection(myConnString) myConnection.Open() myConnection.ChangeDatabase("SAMPLE2") MessageBox.Show("Database: " + myConnection.Database.ToString()) myConnection.Close() End Sub [C#] public void CreateIfxConnection() { string myConnString = "DATABASE=SAMPLE"; IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open(); myConnection.ChangeDatabase("SAMPLE2"); MessageBox.Show("Database: " + myConnection.Database.ToString()); myConnection.Close(); }
Consulta
3-209
Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.ChangeDatabase en la pgina 3-177 Cambia la base de datos actual asociada con una IfxConnection abierta. Propiedad IfxConnection.ConnectionString en la pgina 3-203 Obtiene o establece la serie de caracteres utilizada para abrir una conexin de base de datos. Propiedad IfxConnection.ServerBuildVersion: Obtiene un entero que contiene el nmero de la versin del built del servidor al que est conectado el cliente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property ServerBuildVersion As Integer [C#] public int ServerBuildVersion {get;} [C++] public: __property int get_ServerBuildVersion(); [JScript] public function get ServerBuildVersion() : int;
Valor de la propiedad Obtiene un entero que contiene el nmero de la versin del built del servidor al que est conectado el cliente. El valor por omisin es una serie vaca () hasta que se abra la conexin. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-210
Propiedad IfxConnection.ServerMajorVersion: Obtiene un entero que contiene el nmero de versin mayor del servidor al que el cliente est conectado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property ServerMajorVersion As Integer [C#] public int ServerMajorVersion {get;} [C++] public: __property int get_ServerMajorVersion(); [JScript] public function get ServerMajorVersion() : int;
Valor de la propiedad Obtiene un entero que contiene el nmero de versin mayor del servidor al que el cliente est conectado. El valor por omisin es una serie vaca () hasta que se abra la conexin. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.ServerMinorVersion: Obtiene un entero que contiene el nmero de la versin menor del servidor al que est conectado el cliente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property ServerMinorVersion As Integer [C#] public int ServerMinorVersion {get;} [C++]
3-211
public: __property int get_ServerMinorVersion(); [JScript] public function get ServerMinorVersion() : int;
Valor de la propiedad Obtiene un entero que contiene el nmero de la versin menor del servidor al que est conectado el cliente. El valor por omisin es una serie vaca () hasta que se abra la conexin. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.ServerRevisionVersion: Obtiene un entero que contiene el nmero de la versin de revisin del servidor al que el cliente est conectado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property ServerRevisionVersion As Integer [C#] public int ServerRevisionVersion {get;} [C++] public: __property int get_ServerRevisionVersion(); [JScript] public function get ServerRevisionVersion() : int;
Valor de la propiedad Obtiene un entero que contiene el nmero de la versin de revisin del servidor al que el cliente est conectado. El valor por omisin es una serie vaca () hasta que se abra la conexin. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta
3-212
Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.ServerType: Obtiene una serie de caracteres que contiene el tipo del servidor al que est conectado el cliente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property ServerType As String [C#] public string ServerType {get;} [C++] public: __property String* get_ServerType(); [JScript] public function get ServerVersion() : String;
Valor de la propiedad El tipo del servidor conectado. El valor por omisin es una serie vaca () hasta que se abra la conexin. Excepciones
Tipo de excepcin InvalidOperationException Condicin La conexin est cerrada.
Comentarios La propiedad ServerType es una serie especfica del tipo de servidor de datos para esta conexin. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection y visualiza el ServerType.
[Visual Basic] Public Sub CreateIfxConnection() Dim myConnectString As String = "DATABASE=SAMPLE;" Dim myConnection As New IfxConnection(myConnectString) myConnection.Open() MessageBox.Show("ServerType: " + myConnection.ServerType) myConnection.Close() End Sub
3-213
[C#] public void CreateIfxConnection() { string myConnectString = "DATABASE=SAMPLE;"; IfxConnection myConnection = new IfxConnection(myConnectString); myConnection.Open(); MessageBox.Show("ServerType: " + myConnection.ServerType); myConnection.Close(); }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.ServerVersion: Obtiene una serie de caracteres que contiene la versin del servidor al que est conectado el cliente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property ServerVersion As String [C#] public string ServerVersion {get;} [C++] public: __property String* get_ServerVersion(); [JScript] public function get ServerVersion() : String;
Valor de la propiedad La versin del servidor conectado. El valor por omisin es una serie vaca () hasta que se abra la conexin. Excepciones
Tipo de excepcin InvalidOperationException Condicin La conexin est cerrada.
Comentarios La propiedad ServerVersion adopta el formato ##.##.####, donde los dos primeros dgitos son la versin principal, los dos dgitos siguientes son la versin secundaria y los ltimos cuatro dgitos son la versin del release.
3-214
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection y visualiza la ServerVersion.
Visual Basic] Public Sub CreateIfxConnection() Dim myConnectString As String = "DATABASE=SAMPLE;" Dim myConnection As New IfxConnection(myConnectString) myConnection.Open() MessageBox.Show("ServerVersion: " + myConnection.ServerVersion.ToString()) myConnection.Close() End Sub [C#] public void CreateIfxConnection() { string myConnectString = "DATABASE=SAMPLE;"; IfxConnection myConnection = new IfxConnection(myConnectString); myConnection.Open(); MessageBox.Show("ServerVersion: " + myConnection.ServerVersion.ToString()); myConnection.Close(); }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnection.State: Obtiene el estado actual de la conexin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property State As ConnectionState IDbConnection.State [C#] public ConnectionState State {get;} [C++] public: __property ConnectionState get_State(); [JScript] public function get State() : ConnectionState; Implements _
Implementa: IDbConnection.State
3-215
Valor de la propiedad Una combinacin de bits de los valores System.Data.ConnectionState. El valor por omisin es Closed. Comentarios Los cambios de estado permitidos son: v De Closed a Open, utilizando el mtodo Open del objeto IfxConnection. v De Open a Closed, utilizando el mtodo Close method or the Dispose del objeto IfxConnection. Nota: La llamada a la propiedad State en una conexin abierta aumenta la actividad general de la aplicacin porque cada una de estas llamadas genera una llamada de bajo nivel explcita para determinar si la conexin sigue siendo vlida. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una instancia de una clase derivada, IfxConnection, establece su ConnectionString y visualiza suState.
Visual Basic] Public Sub createIfxConnection() Dim myConnection As New IfxConnection() myConnection.ConnectionString = _ "DATABASE=SAMPLE;" myConnection.Open() MessageBox.Show("Connection State: " + myConnection.State.ToString()) myConnection.Close() End Sub [C#] public void createIfxConnection() { IfxConnection myConnection = new IfxConnection(); myConnection.ConnectionString = "DATABASE=SAMPLE;"; myConnection.Open(); MessageBox.Show("Connection State: " + myConnection.State.ToString()); myConnection.Close(); }
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Sucesos de IfxConnection
Los sucesos de la clase IfxConnection se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxConnection, consulte el tema IfxConnection Members.
3-216
Sucesos pblicos
Disposed (heredado de Component) Aade un manejador de sucesos para escuchar al suceso Disposed en el componente. Se produce cuando IBM Data Server Provider for .NET enva un aviso o un mensaje informativo. Se produce cuando cambia el estado de la conexin.
InfoMessage
StateChange
Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Suceso IfxConnection.InfoMessage: Se produce cuando IBM Data Server Provider for .NET enva un aviso o un mensaje informativo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Event InfoMessage As IfxInfoMessageEventHandler [C#] public event IfxInfoMessageEventHandler InfoMessage; [C++] public: __event IfxInfoMessageEventHandler * InfoMessage;
[JScript] En JScript(R), podr manejar los sucesos definidos por una clase, pero no podr declarar nuevos sucesos. Datos de suceso
Errors Obtiene la coleccin de avisos enviados desde la base de datos.
Comentarios Los clientes que deseen procesar avisos o mensajes informativos enviados por el servidor deben crear un delegado de IfxInfoMessageEventHandler para estar a la escucha de este suceso. Consulta
3-217
Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Suceso IfxConnection.StateChange: Se produce cuando cambia el estado de la conexin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Event StateChange As StateChangeEventHandler [C#] public event StateChangeEventHandler StateChange; [C++] public: __event StateChangeEventHandler* StateChange;
[JScript] En JScript(R), podr manejar los sucesos definidos por una clase, pero no podr declarar nuevos sucesos. Datos de suceso
CurrentState Obtiene el nuevo estado de la conexin. El objeto de conexin ya estar en el nuevo estado cuando el suceso se emita. Obtiene el estado original de la conexin.
OriginalState
Comentarios El suceso StateChange se crea inmediatamente despus de que State cambie de Closed a Opened, o de Opened a Closed. Si un manejador de sucesos emite una excepcin desde dentro del suceso StateChange, la excepcin se propaga al llamador del mtodo Open o Close. Consulta Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Miembros de IfxConnection en la pgina 3-159 Las tablas siguientes listan los miembros expuestos por la clase IfxConnection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-218
Clase IfxConnectionStringBuilder
Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.Data.Common.DbConnectionStringBuilder IBM.Data.Informix.IfxConnectionStringBuilder
Sintaxis
Visual Basic] Public NotInheritable Class IfxConnectionStringBuilder Inherits DbConnectionStringBuilder [C#] public sealed class IfxConnectionStringBuilder : DbConnectionStringBuilder [C++] public ref class IfxConnectionStringBuilder sealed : public DbConnectionStringBuilder [JScript] public final class IfxConnectionStringBuilder extends DbConnectionStringBuilder
Ejemplo
[C#] El ejemplo siguiente muestra cmo utilizar una instancia de IfxConnectionStringBuilder para generar una IfxConnectionString vlida. Nota: La informacin sobre el ID de usuario y la contrasea se incluye en este ejemplo con fines de demostracin. Esta informacin no debera utilizarse sin modificar en las aplicaciones.
[C#] IfxConnectionStringBuilder connStringBld = new IfxConnectionStringBuilder(); connStringBld.Database = "SAMPLE"; connStringBld.UserID = "Jack"; connStringBld.Password = "BlueJays"; connStringBld.Server = "jacksserver:db2c_DB2"; IfxConnection conn = new IfxConnection(connStringBld.ConnectionString);
Seguridad de hebra
Versin de .NET Framework Soportado en: 2.0 Consulta Miembros de IfxConnectionStringBuilder en la pgina 3-220 Representa un conjunto de mtodos y propiedades que proporcionan enfoques genricos y especficos de IBM Data Server Provider for .NET para la
3-219
generacin de series de conexin vlidas. Las tablas siguientes listan los miembros expuestos por la clase IfxConnectionStringBuilder. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Miembros de IfxConnectionStringBuilder
Representa un conjunto de mtodos y propiedades que proporcionan enfoques genricos y especficos de IBM Data Server Provider for .NET para la generacin de series de conexin vlidas. Las tablas siguientes listan los miembros expuestos por la clase IfxConnectionStringBuilder.
IfxConnectionStringBuilder() IfxConnectionStringBuilder(string) Inicializa una nueva instancia de la clase IfxConnectionStringBuilder. Inicializa una nueva instancia de la clase IfxConnectionStringBuilder, utilizando una ConnectionString existente.
Propiedades pblicas
Authentication CLISchema Connect_Timeout Obtiene o establece el valor de la palabra clave authentication. Obtiene o establece el valor de la palabra clave CLISchema. Obtiene o establece el nmero de segundos que deben transcurrir para que un intento de conexin exceda el tiempo de espera. Obtiene o establece el nmero de segundos que la conexin puede permanecer inactiva en la agrupacin de conexiones. Obtiene o establece un valor que determina si la conexin se colocar en la agrupacin de conexiones cuando se cierre la conexin. Obtiene o establece la serie de caracteres de la conexin asociada con el DbConnectionStringBuilder. Obtiene o establece el valor que indica si la contrasea de la serie de caracteres de la conexin est cifrada. Obtiene o establece el valor de la palabra clave ConvertToLong. Obtiene el nmero de claves contenidas actualmente en la propiedad ConnectionString. Obtiene o establece el valor del nombre de esquema utilizado para todos los objetos de SQL no calificados que se utilizan en la conexin.
ConnectionLifeTime
ConnectionReset
ConnectionString (heredada de DbConnectionStringBuilder) ConnStrPwdEncrypt
ConvertToLong Count (heredada de DbConnectionStringBuilder) CurrentSchema
3-220
Database DBName Enlist
Obtiene o establece el valor de la base de datos con la que se debe conectar. Obtiene o establece el valor de la palabra clave DBName. Obtiene o establece el valor que indica si est permitida la inscripcin en Distributed Transaction Coordinator (DTC). Obtiene o establece el valor de la palabra clave Graphic. Obtiene o establece el nombre de la instancia para una conexin IPC local para la conectividad DSN de archivo o sin DSN. Obtiene o establece la modalidad de proceso de las interrupciones. Obtiene o establece el valor de la palabra clave IsFixedSize. Obtiene o establece el valor del nivel de aislamiento para la conexin. Obtiene un valor que indica si el DbConnectionStringBuilder es de slo lectura. Obtiene un ICollection que contiene las claves incluidas en IfxConnectionStringBuilder. Obtiene o establece el valor de la palabra clave MapDate. Obtiene o establece el valor de la palabra clave MapTime. Obtiene o establece el valor de la palabra clave MapTimestamp. Obtiene o establece el valor que representa el tamao mximo de la agrupacin de conexiones. Obtiene o establece el valor que representa el tamao mnimo de la agrupacin de conexiones. Obtiene o establece el valor que representa la contrasea del usuario. Obtiene o establece el valor que indica si se puede devolver informacin que debe protegerse, tal como una contrasea, como parte de la serie de caracteres conexin una vez abierta la conexin o si la conexin ha estado alguna vez abierta. Obtiene o establece el valor que indica si la agrupacin de conexiones est activa. Obtiene o establece el valor de la palabra clave QueryTimeout.
Graphic Instance
Interrupt IsFixedSize IsolationLevel IsReadOnly (heredada de DbConnectionStringBuilder) Keys
MapDate MapTime MapTimestamp MaxPoolSize
MinPoolSize
Password PersistSecurityInfo
Pooling QueryTimeout
3-221
SchemaList Server ServerType
Obtiene o establece el valor de la palabra clave SchemaList. Obtiene o establece el valor de la palabra clave Server. Esta propiedad se aplica solo a los servidores de datos UniData y UniVerse. Indica si la conexin se realizar a UniData o UniVerse. Obtiene o establece el valor de la palabra clave StaticLatch. Obtiene o establece el valor de la palabra clave SysSchema. Obtiene o establece el valor de la palabra clave TableType. Obtiene o establece el valor que representa el nombre del usuario. Obtiene o establece el valor de la palabra clave Values.
StaticLatch SysSchema TableType UserID Values
Mtodos pblicos
Add (heredado de DbConnectionStringBuilder) Clear ContainsKey Equals (heredado de Object) EquivalentTo (heredado de DbConnectionStringBuilder) Aade una entrada con la clave y valor especificados a DbConnectionStringBuilder. Borra el contenido de la instancia de IfxConnectionStringBuilder. Determina si IfxConnectionStringBuilder contiene la clave especificada. Determina si dos instancias de Object son iguales. Compara la informacin de conexin de este objeto DbConnectionStringBuilder con la informacin de conexin del objeto proporcionado. Sirve como una funcin de hash para un tipo determinado. GetHashCode es adecuado para su utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el Type de la instancia actual. GetType (heredado de Object) Remove ShouldSerialize ToString (heredado de DbConnectionStringBuilder) Elimina la entrada con la clave especificada de IfxConnectionStringBuilder. Indica si la clave especificada existe en esta instancia de IfxConnectionStringBuilder. Devuelve la serie de caracteres de conexin asociada con este DbConnectionStringBuilder.
3-222
TryGetValue
Recupera un valor del IfxConnectionStringBuilder correspondiente a la clave especificada.
Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Constructores IfxConnectionStringBuilder
Inicializa una nueva instancia de la clase IfxConnectionStringBuilder.
IfxConnectionStringBuilder() IfxConnectionStringBuilder(string) Inicializa una nueva instancia de la clase IfxConnectionStringBuilder. Inicializa una nueva instancia de la clase IfxConnectionStringBuilder, utilizando una ConnectionString existente.
Consulta Miembros de IfxConnectionStringBuilder en la pgina 3-220 Representa un conjunto de mtodos y propiedades que proporcionan enfoques genricos y especficos de IBM Data Server Provider for .NET para la generacin de series de conexin vlidas. Las tablas siguientes listan los miembros expuestos por la clase IfxConnectionStringBuilder. Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxConnectionStringBuilder.IfxConnectionStringBuilder(): Inicializa una nueva instancia de la clase IfxConnectionStringBuilder. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Sub New() [C#] public IfxConnectionStringBuilder(); [C++]
3-223
public: IfxConnectionStringBuilder(); [JScript] public function IfxConnectionStringBuilder();
Comentarios Ejemplo [C#] El ejemplo siguiente muestra cmo utilizar una instancia de IfxConnectionStringBuilder para generar una IfxConnectionString vlida. Nota: La informacin sobre el ID de usuario y la contrasea se incluye en este ejemplo con fines de demostracin. Esta informacin no debera utilizarse sin modificar en las aplicaciones.
[C#] IfxConnectionStringBuilder connStringBld = new IfxConnectionStringBuilder(); connStringBld.Database = "SAMPLE"; connStringBld.UserID = "Jack"; connStringBld.Password = "BlueJays"; connStringBld.Server = "jacksserver:db2c_DB2"; IfxConnection conn = new IfxConnection(connStringBld.ConnectionString);
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxConnectionStringBuilder.IfxConnectionStringBuilder(string): Inicializa una nueva instancia de la clase IfxConnectionStringBuilder, utilizando una ConnectionString existente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Sub New( ByVal connectionString As String ) [C#] public IfxConnectionStringBuilder( string connectionString ); [C++] public: IfxConnectionStringBuilder( String* connectionString
3-224
); [JScript] public function IfxConnectionStringBuilder( connectionString : String );
Parmetros connectionString Serie de caracteres de conexin que debe insertarse en el IfxConnectionStringBuilder. Excepciones
Tipo de excepcin KeyNotFoundException FormatException Condicin Nombre de clave no vlido contenido en la serie de caracteres de conexin. Valor no vlido contenido en la serie de caracteres de conexin (por ejemplo, se ha asignado un valor de serie de caracteres cuando se esperaba un valor numrico).
Comentarios Este constructor permite rellenar una instancia de IfxConnectionStringBuilder con una serie de caracteres de conexin existente. Este constructor generar excepciones si se entran valores o claves no vlidos para la serie de caracteres de conexin. Ejemplo [C#] El ejemplo siguiente muestra cmo utilizar una instancia de IfxConnectionStringBuilder para generar una IfxConnectionString vlida utilizando una serie de caracteres de conexin existente. Nota: La informacin sobre el ID de usuario y la contrasea se incluye en este ejemplo con fines de demostracin. Esta informacin no debera utilizarse sin modificar en las aplicaciones.
[C#] String connString = "Database=SAMPLE;User ID=Jack;pwd=BlueJays;Server=jacksserver:db2c_DB2"; IfxConnectionStringBuilder connStringBld = new IfxConnectionStringBuilder(connString);
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-225
Mtodos de IfxConnectionStringBuilder
Los mtodos de la clase IfxConnectionStringBuilder se listan a continuacin.
Mtodos pblicos
Add (heredado de DbConnectionStringBuilder) Clear ContainsKey Equals (heredado de Object) EquivalentTo (heredado de DbConnectionStringBuilder) Aade una entrada con la clave y valor especificados a DbConnectionStringBuilder. Borra el contenido de la instancia de IfxConnectionStringBuilder. Determina si IfxConnectionStringBuilder contiene la clave especificada. Determina si dos instancias de Object son iguales. Compara la informacin de conexin de este objeto DbConnectionStringBuilder con la informacin de conexin del objeto proporcionado. Sirve como una funcin de hash para un tipo determinado. GetHashCode es adecuado para su utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el Type de la instancia actual. GetType (heredado de Object) Remove ShouldSerialize ToString (heredado de DbConnectionStringBuilder) TryGetValue Elimina la entrada con la clave especificada de IfxConnectionStringBuilder. Indica si la clave especificada existe en esta instancia de IfxConnectionStringBuilder. Devuelve la serie de caracteres de conexin asociada con este DbConnectionStringBuilder. Recupera un valor del IfxConnectionStringBuilder correspondiente a la clave especificada.
Consulta Miembros de IfxConnectionStringBuilder en la pgina 3-220 Representa un conjunto de mtodos y propiedades que proporcionan enfoques genricos y especficos de IBM Data Server Provider for .NET para la generacin de series de conexin vlidas. Las tablas siguientes listan los miembros expuestos por la clase IfxConnectionStringBuilder. Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnectionStringBuilder.Clear:
3-226
Borra el contenido de la instancia de IfxConnectionStringBuilder. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Sub Clear [C#] public void Close () [C++] public: void Close () [JScript] public function Close ()
Comentarios Este mtodo borra todas los pares de clave/valor de losparmetros de las series de conexin y establece la propiedad ConnectionString en una serie vaca. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnectionStringBuilder.ContainsKey: Determina si IfxConnectionStringBuilder contiene la clave especificada. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Parmetros keyword Nombre de la clave que debe buscarse. Valor de retorno true si la clave especificada existe en la serie de conexin; de lo contrario false.
3-227
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnectionStringBuilder.Remove: Elimina la entrada con la clave especificada de IfxConnectionStringBuilder. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Parmetros keyword Nombre de la clave que se va a eliminar. Valor de retorno true si la clave se ha eliminado satisfactoriamente; de lo contrario false. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnectionStringBuilder.ShouldSerialize: Indica si la clave especificada existe en esta instancia de IfxConnectionStringBuilder. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-228
Parmetros keyword Nombre de la clave. Valor de retorno true si la clave especificada existe en la serie de conexin; de lo contrario false. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnectionStringBuilder.TryGetValue: Recupera un valor del IfxConnectionStringBuilder correspondiente a la clave especificada. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Parmetros keyword Nombre de la clave que se va a utilizar. value Valor de la clave especificada.
Valor de retorno true si el para de valores de clave existe en la serie de conexin; de lo contrario false. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-229
Propiedades de IfxConnectionStringBuilder
Las propiedades de la clase IfxConnectionStringBuilder se listan a continuacin.
Propiedades pblicas
Authentication CLISchema Connect_Timeout Obtiene o establece el valor de la palabra clave authentication. Obtiene o establece el valor de la palabra clave CLISchema. Obtiene o establece el nmero de segundos que deben transcurrir para que un intento de conexin exceda el tiempo de espera. Obtiene o establece el nmero de segundos que la conexin puede permanecer inactiva en la agrupacin de conexiones. Obtiene o establece un valor que determina si la conexin se colocar en la agrupacin de conexiones cuando se cierre la conexin. Obtiene o establece la serie de caracteres de la conexin asociada con el DbConnectionStringBuilder. Obtiene o establece el valor que indica si la contrasea de la serie de caracteres de la conexin est cifrada. Obtiene o establece el valor de la palabra clave ConvertToLong. Obtiene el nmero de claves contenidas actualmente en la propiedad ConnectionString. Obtiene o establece el valor del nombre de esquema utilizado para todos los objetos de SQL no calificados que se utilizan en la conexin. Obtiene o establece el valor de la base de datos con la que se debe conectar. Obtiene o establece el valor de la palabra clave DBName. Obtiene o establece el valor que indica si est permitida la inscripcin en Distributed Transaction Coordinator (DTC). Obtiene o establece el valor de la palabra clave Graphic. Obtiene o establece el nombre de la instancia para una conexin IPC local para la conectividad DSN de archivo o sin DSN. Obtiene o establece la modalidad de proceso de las interrupciones.
ConnectionLifeTime
ConnectionReset
ConnectionString (heredada de DbConnectionStringBuilder) ConnStrPwdEncrypt
ConvertToLong Count (heredada de DbConnectionStringBuilder) CurrentSchema
Database DBName Enlist
Graphic Instance
Interrupt
3-230
IsFixedSize IsolationLevel IsReadOnly (heredada de DbConnectionStringBuilder) Keys
Obtiene o establece el valor de la palabra clave IsFixedSize. Obtiene o establece el valor del nivel de aislamiento para la conexin. Obtiene un valor que indica si el DbConnectionStringBuilder es de slo lectura. Obtiene un ICollection que contiene las claves incluidas en IfxConnectionStringBuilder. Obtiene o establece el valor de la palabra clave MapDate. Obtiene o establece el valor de la palabra clave MapTime. Obtiene o establece el valor de la palabra clave MapTimestamp. Obtiene o establece el valor que representa el tamao mximo de la agrupacin de conexiones. Obtiene o establece el valor que representa el tamao mnimo de la agrupacin de conexiones. Obtiene o establece el valor que representa la contrasea del usuario. Obtiene o establece el valor que indica si se puede devolver informacin que debe protegerse, tal como una contrasea, como parte de la serie de caracteres conexin una vez abierta la conexin o si la conexin ha estado alguna vez abierta. Obtiene o establece el valor que indica si la agrupacin de conexiones est activa. Obtiene o establece el valor de la palabra clave QueryTimeout. Obtiene o establece el valor de la palabra clave SchemaList. Obtiene o establece el valor de la palabra clave Server. Esta propiedad se aplica solo a los servidores de datos UniData y UniVerse. Indica si la conexin se realizar a UniData o UniVerse. Obtiene o establece el valor de la palabra clave StaticLatch. Obtiene o establece el valor de la palabra clave SysSchema. Obtiene o establece el valor de la palabra clave TableType.
MapDate MapTime MapTimestamp MaxPoolSize
MinPoolSize
Password PersistSecurityInfo
Pooling QueryTimeout SchemaList Server ServerType
StaticLatch SysSchema TableType
3-231
UserID Values
Obtiene o establece el valor que representa el nombre del usuario. Obtiene o establece el valor de la palabra clave Values.
Consulta Miembros de IfxConnectionStringBuilder en la pgina 3-220 Representa un conjunto de mtodos y propiedades que proporcionan enfoques genricos y especficos de IBM Data Server Provider for .NET para la generacin de series de conexin vlidas. Las tablas siguientes listan los miembros expuestos por la clase IfxConnectionStringBuilder. Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.Authentication: Obtiene o establece el valor de la palabra clave authentication. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Authentication As String [C#] public string Authentication {get; set;} [C++] public: __property String* get_Authentication(); public: __property void set_Authentication(String*); [JScript] public function get Authentication() : String; public function set Authentication(String);
Valor de la propiedad Serie de caracteres que representa el tipo de autenticacin que debe utilizarse. El valor por omisin es SERVER. Comentarios Cuando se establece esta opcin, tambin deben establecerse las opciones siguientes: v Database; v Protocol.
3-232
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.CLISchema: Obtiene o establece el valor de la palabra clave CLISchema. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property CLISchema As String [C#] public string CLISchema {get; set;} [C++] public: __property String* get_CLISchema(); public: __property void set_CLISchema(String*); [JScript] public function get CLISchema() : String; public function set CLISchema(String);
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.Connect_Timeout: Obtiene o establece el nmero de segundos que deben transcurrir para que un intento de conexin exceda el tiempo de espera.
3-233

[Visual Basic] Public Property Connect_Timeout As int [C#] public int Connect_Timeout {get; set;} [C++] public: __property int* get_Connect_Timeout(); public: __property void set_Connect_Timeout(int*); [JScript] public function get Connect_Timeout() : int; public function set Connect_Timeout(int);
Valor de la propiedad Entero mayor que o igual a 0 y menor que o igual a 32767 que representa los segundos que la conexin esperar antes de que se produzca un tiempo de espera excedido. Por omisin, la conexin esperar indefinidamente. Comentarios Si Connect_Timeout est establecido y la redireccin del cliente est habilitada, una conexin se intentar slo una vez en el servidor original y una vez en el servidor alternativo. Como el valor de Connect_Timeout se utiliza para intentar la conexin con cada servidor, el tiempo de espera mximo ser el doble del valor de Connect_Timeout especificado aproximadamente. Esto tambin es aplicable cuando est habilitada la explotacin de Sysplex, en cuyo caso el tiempo de espera mximo ser aproximadamente igual al nmero de miembros Sysplex multiplicado por la cantidad de tiempo especificado por la palabra clave Connect_Timeout. Connect_Timeout slo es aplicable al protocolo TCPIP y no est soportado para las conexiones con bases de datos catalogadas en un nodo TCP/IP que tenga habilitado SOCKS. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.ConnectionLifeTime: Obtiene o establece el nmero de segundos que la conexin puede permanecer inactiva en la agrupacin de conexiones.
3-234

[Visual Basic] Public Property ConnectionLifeTime As int [C#] public int ConnectionLifeTime {get; set;} [C++] public: __property int* get_ConnectionLifeTime(); public: __property void set_ConnectionLifeTime(int*); [JScript] public function get ConnectionLifeTime() : int; public function set ConnectionLifeTime(int);
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.ConnectionReset: Obtiene o establece un valor que determina si la conexin se colocar en la agrupacin de conexiones cuando se cierre la conexin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property ConnectionReset As Boolean [C#] public bool ConnectionReset {get; set;} [C++] public: __property bool* get_ConnectionReset(); public: __property void set_ConnectionReset(bool*); [JScript] public function get ConnectionReset() : Boolean; public function set ConnectionReset(Boolean);
3-235
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.ConvertToLong: Obtiene o establece el valor de la palabra clave ConvertToLong. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property ConvertToLong As int [C#] public int ConvertToLong {get; set;} [C++] public: __property int* get_ConvertToLong(); public: __property void set_ConvertToLong(int*); [JScript] public function get ConvertToLong() : int; public function set ConvertToLong(int);
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.CurrentSchema: Obtiene o establece el valor del nombre de esquema utilizado para todos los objetos de SQL no calificados que se utilizan en la conexin.
3-236

[Visual Basic] Public Property CurrentSchema As String [C#] public string CurrentSchema {get; set;} [C++] public: __property String* get_CurrentSchema(); public: __property void set_CurrentSchema(String*); [JScript] public function get CurrentSchema() : String; public function set CurrentSchema(String);
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.Database: Obtiene o establece el valor de la base de datos con la que se debe conectar. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Database As String [C#] public string Database {get; set;} [C++] public: __property String* get_Database(); public: __property void set_Database(String*); [JScript] public function get Database() : String; public function set Database(String);
Valor de la propiedad Valor de la serie de caracteres que representa la base de datos con la que se debe conectar.
3-237
Comentarios Este valor no est relacionado con ninguno de los nombres de alias de bases de datos especificados en el cliente. Este valor debe establecerse en el nombre de la base de datos del servidor. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.Enlist: Obtiene o establece el valor que indica si est permitida la inscripcin en Distributed Transaction Coordinator (DTC). Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property Enlist As Boolean [C#] public bool Enlist {get; set;} [C++] public: __property bool* get_Enlist(); public: __property void set_Enlist(bool*); [JScript] public function get Enlist() : Boolean; public function set Enlist(Boolean);
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-238
Propiedad IfxConnectionStringBuilder.Graphic: Obtiene o establece el valor de la palabra clave Graphic. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property Graphic As int [C#] public int Graphic {get; set;} [C++] public: __property int* get_Graphic(); public: __property void set_Graphic(int*); [JScript] public function get Graphic() : int; public function set Graphic(int);
Valor de la propiedad Entero mayor que o igual a 0 y menor que o igual a 3 que representa la longitud de la columna Graphic. Establezca la palabra clave Graphic de la forma siguiente: v 0 - SQL_GRAPHIC no se devuelve como un tipo de datos SQL soportado y la longitud que se muestra para las columnas GRAPHIC es igual al nmero de caracteres DBCS de la columna. v 1 - SQL_GRAPHIC se devuelve como un tipo de datos SQL soportado y la longitud que se muestra para las columnas GRAPHIC es igual al nmero de caracteres DBCS de la columna. v 2 - SQL_GRAPHIC no se devuelve como un tipo de datos SQL soportado y la longitud que se muestra para las columnas GRAPHIC es igual al nmero mximo de bytes de la columna. v 3 - SQL_GRAPHIC se devuelve como un tipo de datos SQL soportado y la longitud que se muestra para las columnas GRAPHIC es igual al nmero mximo de bytes de la columna. Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.IsFixedSize:
3-239
Obtiene el valor de la palabra clave IsFixedSize. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property IsFixedSize As Boolean [C#] public bool IsFixedSize {get;} [C++] public: __property bool* get_IsFixedSize(); [JScript] public function get IsFixedSize() : Boolean;
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.IsolationLevel: Obtiene o establece el valor del nivel de aislamiento para la conexin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property IsolationLevel As int [C#] public int IsolationLevel {get; set;} [C++] public: __property int* get_IsolationLevel(); public: __property void set_IsolationLevel(int*); [JScript] public function get IsolationLevel() : int; public function set IsolationLevel(int);
Valor de la propiedad Serie de caracteres que representa el nivel de aislamiento utilizado. El valor por omisin es SQL_TXN_READ_COMMITTED.
3-240
Establece el nivel de aislamiento en: v SQL_TXN_READ_UNCOMMITTED - Lectura no confirmada (lectura sin confirmar) v SQL_TXN_READ_COMMITTED - Lectura confirmada (estabilidad del cursor) v SQL_TXN_REPEATABLE_READ - Lectura repetible (estabilidad de la lectura) v SQL_TXN_SERIALIZABLE - Serializable (lectura repetible) Comentarios Esta propiedad slo es aplicable si se utiliza el nivel de aislamiento por omisin. Si la aplicacin establece el nivel de aislamiento para un descriptor de contexto de sentencia o conexin, esta propiedad no tendr ningn efecto sobre el descriptor de contexto. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.Keys: Obtiene un ICollection que contiene las claves incluidas en IfxConnectionStringBuilder. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.MapDate:
3-241
Obtiene o establece el valor de la palabra clave MapDate. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property MapDate As int [C#] public int MapDate {get; set;} [C++] public: __property int* get_MapDate(); public: __property void set_MapDate(int*); [JScript] public function get MapDate() : int; public function set MapDate(int);
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.MapTime: Obtiene o establece el valor de la palabra clave MapTime. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property MapTime As int [C#] public int MapTime {get; set;} [C++] public: __property int* get_MapTime(); public: __property void set_MapTime(int*); [JScript] public function get MapTime() : int; public function set MapTime(int);
3-242
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.MapTimestamp: Obtiene o establece el valor de la palabra clave MapTimestamp. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property MapTimestamp As int [C#] public int MapTimestamp {get; set;} [C++] public: __property int* get_MapTimestamp(); public: __property void set_MapTimestamp(int*); [JScript] public function get MapTimestamp() : int; public function set MapTimestamp(int);
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.MaxPoolSize: Obtiene o establece el valor que representa el tamao mximo de la agrupacin de conexiones.
3-243

[Visual Basic] Public Property MaxPoolSize As int [C#] public int MaxPoolSize {get; set;} [C++] public: __property int* get_MaxPoolSize(); public: __property void set_MaxPoolSize(int*); [JScript] public function get MaxPoolSize() : int; public function set MaxPoolSize(int);
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.MinPoolSize: Obtiene o establece el valor que representa el tamao mnimo de la agrupacin de conexiones. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property MinPoolSize As int [C#] public int MinPoolSize {get; set;} [C++] public: __property int* get_MinPoolSize(); public: __property void set_MinPoolSize(int*); [JScript] public function get MinPoolSize() : int; public function set MinPoolSize(int);
3-244
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.Password: Obtiene o establece el valor que representa la contrasea del usuario. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property Password As String [C#] public string Password {get; set;} [C++] public: __property String* get_Password(); public: __property void set_Password(String*); [JScript] public function get Password() : String; public function set Password(String);
Valor de la propiedad Serie de caracteres que representa la contrasea que la conexin debe utilizar. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.PersistSecurityInfo:
3-245
Obtiene o establece el valor que indica si se puede devolver informacin que debe protegerse, tal como una contrasea, como parte de la serie de caracteres conexin una vez abierta la conexin o si la conexin ha estado alguna vez abierta. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property PersistSecurityInfoProperty As Boolean [C#] public bool PersistSecurityInfoProperty {get; set;} [C++] public: __property bool* get_PersistSecurityInfoProperty(); public: __property void set_PersistSecurityInfoProperty(bool*); [JScript] public function get PersistSecurityInfoProperty() : Boolean; public function set PersistSecurityInfoProperty(Boolean);
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.Pooling: Obtiene o establece el valor que indica si la agrupacin de conexiones est activa. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property Pooling As Boolean [C#] public bool Pooling {get; set;} [C++] public: __property bool* get_Pooling(); public: __property void set_Pooling(bool*); [JScript] public function get Pooling() : Boolean; public function set Pooling(Boolean);
3-246
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.QueryTimeout: Obtiene o establece el valor de la palabra clave QueryTimeout. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property QueryTimeout As int [C#] public int QueryTimeout {get; set;} [C++] public: __property int* get_QueryTimeout(); public: __property void set_QueryTimeout(int*); [JScript] public function get QueryTimeout() : int; public function set QueryTimeout(int);
Valor de la propiedad Entero mayor que o igual a 0 que representa el intervalo entre las comprobaciones de tiempo de espera excedido de las consultas. El valor por omisin es 5 segundos. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.SchemaList:
3-247
Obtiene o establece el valor de la palabra clave SchemaList. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property SchemaList As String [C#] public string SchemaList {get; set;} [C++] public: __property String* get_SchemaList(); public: __property void set_SchemaList(String*); [JScript] public function get SchemaList() : String; public function set SchemaList(String);
Valor de la propiedad Serie de caracteres que representa la lista de los esquemas que deben utilizarse. Cada nombre de esquema es sensible a las maysculas y minsculas, debe aparecer entre comillas simples y separado por comas. Comentarios La longitud mxima de la serie es de 256 caracteres. Ejemplo
SchemaList = "USER1,USER2,USER3"
Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.Server: Obtiene o establece el valor de la palabra clave Server. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-248
Sintaxis
[Visual Basic] Public Property Server As String [C#] public string Server {get; set;} [C++] public: __property String* get_Server(); public: __property void set_Server(String*); [JScript] public function get Server() : String; public function set Server(String);
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.ServerType: Esta propiedad se aplica solo a los servidores de datos UniData y UniVerse. Indica si la conexin se realizar a UniData o UniVerse. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Parmetros Para indicar una conexin al servidor de datos UniData, asigne un valor de UNIDATA. Para indicar una conexin al servidor de datos UniVerse, asigne un valor de UNIVERSE. Sintaxis
[Visual Basic] Public Property ServerType As String [C#] public string ServerType {get; set;} [C++] public: __property String* get_ServerType(); public: __property void set_ServerType(String*); [JScript] public function get ServerType() : String; public function set ServerType(String);
3-249
Valor de la propiedad Tipo de servidor de datos al que debe conectarse. El valor por omisin es una serie de caracteres vaca (). Ejemplo [C#] El ejemplo siguiente crea un IfxConnectionStringBuilder y establece el ServerType en un servidor de datos UniData.
[C#] public void CreateIfxConnectionStringBuilder() { DB2ConnectionStringBuilder constr = new DB2ConnectionStringBuilder(); constr.ServerType = "UNIDATA"; }
Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.StaticLatch: Obtiene o establece el valor de la palabra clave StaticLatch. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property StaticLatch As int [C#] public int StaticLatch {get; set;} [C++] public: __property int* get_StaticLatch(); public: __property void set_StaticLatch(int*); [JScript] public function get StaticLatch() : int; public function set StaticLatch(int);
Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta
3-250
Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.SysSchema: Obtiene o establece el valor de la palabra clave SysSchema. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
[Visual Basic] Public Property SysSchema As String [C#] public string SysSchema {get; set;} [C++] public: __property String* get_SysSchema(); public: __property void set_SysSchema(String*); [JScript] public function get SysSchema() : String; public function set SysSchema(String);
Valor de la propiedad Serie de caracteres que representa un esquema alternativo que debe buscarse. Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.TableType: Obtiene o establece el valor de la palabra clave TableType. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-251
Sintaxis
[Visual Basic] Public Property TableType As String [C#] public string TableType {get; set;} [C++] public: __property String* get_TableType(); public: __property void set_TableType(String*); [JScript] public function get TableType() : String; public function set TableType(String);
Valor de la propiedad Serie de caracteres que representa la lista de los tipos de tablas. Los tipos de tablas vlidos que deben incluirse en la lista son los siguientes: v TABLE, v ALIAS, v VIEW, v INOPERATIVE VIEW, v SYSTEM TABLE, v SYNONYM. Pueden especificarse todos los valores que se deseen. Cada tipo debe estar delimitado por comillas simples, separado por comas y en maysculas. Comentarios Ejemplo
TableType = "TABLE,VIEW"
Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.UserID: Obtiene o establece el valor que representa el nombre del usuario. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-252
Sintaxis
[Visual Basic] Public Property UserID As String [C#] public string UserID {get; set;} [C++] public: __property String* get_UserID(); public: __property void set_UserID(String*); [JScript] public function get UserID() : String; public function set UserID(String);
Valor de la propiedad Serie de caracteres que representa el nombre de usuario que debe utilizarse para la conexin. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxConnectionStringBuilder.Values: Obtiene o establece el valor de la palabra clave Values. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Valor de la propiedad Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxConnectionStringBuilder en la pgina 3-219 Representa un enfoque sencillo para generar series de conexin vlidas para su utilizacin con la clase IfxConnectionString. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-253
Enumeracin IfxCursorType
Tipos de cursor que puede utilizar la instancia de IfxResultSet. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] <Serializable> Public Enum IfxCursorType [C#] [Serializable] public enum IfxCursorType [C++] [Serializable] __value public enum IfxCursorType [JScript] public Serializable enum IfxCursorType
Miembros
Nombre de miembro ForwardOnly Static Keyset Descripcin El IfxResultSet que se crear utilizar un cursor slo de avance, no desplazable, no sensible y no actualizable. El IfxResultSet que se crear utilizar un cursor desplazable, no sensible y no actualizable. El IfxResultSet que se crear utilizar un cursor desplazable, sensible y actualizable. Los huecos por supresin son visibles para el cursor. El IfxResultSet que se crear utilizar un cursor desplazable, sensible, dinmico y actualizable. Los huecos por supresin no son visibles para el cursor.
Dynamic
Comentarios
La tabla siguiente representa los valores de la opcin IfxResultSet asignados para valores IfxCursorType determinados:
Valor de IfxCursorType Forward-only Static IfxResultSet.Scrollable False True IfxResultSet.Updatable True si la seleccin contiene clave primaria, serie o row-id False
Al crear una instancia de IfxResultSet con el mtodo IfxCommand.ExecuteResultSet, puede utilizar la enumeracin IfxCursorType o la enumeracin IfxResultSetOptions para definir las capacidades de la instancia de IfxResultSet. A continuacin se muestran los detalles de las modalidades de two IfxResultSet.CursorType soportadas por la clase IfxResultSet:
3-254
ForwardOnly Este tipo de cursor es unidireccional y es el tipo de cursor que requiere la cantidad menor de proceso de rendimiento. Un IfxResultSet creado con este tipo de cursor es funcionalmente equivalente a IfxDataReader. Static Es un cursor de solo lectura. Una vez que se ha creado, no se pueden aadir ni eliminar filas, ni se pueden cambiar los valores de las filas. El cursor no resulta afectado por otras aplicaciones que accedan a los mismos datos. El nivel de aislamiento utilizado para crear el cursor determina cmo estn bloqueadas las filas del cursor, si lo estn.
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxDataAdapter
Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.MarshalByRefObject System.ComponentModel.Component System.Data.Common.DataAdapter System.Data.Common.DbDataAdapter IBM.Data.Informix.IfxDataAdapter
Sintaxis
Visual Basic] NotInheritable Public Class IfxDataAdapter Inherits DbDataAdapter Implements IDbDataAdapter [C#] public sealed class IfxDataAdapter : DbDataAdapter, IDbDataAdapter [C++] public __gc __sealed class IfxDataAdapter : public DbDataAdapter, IDbDataAdapter [JScript] public class IfxDataAdapter extends DbDataAdapter implements IDbDataAdapter
3-255
Comentarios
El IfxDataAdapter sirve de puente entre un DataSet y una base de datos para recuperar y guardar datos. El IfxDataAdapter proporciona este puente utilizando Fill para cargar datos desde la base de datos en el DataSet y utilizando Update para enviar los cambios realizados en el DataSet de vuelta a la base de datos. Nota: Cuando se llama al mtodo Fill en una base de datos que no tenga una columna de clave primaria, el IfxDataAdapter intenta promover la columna de restriccin exclusiva a la clave primaria. En el proceso, el IfxDataAdapter marca la restriccin exclusiva como no anulable. Este comportamiento funciona a menos que haya un valor nulo en la columna de restriccin nica. Si hay un valor nulo, el mtodo Fill falla con una violacin de restriccin. Para evitar la situacin, no permita valores nulos en la columna de restriccin nica. El IfxDataAdapter tambin incluye las propiedades SelectCommand, InsertCommand, DeleteCommand, UpdateCommand y TableMappings para facilitar la carga y actualizacin de los datos.
Ejemplo
[Visual Basic, C#] El ejemplo siguiente utiliza IfxCommand, IfxDataAdapter y IfxConnection para seleccionar registros y rellenar un DataSet con las filas seleccionadas. A continuacin, se devuelve el DataSet lleno. Para hacer esto, se pasa al mtodo un DataSet inicializado, con SelectCommand establecido con la sentencia SELECT de SQL especificada y una conexin con la base de datos.
[Visual Basic] Public Function SelectIfxSrvRows(dataSet As DataSet, connection As String, query As String) As DataSet Dim conn As New IfxConnection(connection) Dim adapter As New IfxDataAdapter() adapter.SelectCommand = new IfxCommand(query, conn) adapter.Fill(dataset) Return dataset End Function [C#] public DataSet SelectIfxSrvRows(DataSet dataset,string connection,string query) { IfxConnection conn = new IfxConnection(connection); IfxDataAdapter adapter = new IfxDataAdapter(); adapter.SelectCommand = new IfxCommand(query, conn); adapter.Fill(dataset); return dataset; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter
3-256
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Clase IfxCommand en la pgina 3-98 Representa una sentencia de SQL o un procedimiento almacenado que se va a ejecutar contra una fuente de datos. Ejemplos DbDatAdp.cs DbDatAdp.vb
Miembros de IfxDataAdapter
Visin general de IfxDataAdapter
Nombre IfxDataAdapter Descripcin Sobrecargado. Inicializa una nueva instancia de la clase IfxDataAdapter.
Propiedades pblicas
Nombre AcceptChangesDuringFill (heredada de DataAdapter) Container (heredada de Component) Descripcin Obtiene o establece un valor que indica si se llama a AcceptChanges en una DataRow despus de aadirlo a la DataTable. Obtiene el IContainer que contiene el Component.
Obtiene o establece un valor que especifica ContinueUpdateOnError (heredada de si se debe generar una excepcin, o la fila errnea cuando se produce un error durante DataAdapter) una actualizacin de fila. DeleteCommand Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para suprimir registros en la base de datos. Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para insertar nuevos registros en la base de datos. Determina la accin que se debe emprender cuando los datos entrantes no tienen una tabla o columna coincidente. Determina la accin que se debe emprender cuando el esquema existente de DataSet no coincide con los datos entrantes. Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para seleccionar registros en la base de datos.
InsertCommand
MissingMappingAction (heredada de DataAdapter) MissingSchemaAction (heredada de DataAdapter) SelectCommand
3-257
Nombre Site (heredada de Component) TableMappings (heredada de DataAdapter) UpdateBatchSize
Descripcin Obtiene o establece el ISite de Component. Obtiene una coleccin que proporciona la correlacin principal entre una tabla fuente y una DataTable. Sobrecargado. Obtiene o establece el nmero de mandatos de un lote que se deben enviar al servidor de bases de datos para su ejecucin. Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para actualizar registros en la base de datos.
UpdateCommand
Mtodos pblicos
Nombre CreateObjRef (heredado de MarshalByRefObject) Descripcin Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Sobrecargado. Libera los recursos utilizados por Component. Sobrecargado. Determina si dos instancias de Object son iguales. Sobrecargado. Alterado temporalmente. Aade o renueva filas en el DataSet para coincidir con los de la base de datos. Sobrecargado. Alterado temporalmente. Aade una DataTable a un DataSet y configura el esquema para que coincida con el de la base de datos. Alterado temporalmente. Obtiene los parmetros establecidos por el usuario al ejecutar una sentencia SELECT de SQL. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el Type de la instancia actual. GetType (heredado de Object) InitializeLifetimeService (heredado de MarshalByRefObject) ToString (heredado de Object) Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Devuelve una String que representa el Object actual.
Dispose (heredado de Component) Equals (heredado de Object) Fill (heredado de DbDataAdapter)
FillSchema (heredado de DbDataAdapter)
GetFillParameters (heredado de DbDataAdapter) GetHashCode (heredado de Object)
3-258
Nombre
Descripcin
Sobrecargado. Llama a las sentencias Update (heredado de DbDataAdapter) INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o suprimida en el DataSet.
Sucesos pblicos
Nombre Disposed (heredado de Component) Descripcin Sobrecargado. Aade un manejador de sucesos para escuchar al suceso Disposed en el componente.
Devuelto cuando se produce un error FillError (heredado de DbDataAdapter) durante una operacin de relleno. RowUpdated Se produce durante una operacin de actualizacin despus de ejecutar un mandato contra la base de datos. Se produce durante Update antes de ejecutar un mandato contra la base de datos.
RowUpdating
Mtodos protegidos
Nombre AddToBatch (heredado de DbDataAdapter) ClearBatch (heredado de DbDataAdapter) CloneInternals (heredado de DataAdapter) CreateRowUpdatedEvent Elimina todos los objetos IDbCommand del lote. Crea una copia de esta instancia de DataAdapter. Alterado temporalmente. Inicializa una nueva instancia de la clase RowUpdatedEventArgs, independientemente de si la actualizacin es satisfactoria o no. Alterado temporalmente. Inicializa una nueva instancia de la clase RowUpdatingEventArgs. Descripcin Aade un IDbCommand al lote actual.
CreateRowUpdatingEvent
3-259
Nombre CreateTableMappings (heredado de DataAdapter) Dispose (heredado de DbDataAdapter) ExecuteBatch (heredado de DbDataAdapter) Fill (heredado de DbDataAdapter)
Descripcin Crea una nueva DataTableMappingCollection. Sobrecargado. Libera los recursos utilizados por Component. Ejecuta el lote actual.
Sobrecargado. Alterado temporalmente. Aade o renueva filas en el DataSet para coincidir con los de la base de datos. Sobrecargado. Alterado temporalmente. Aade una DataTable a un DataSet y configura el esquema para que coincida con el de la base de datos. Alterado temporalmente. Permite que un Object intente liberar recursos y realizar otras operaciones de limpieza antes de que el Object sea reclamado para la recopilacin de basura. En C# y Microsoft(R) Visual C++(R), los finalizadores se expresan utilizando sintaxis de destructor.
GetBatchedParameter (heredado de DbDataAdapter) GetService (heredado de Component)
Devuelve un IDataParameter de uno de los mandatos del lote actual. Devuelve un objeto que representa un servicio proporcionado por el Component o por su Container. Inicializa el proceso por lotes para el DbDataAdapter. Crea una copia superficial del Object actual.
InitializeBatching (heredado de DbDataAdapter) MemberwiseClone (heredado de Object)
Emite el suceso FillError. OnFillError (heredado de DbDataAdapter) OnRowUpdated Alterado temporalmente. Emite el suceso RowUpdated utilizando un objeto RowUpdatedEventArgs. Alterado temporalmente. Emite el suceso RowUpdating utilizando un objeto RowUpdatingEventArgs, tanto si la operacin de actualizacin es satisfactoria como si no lo es. Determina si existen uno o ms objetos DataTableMapping y si deben persistir.
OnRowUpdating
ShouldSerializeTableMappings (heredado de DataAdapter)
3-260
Nombre TerminateBatching (heredado de DbDataAdapter)
Descripcin Finaliza el proceso por lotes para el DbDataAdapter.
Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Constructor de IfxDataAdapter
Inicializa una nueva instancia de la clase IfxDataAdapter.
Nombre New() New(IfxCommand) Descripcin Inicializa una nueva instancia de la clase IfxDataAdapter. Inicializa una nueva instancia de la clase IfxDataAdapter con la sentencia SELECT de SQL especificada. Inicializa una nueva instancia de la clase IfxDataAdapter con una sentencia SELECT de SQL y una IfxConnection. Inicializa una nueva instancia de la clase IfxDataAdapter con una sentencia SELECT de SQL y una serie de caracteres de conexin.
New(String, IfxConnection)
New(String, String)
Ejemplo
[Visual Basic, C#] El ejemplo siguiente crea un IfxDataAdapter y establece algunas de sus propiedades. Nota: [Visual Basic, C#] Este ejemplo muestra cmo utilizar una de las versiones sobrecargadas del constructor de IfxDataAdapter. Para obtener otros ejemplos que pudieran estar disponibles, consulte los temas de sobrecarga individuales.
[Visual Basic] Public Sub CreateIfxDataAdapter() Dim myIfxConnection As IfxConnection = New IfxConnection("DATABASE=SAMPLE;") Dim mySelectText as String = "SELECT EMPNO, LASTNAME FROM EMPLOYEE" Dim empDA As IfxDataAdapter = New IfxDataAdapter(mySelectText, myIfxConnection) empDA.MissingSchemaAction = MissingSchemaAction.AddWithKey Dim employeeDS As DataSet = New DataSet() empDA.Fill(employeeDS, "EMPLOYEE") empDA.InsertCommand = New IfxCommand("INSERT INTO EMPLOYEE (EMPNO, LASTNAME) " & _
3-261
"VALUES (?, ?)", myIfxConnection) empDA.UpdateCommand = New IfxCommand("UPDATE EMPLOYEE SET EMPNO = ?, LASTNAME = ? " & _ "WHERE EMPNO = ?", myIfxConnection) empDA.DeleteCommand = New IfxCommand("DELETE FROM EMPLOYEE WHERE EMPNO = ?", myIfxConnection) empDA.InsertCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO") empDA.InsertCommand.Parameters.Add("LASTNAME", IfxType.VarChar, 15, "LASTNAME") empDA.UpdateCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO") empDA.UpdateCommand.Parameters.Add("LASTNAME", IfxType.VarChar, 15, "LASTNAME") empDA.UpdateCommand.Parameters.Add("OLDEMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original empDA.DeleteCommand.Parameters.Add("EMPNO", IfxType.Char, 5, "EMPNO").SourceVersion = DataRowVersion.Original End Sub [C#] public static void CreateIfxDataAdapter() { IfxConnection myIfxConnection = new IfxConnection("DATABASE=SAMPLE;"); string mySelectText = "SELECT EMPNO, LASTNAME FROM EMPLOYEE"; IfxDataAdapter empDA = new IfxDataAdapter(mySelectText, myIfxConnection ); empDA.MissingSchemaAction = MissingSchemaAction.AddWithKey; DataSet employeeDS = new DataSet(); empDA.Fill(employeeDS, "EMPLOYEE"); empDA.InsertCommand = new IfxCommand("INSERT INTO EMPLOYEE (EMPNO, LASTNAME) " + "VALUES (?, ?)", myIfxConnection); empDA.UpdateCommand = new IfxCommand("UPDATE EMPLOYEE SET EMPNO = ?, LASTNAME = ? " + "WHERE EMPNO = ?", myIfxConnection); empDA.DeleteCommand = new IfxCommand("DELETE FROM EMPLOYEE WHERE EMPNO = ?", myIfxConnection); empDA.InsertCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO"); empDA.InsertCommand.Parameters.Add("LASTNAME", IfxType.VarChar, 15, "LASTNAME"); empDA.UpdateCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO"); empDA.UpdateCommand.Parameters.Add("LASTNAME", IfxType.VarChar, 15, "LASTNAME"); empDA.UpdateCommand.Parameters.Add("OLDEMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original; empDA.DeleteCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original; }
Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos
3-262
DbDatAdp.cs DbDatAdp.vb Constructor de IfxDataAdapter (): Inicializa una nueva instancia de la clase IfxDataAdapter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New() [C#] public IfxDataAdapter(); [C++] public: IfxDataAdapter(); [JScript] public function IfxDataAdapter();
Comentarios Cuando se crea una instancia de IfxDataAdapter, las siguientes propiedades de lectura/grabacin se establecen en sus valores por omisin, tal como se muestra en la tabla.
Propiedades MissingMappingAction MissingSchemaAction Valor por omisin MissingMappingAction.Passthrough MissingSchemaAction.Add
Puede cambiar el valor de cualquiera de estas propiedades mediante una llamada por separado a la propiedad. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxDataAdapter y establece algunas de sus propiedades.
Visual Basic] Public Sub CreateIfxDataAdapter() Dim myIfxConnection As IfxConnection = New IfxConnection("DATABASE=SAMPLE;") Dim empDA As IfxDataAdapter = New IfxDataAdapter empDA.MissingSchemaAction = MissingSchemaAction.AddWithKey Dim employeeDS As DataSet = New DataSet empDA.Fill(employeeDS, "EMPLOYEE") empDA.SelectCommand = New IfxCommand( "SELECT EMPNO, LASTNAME FROM EMPLOYEE", myIfxConnection) empDA.InsertCommand = New IfxCommand( "INSERT INTO EMPLOYEE (EMPNO, LASTNAME) " & _ "VALUES (?, ?)", myIfxConnection) empDA.UpdateCommand = New IfxCommand( "UPDATE EMPLOYEE SET EMPNO = ?, LASTNAME = ? " & _ "WHERE EMPNO = ?", myIfxConnection) empDA.DeleteCommand = New IfxCommand( "DELETE FROM EMPLOYEE WHERE EMPNO = ?",
3-263
myIfxConnection) empDA.InsertCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO") empDA.InsertCommand.Parameters.Add("LASTNAME", IfxType.VarChar, 15, "LASTNAME") empDA.UpdateCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO") empDA.UpdateCommand.Parameters.Add("LASTNAME", IfxType.VarChar, 15, "LASTNAME") empDA.UpdateCommand.Parameters.Add("OLDEMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original empDA.DeleteCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original End Sub [C#] public static void CreateIfxDataAdapter() { IfxConnection myIfxConnection = new IfxConnection("DATABASE=SAMPLE;"); IfxDataAdapter empDA = new IfxDataAdapter(); empDA.MissingSchemaAction = MissingSchemaAction.AddWithKey; DataSet employeeDS = new DataSet(); empDA.Fill(employeeDS, "EMPLOYEE"); empDA.SelectCommand = new IfxCommand( "SELECT EMPNO, LASTNAME FROM EMPLOYEE", myIfxConnection); empDA.InsertCommand = new IfxCommand( "INSERT INTO EMPLOYEE (EMPNO, LASTNAME) " + "VALUES (?, ?)", myIfxConnection); empDA.UpdateCommand = new IfxCommand( "UPDATE EMPLOYEE SET EMPNO = ?, LASTNAME = ? " + "WHERE EMPNO = ?", myIfxConnection); empDA.DeleteCommand = new IfxCommand( "DELETE FROM EMPLOYEE WHERE EMPNO = ?", myIfxConnection); empDA.InsertCommand.Parameters.Add( "EMPNO", IfxType.Char, 6, "EMPNO"); empDA.InsertCommand.Parameters.Add( "LASTNAME", IfxType.VarChar, 15, "LASTNAME"); empDA.UpdateCommand.Parameters.Add( "EMPNO", IfxType.Char, 6, "EMPNO"); empDA.UpdateCommand.Parameters.Add( "LASTNAME", IfxType.VarChar, 15, "LASTNAME"); empDA.UpdateCommand.Parameters.Add( "OLDEMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original; empDA.DeleteCommand.Parameters.Add( "EMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original; }
Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxDataAdapter en la pgina 3-261 Inicializa una nueva instancia de la clase IfxDataAdapter.
3-264
Ejemplos DbDatAdp.cs DbDatAdp.vb Constructor de IfxDataAdapter (IfxCommand): Inicializa una nueva instancia de la clase IfxDataAdapter con la sentencia SELECT de SQL especificada. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ ByVal selectCommand As IfxCommand _ ) [C#] public IfxDataAdapter( IfxCommand selectCommand ); [C++] public: IfxDataAdapter( IfxCommand * selectCommand ); [JScript] public function IfxDataAdapter( selectCommand : IfxCommand );
Parmetros selectCommand IfxCommand que es una sentencia SELECT de SQL o procedimiento almacenado y que est definida como la propiedad SelectCommand del IfxDataAdapter. Comentarios Esta implementacin del constructor de IfxDataAdapter establece la propiedad SelectCommand en el valor especificado en el parmetro selectCommand. Cuando se crea una instancia de IfxDataAdapter, las siguientes propiedades de lectura/grabacin se establecen en sus valores por omisin, tal como se muestra en la tabla.
Propiedades MissingMappingAction MissingSchemaAction Valor inicial MissingMappingAction.Passthrough MissingSchemaAction.Add
Puede cambiar el valor de cualquiera de estas propiedades mediante una llamada por separado a la propiedad.
3-265
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxDataAdapter y establece algunas de sus propiedades.
Visual Basic] Public Sub CreateIfxDataAdapter() Dim myIfxConnection As IfxConnection = New IfxConnection("DATABASE=SAMPLE;") Dim myIfxCommand As IfxCommand = New IfxCommand("SELECT EMPNO, LASTNAME FROM EMPLOYEE"); Dim custDA As IfxDataAdapter = New IfxDataAdapter(myIfxCommand) custDA.MissingSchemaAction = MissingSchemaAction.AddWithKey Dim custDS As DataSet = New DataSet custDA.Fill(custDS, "Customers") custDA.InsertCommand = New IfxCommand( "INSERT INTO EMPLOYEE (EMPNO, LASTNAME) " & _ "VALUES (?, ?)", myIfxConnection) custDA.UpdateCommand = New IfxCommand( "UPDATE EMPLOYEE SET EMPNO = ?, LASTNAME = ? " & _ "WHERE EMPNO = ?", myIfxConnection) custDA.DeleteCommand = New IfxCommand( "DELETE FROM EMPLOYEE WHERE EMPNO = ?", myIfxConnection) custDA.InsertCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO") custDA.InsertCommand.Parameters.Add("LASTNAME", IfxType.VarChar, 15, "LASTNAME") custDA.UpdateCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO") custDA.UpdateCommand.Parameters.Add("LASTNAME", IfxType.VarChar, 15, "LASTNAME") custDA.UpdateCommand.Parameters.Add( "OLDEMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original custDA.DeleteCommand.Parameters.Add( "EMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original End Sub [C#] public static void CreateIfxDataAdapter() { IfxConnection myIfxConnection = new IfxConnection("DATABASE=SAMPLE;"); IfxCommand myIfxCommand = new IfxCommand("SELECT EMPNO, LASTNAME FROM EMPLOYEE"); IfxDataAdapter custDA = new IfxDataAdapter(myIfxCommand); custDA.MissingSchemaAction = MissingSchemaAction.AddWithKey; DataSet custDS = new DataSet(); custDA.Fill(employeeDS, "EMPLOYEE"); custDA.InsertCommand = new IfxCommand( "INSERT INTO EMPLOYEE (EMPNO, LASTNAME) " + "VALUES (?, ?)", myIfxConnection); custDA.UpdateCommand = new IfxCommand( "UPDATE EMPLOYEE SET EMPNO = ?, LASTNAME = ? " + "WHERE EMPNO = ?", myIfxConnection); custDA.DeleteCommand = new IfxCommand( "DELETE FROM EMPLOYEE WHERE EMPNO = ?", myIfxConnection); custDA.InsertCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO"); custDA.InsertCommand.Parameters.Add( "LASTNAME", IfxType.VarChar, 15, "LASTNAME"); custDA.UpdateCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO"); custDA.UpdateCommand.Parameters.Add( "LASTNAME", IfxType.VarChar, 15, "LASTNAME");
3-266
custDA.UpdateCommand.Parameters.Add( "OLDEMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original; custDA.DeleteCommand.Parameters.Add( "EMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original; }
Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxDataAdapter en la pgina 3-261 Inicializa una nueva instancia de la clase IfxDataAdapter. Constructor de IfxDataAdapter (String, IfxConnection): Inicializa una nueva instancia de la clase IfxDataAdapter con una sentencia SELECT de SQL y una IfxConnection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ ByVal selectCommandText As String, _ ByVal selectConnection As IfxConnection _ ) [C#] public IfxDataAdapter( string selectCommandText, IfxConnection selectConnection ); [C++] public: IfxDataAdapter( String* selectCommandText, IfxConnection* selectConnection ); [JScript] public function IfxDataAdapter( selectCommandText : String, selectConnection : IfxConnection );
3-267
Parmetros selectCommandText Serie de caracteres que es una sentencia SELECT de SQL o un procedimiento almacenado que la propiedad SelectCommand del IfxDataAdapter debe utilizar. selectConnection Un objeto IfxConnection representa una conexin abierta con una base de datos. Comentarios Esta implementacin de IfxDataAdapter puede resultar til en una aplicacin que deba llamar al mtodo Fill para dos o ms objetos IfxDataAdapter. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxDataAdapter y establece algunas de sus propiedades.
Visual Basic] Public Sub CreateIfxDataAdapter() Dim myIfxConnection As IfxConnection = New IfxConnection("DATABASE=SAMPLE;") Dim mySelectText As String = "SELECT EMPNO, LASTNAME FROM EMPLOYEE" Dim custDA As IfxDataAdapter = New IfxDataAdapter(mySelectText, myIfxConnection) custDA.MissingSchemaAction = MissingSchemaAction.AddWithKey Dim custDS As DataSet = New DataSet custDA.Fill(employeeDS, "EMPLOYEE") custDA.InsertCommand = New IfxCommand( "INSERT INTO EMPLOYEE (EMPNO, LASTNAME) " & _ "VALUES (?, ?)", myIfxConnection) custDA.UpdateCommand = New IfxCommand( "UPDATE EMPLOYEE SET EMPNO = ?, LASTNAME = ? " & _ "WHERE EMPNO = ?", myIfxConnection) custDA.DeleteCommand = New IfxCommand( "DELETE FROM EMPLOYEE WHERE EMPNO = ?", myIfxConnection) custDA.InsertCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO") custDA.InsertCommand.Parameters.Add("LASTNAME", IfxType.VarChar, 15, "LASTNAME") custDA.UpdateCommand.Parameters.Add( "EMPNO", IfxType.Char, 6, "EMPNO") custDA.UpdateCommand.Parameters.Add( "LASTNAME", IfxType.VarChar, 15, "LASTNAME") custDA.UpdateCommand.Parameters.Add( "OLDEMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original custDA.DeleteCommand.Parameters.Add( "EMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original End Sub [C#] public static void CreateIfxDataAdapter() { IfxConnection myIfxConnection = new IfxConnection("DATABASE=SAMPLE;"); string mySelectText = "SELECT CustomerID, CompanyName FROM CUSTOMERS"; IfxDataAdapter custDA = new IfxDataAdapter(mySelectText, myIfxConnection );
3-268
custDA.MissingSchemaAction = MissingSchemaAction.AddWithKey; DataSet custDS = new DataSet(); custDA.Fill(custDS, "EMPLOYEE"); custDA.InsertCommand = new IfxCommand( "INSERT INTO EMPLOYEE (EMPNO, LASTNAME) " + "VALUES (?, ?)", myIfxConnection); custDA.UpdateCommand = new IfxCommand( "UPDATE EMPLOYEE SET EMPNO = ?, LASTNAME = ? " + "WHERE EMPNO = ?", myIfxConnection); custDA.DeleteCommand = new IfxCommand( "DELETE FROM EMPLOYEE WHERE EMPNO = ?", myIfxConnection); custDA.InsertCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO"); custDA.InsertCommand.Parameters.Add( "LASTNAME", IfxType.VarChar, 15, "LASTNAME"); custDA.UpdateCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO"); custDA.UpdateCommand.Parameters.Add( "LASTNAME", IfxType.VarChar, 15, "LASTNAME"); custDA.UpdateCommand.Parameters.Add("OLDEMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original; custDA.DeleteCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original; }
Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxDataAdapter en la pgina 3-261 Inicializa una nueva instancia de la clase IfxDataAdapter. Constructor de IfxDataAdapter (String, String): Inicializa una nueva instancia de la clase IfxDataAdapter con una sentencia SELECT de SQL y una serie de caracteres de conexin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ ByVal selectCommandText As String, _ ByVal selectConnectionString As String _ ) [C#] public IfxDataAdapter(
3-269
string selectCommandText, string selectConnectionString ); [C++] public: IfxDataAdapter( String* selectCommandText, String* selectConnectionString ); [JScript] public function IfxDataAdapter( selectCommandText : String, selectConnectionString : String );
Parmetros selectCommandText Serie de caracteres que es una sentencia SELECT de SQL o un procedimiento almacenado que la propiedad SelectCommand del IfxDataAdapter debe utilizar. selectConnectionString La serie de conexin. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxDataAdapter y establece algunas de sus propiedades.
Visual Basic] Public Sub CreateIfxDataAdapter() Dim myConnString As String = "DATABASE=SAMPLE;" Dim myIfxConnection As IfxConnection = New IfxConnection(myConnString) Dim mySelectText As String = "SELECT EMPNO, LASTNAME FROM EMPLOYEE" Dim empDA As IfxDataAdapter = New IfxDataAdapter(mySelectText, myIfxConnection) empDA.MissingSchemaAction = MissingSchemaAction.AddWithKey Dim employeeDS As DataSet = New DataSet() empDA.Fill(employeeDS, "EMPLOYEES") empDA.InsertCommand = New IfxCommand( "INSERT INTO EMPLOYEE (EMPNO, LASTNAME) " & _ "VALUES (?, ?)", myIfxConnection) empDA.UpdateCommand = New IfxCommand( "UPDATE EMPLOYEE SET EMPNO = ?, LASTNAME = ? " & _ "WHERE EMPNO = ?", myIfxConnection) empDA.DeleteCommand = New IfxCommand( "DELETE FROM EMPLOYEE WHERE EMPNO = ?", myIfxConnection) empDA.InsertCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO") empDA.InsertCommand.Parameters.Add("LASTNAME", IfxType.VarChar, 15, "LASTNAME") empDA.UpdateCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO") empDA.UpdateCommand.Parameters.Add("LASTNAME", IfxType.VarChar, 15, "LASTNAME") empDA.UpdateCommand.Parameters.Add("OLDEMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original empDA.DeleteCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original End Sub [C#] public static void CreateIfxDataAdapter() {
3-270
string myConnString = "DATABASE=SAMPLE;"; IfxConnection myIfxConnection = new IfxConnection(myConnString); string mySelectText = "SELECT EMPNO, LASTNAME FROM EMPLOYEE"; IfxDataAdapter empDA = new IfxDataAdapter(mySelectText, myIfxConnection); empDA.MissingSchemaAction = MissingSchemaAction.AddWithKey; DataSet employeeDS = new DataSet(); empDA.Fill(employeeDS, "EMPLOYEES"); empDA.InsertCommand = new IfxCommand( "INSERT INTO EMPLOYEE (EMPNO, LASTNAME) " + "VALUES (?, ?)", myIfxConnection); empDA.UpdateCommand = new IfxCommand( "UPDATE EMPLOYEE SET EMPNO = ?, LASTNAME = ? " + "WHERE EMPNO = ?", myIfxConnection); empDA.DeleteCommand = new IfxCommand( "DELETE FROM EMPLOYEE WHERE EMPNO = ?", myIfxConnection); empDA.InsertCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO"); empDA.InsertCommand.Parameters.Add("LASTNAME", IfxType.VarChar, 15, "LASTNAME"); empDA.UpdateCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO"); empDA.UpdateCommand.Parameters.Add("LASTNAME", IfxType.VarChar, 15, "LASTNAME"); empDA.UpdateCommand.Parameters.Add("OLDEMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original; empDA.DeleteCommand.Parameters.Add("EMPNO", IfxType.Char, 6, "EMPNO").SourceVersion = DataRowVersion.Original; }
Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxDataAdapter en la pgina 3-261 Inicializa una nueva instancia de la clase IfxDataAdapter.
Mtodos de IfxDataAdapter
Los mtodos de la clase IfxDataAdapter se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxDataAdapter, consulte el tema Miembros de IfxDataAdapter.
Mtodos pblicos
Nombre CreateObjRef (heredado de MarshalByRefObject) Descripcin Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Sobrecargado. Libera los recursos utilizados por Component.
Dispose (heredado de Component)
3-271
Nombre Equals (heredado de Object) Fill (heredado de DbDataAdapter)
Descripcin Sobrecargado. Determina si dos instancias de Object son iguales. Sobrecargado. Alterado temporalmente. Aade o renueva filas en el DataSet para coincidir con los de la base de datos. Sobrecargado. Alterado temporalmente. Aade una DataTable a un DataSet y configura el esquema para que coincida con el de la base de datos. Alterado temporalmente. Obtiene los parmetros establecidos por el usuario al ejecutar una sentencia SELECT de SQL. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el Type de la instancia actual.
GetFillParameters (heredado de DbDataAdapter) GetHashCode (heredado de Object)
GetLifetimeService (heredado de MarshalByRefObject) GetType (heredado de Object) InitializeLifetimeService (heredado de MarshalByRefObject) ToString (heredado de Object)
Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Devuelve una String que representa el Object actual.
Sobrecargado. Llama a las sentencias Update (heredado de DbDataAdapter) INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o suprimida en el DataSet.
Mtodos protegidos
Nombre AddToBatch (heredado de DbDataAdapter) ClearBatch (heredado de DbDataAdapter) CloneInternals (heredado de DataAdapter) CreateRowUpdatedEvent Elimina todos los objetos IDbCommand del lote. Crea una copia de esta instancia de DataAdapter. Alterado temporalmente. Inicializa una nueva instancia de la clase RowUpdatedEventArgs, independientemente de si la actualizacin es satisfactoria o no. Alterado temporalmente. Inicializa una nueva instancia de la clase RowUpdatingEventArgs. Descripcin Aade un IDbCommand al lote actual.
CreateRowUpdatingEvent
3-272
Nombre CreateTableMappings (heredado de DataAdapter) Dispose (heredado de DbDataAdapter) ExecuteBatch (heredado de DbDataAdapter) Fill (heredado de DbDataAdapter)
Descripcin Crea una nueva DataTableMappingCollection. Sobrecargado. Libera los recursos utilizados por Component. Ejecuta el lote actual.
Sobrecargado. Alterado temporalmente. Aade o renueva filas en el DataSet para coincidir con los de la base de datos. Sobrecargado. Alterado temporalmente. Aade una DataTable a un DataSet y configura el esquema para que coincida con el de la base de datos. Alterado temporalmente. Permite que un Object intente liberar recursos y realizar otras operaciones de limpieza antes de que el Object sea reclamado para la recopilacin de basura. En C# y Microsoft(R) Visual C++(R), los finalizadores se expresan utilizando sintaxis de destructor.
GetBatchedParameter (heredado de DbDataAdapter) GetService (heredado de Component)
Devuelve un IDataParameter de uno de los mandatos del lote actual. Devuelve un objeto que representa un servicio proporcionado por el Component o por su Container. Inicializa el proceso por lotes para el DbDataAdapter. Crea una copia superficial del Object actual.
InitializeBatching (heredado de DbDataAdapter) MemberwiseClone (heredado de Object)
Emite el suceso FillError. OnFillError (heredado de DbDataAdapter) OnRowUpdated Alterado temporalmente. Emite el suceso RowUpdated utilizando un objeto RowUpdatedEventArgs. Alterado temporalmente. Emite el suceso RowUpdating utilizando un objeto RowUpdatingEventArgs, tanto si la operacin de actualizacin es satisfactoria como si no lo es. Determina si existen uno o ms objetos DataTableMapping y si deben persistir.
OnRowUpdating
ShouldSerializeTableMappings (heredado de DataAdapter)
3-273
Nombre TerminateBatching (heredado de DbDataAdapter)
Descripcin Finaliza el proceso por lotes para el DbDataAdapter.
Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataAdapter.CreateRowUpdatedEvent: Inicializa una nueva instancia de la clase RowUpdatedEventArgs, independientemente de si la actualizacin es satisfactoria o no. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overrides Protected Function CreateRowUpdatedEvent( _ ByVal dataRow As DataRow, _ ByVal command As IDbCommand, _ ByVal statementType As StatementType, _ ByVal tableMapping As DataTableMapping _ ) As RowUpdatedEventArgs [C#] protected override RowUpdatedEventArgs CreateRowUpdatedEvent( DataRow dataRow, IDbCommand command, StatementType statementType, DataTableMapping tableMapping ); [C++] protected: RowUpdatedEventArgs* CreateRowUpdatedEvent( DataRow* dataRow, IDbCommand* command, StatementType statementType, DataTableMapping* tableMapping ); [JScript] protected override function CreateRowUpdatedEvent( dataRow : DataRow, command : IDbCommand, statementType : StatementType, tableMapping : DataTableMapping ) : RowUpdatedEventArgs;
Parmetros dataRow DataRow que utiliza para actualizar la base de datos
3-274
command El IfxCommand que se ha ejecutado durante la operacin de actualizacin. statementType Indica si el mandato es una sentencia UPDATE, INSERT, DELETE o SELECT. tableMapping Un objeto DataTableMapping. Valor de retorno Una nueva instancia de la clase System.Data.Common.RowUpdatedEventArgs. Comentarios Notas para los herederos: Al alterar temporalmente CreateRowUpdatedEvent en una clase derivada, asegrese de llamar al mtodo CreateRowUpdatedEvent de la clase base. Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataAdapter.CreateRowUpdatingEvent: Inicializa una nueva instancia de la clase RowUpdatingEventArgs. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overrides Protected Function CreateRowUpdatingEvent( _ ByVal dataRow As DataRow, _ ByVal command As IDbCommand, _ ByVal statementType As StatementType, _ ByVal tableMapping As DataTableMapping _ ) As RowUpdatingEventArgs [C#] protected override RowUpdatingEventArgs CreateRowUpdatingEvent( DataRow dataRow, IDbCommand command, StatementType statementType, DataTableMapping tableMapping ); [C++] protected: RowUpdatingEventArgs* CreateRowUpdatingEvent( DataRow* dataRow, IDbCommand* command,
3-275
StatementType statementType, DataTableMapping* tableMapping ); [JScript] protected override function CreateRowUpdatingEvent( dataRow : DataRow, command : IDbCommand, statementType : StatementType, tableMapping : DataTableMapping ) : RowUpdatingEventArgs;
Parmetros dataRow DataRow que actualiza la base de datos. command El IfxCommand que debe ejecutarse durante la operacin de actualizacin. statementType Indica si el mandato es una sentencia UPDATE, INSERT, DELETE o SELECT. tableMapping Un objeto DataTableMapping. Valor de retorno Una nueva instancia de la clase System.Data.Common.RowUpdatingEventArgs. Comentarios Notas para los herederos: Al alterar temporalmente CreateRowUpdatingEvent en una clase derivada, asegrese de llamar al mtodo CreateRowUpdatingEvent de la clase base. Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataAdapter.OnRowUpdated: Emite el suceso RowUpdated utilizando un objeto RowUpdatedEventArgs. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-276
Sintaxis
Visual Basic] Overrides Protected Sub OnRowUpdated( _ ByVal value As RowUpdatedEventArgs _ ) [C#] protected override void OnRowUpdated( RowUpdatedEventArgs value ); [C++] protected: void OnRowUpdated( RowUpdatedEventArgs* value ); [JScript] protected override function OnRowUpdated( value : RowUpdatedEventArgs );
Parmetros value Un objeto System.Data.Common.RowUpdatedEventArgs que contiene los datos del suceso.
Comentarios Emitir un suceso invoca el manejador de sucesos mediante un delegado. Notas para los herederos: Al alterar temporalmente RowUpdated en una clase derivada, asegrese de llamar al mtodo OnRowUpdated de la clase base. Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataAdapter.OnRowUpdating Emite el suceso RowUpdating utilizando un objeto RowUpdatingEventArgs, tanto si la operacin de actualizacin es satisfactoria como si no lo es. Mtodo IfxDataAdapter.OnRowUpdating: Emite el suceso RowUpdating utilizando un objeto RowUpdatingEventArgs, tanto si la operacin de actualizacin es satisfactoria como si no lo es. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-277
Sintaxis
Visual Basic] Overrides Protected Sub OnRowUpdating( _ ByVal value As RowUpdatingEventArgs _ ) [C#] protected override void OnRowUpdating( RowUpdatingEventArgs value ); [C++] protected: void OnRowUpdating( RowUpdatingEventArgs* value ); [JScript] protected override function OnRowUpdating( value : RowUpdatingEventArgs );
Parmetros value Un objeto System.Data.Common.RowUpdatingEventArgs que contiene los datos del suceso.
Comentarios Emitir un suceso invoca el manejador de sucesos mediante un delegado. Notas para los herederos: Al alterar temporalmente OnRowUpdating en una clase derivada, asegrese de llamar al mtodo OnRowUpdating de la clase base. Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataAdapter.OnRowUpdated en la pgina 3-276 Emite el suceso RowUpdated utilizando un objeto RowUpdatedEventArgs.
Propiedades de IfxDataAdapter
Las propiedades de la clase IfxDataAdapter se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxDataAdapter, consulte el tema Miembros de IfxDataAdapter.
Propiedades pblicas
Nombre AcceptChangesDuringFill (heredada de DataAdapter) Container (heredada de Component) Descripcin Obtiene o establece un valor que indica si se llama a AcceptChanges en una DataRow despus de aadirlo a la DataTable. Obtiene el IContainer que contiene el Component.
3-278
Nombre
Descripcin
Obtiene o establece un valor que especifica ContinueUpdateOnError (heredada de si se debe generar una excepcin, o la fila errnea cuando se produce un error durante DataAdapter) una actualizacin de fila. DeleteCommand Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para suprimir registros en la base de datos. Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para insertar nuevos registros en la base de datos. Determina la accin que se debe emprender cuando los datos entrantes no tienen una tabla o columna coincidente. Determina la accin que se debe emprender cuando el esquema existente de DataSet no coincide con los datos entrantes. Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para seleccionar registros en la base de datos. Obtiene o establece el ISite de Component. Site (heredada de Component) TableMappings (heredada de DataAdapter) UpdateBatchSize Obtiene una coleccin que proporciona la correlacin principal entre una tabla fuente y una DataTable. Sobrecargado. Obtiene o establece el nmero de mandatos de un lote que se deben enviar al servidor de bases de datos para su ejecucin. Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para actualizar registros en la base de datos.
InsertCommand
MissingMappingAction (heredada de DataAdapter) MissingSchemaAction (heredada de DataAdapter) SelectCommand
UpdateCommand
Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-279
Propiedad IfxDataAdapter.DeleteCommand: Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para suprimir registros en la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property DeleteCommand As IfxCommand [C#] public new IfxCommand DeleteCommand {get; set;} [C++] public: __property IfxCommand * get_DeleteCommand(); public: __property void set_DeleteCommand(IfxCommand *); [JScript] public function get DeleteCommand() : IfxCommand ; public function set DeleteCommand(IfxCommand );
Valor de la propiedad IfxCommand utilizado durante una operacin de actualizacin para suprimir los registros de la base de datos que se corresponden con las filas modificadas en el DataSet. Comentarios Cuando la propiedad DeleteCommand est asignada a un IfxCommand creado previamente, el IfxCommand no se clona. En su lugar, DeleteCommand mantiene una referencia al IfxCommand creado previamente. Durante una operacin de actualizacin, si DeleteCommand no est definido y existe informacin de clave primaria en el DataSet, puede utilizar la clase IfxCommandBuilder para generar automticamente el DeleteCommand y los mandatos adicionales necesarios para reconciliar el DataSet con la base de datos. Para hacer esto, defina la propiedad SelectCommand del IfxDataAdapter. La lgica de la generacin tambin necesita que exista informacin de columna de claves en DataSet. Para obtener ms informacin, consulte el apartado Mandatos generados automticamente en la documentacin del SDK de Microsoft(R) .NET Framework. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxDataAdapter y establece algunas de sus propiedades.
Visual Basic] Public Sub CreateIfxDataAdapter() Dim mySelectText As String = _ "SELECT * FROM STAFF ORDER BY ID" Dim myConnString As String = _ "DATABASE=SAMPLE;" Dim myDataAdapter As New IfxDataAdapter(mySelectText, myConnString)
3-280
Dim myDataAdapter.DeleteCommand = New IfxCommand( "DELETE FROM STAFF WHERE JOB =Sales ", myConnString) End Sub [C#] public void CreateIfxDataAdapter () { string mySelectText = "SELECT * FROM STAFF ORDER BY ID"; string myConnString = "DATABASE=SAMPLE;"; IfxDataAdapter myDataAdapter = new IfxDataAdapter(mySelectText,myConnString); myDataAdapter.DeleteCommand = New IfxCommand( "DELETE FROM STAFF WHERE JOB =Sales ", myConnString); }
Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataAdapter.InsertCommand Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para insertar nuevos registros en la base de datos. Propiedad IfxDataAdapter.SelectCommand en la pgina 3-283 Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para seleccionar registros en la base de datos. Propiedad IfxDataAdapter.UpdateCommand en la pgina 3-285 Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para actualizar registros en la base de datos. Propiedad IfxDataAdapter.InsertCommand: Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para insertar nuevos registros en la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property InsertCommand As IfxCommand [C#] public new IfxCommand InsertCommand {get; set;} [C++] public: __property IfxCommand * get_InsertCommand(); public: __property void set_InsertCommand(IfxCommand *); [JScript]
3-281
public function get InsertCommand() : IfxCommand ; public function set InsertCommand(IfxCommand );
Valor de la propiedad IfxCommand utilizado durante una operacin de actualizacin para insertar registros en la base de datos que corresponden a filas nuevas del DataSet. Comentarios Cuando la propiedad InsertCommand est asignada a un objeto IfxCommand creado previamente, el IfxCommand no se clona. En su lugar, InsertCommand mantiene una referencia al IfxCommand creado previamente. Durante una operacin de actualizacin, si InsertCommand no est definido y existe informacin de clave primaria en el DataSet, puede utilizar la clase IfxCommandBuilder para generar automticamente el InsertCommand y los mandatos adicionales necesarios para reconciliar el DataSet con la base de datos. Para hacer esto, defina la propiedad SelectCommand del IfxDataAdapter. La lgica de la generacin tambin necesita que exista informacin de columna de claves en DataSet. Para obtener ms informacin, consulte el apartado Mandatos generados automticamente en la documentacin del SDK de Microsoft(R) .NET Framework. Nota: Si la ejecucin de este mandato devuelve filas, estas filas se pueden aadir al DataSet dependiendo de cmo se haya definido la propiedad IfxCommand.UpdatedRowSource del objeto IfxCommand. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxDataAdapter y establece algunas de sus propiedades.
Visual Basic] Public Sub CreateIfxDataAdapter() Dim mySelectText As String = _ "SELECT * FROM STAFF ORDER BY ID" Dim myConnString As String = _ "DATABASE=SAMPLE;" Dim myDataAdapter As New IfxDataAdapter(mySelectText, myConnString) Dim myDataAdapter.InsertCommand As New IfxCommand( "INSERT INTO STAFF VALUES ( 360, Johnson,84,Clerk,2,11500.00, 100.00)", myConnString) End Sub [C#] public void CreateIfxDataAdapter () { string mySelectText = "SELECT * FROM STAFF ORDER BY ID"; string myConnString = "DATABASE=SAMPLE;"; IfxDataAdapter myDataAdapter = new IfxDataAdapter(mySelectText,myConnString); myDataAdapter.InsertCommand = new IfxCommand( "INSERT INTO STAFF VALUES ( 360, Johnson,84,Clerk,2,11500.00, 100.00)", myConnString); }
Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos.
3-282
Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataAdapter.DeleteCommand en la pgina 3-280 Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para suprimir registros en la base de datos. Propiedad IfxDataAdapter.SelectCommand Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para seleccionar registros en la base de datos. Propiedad IfxDataAdapter.UpdateCommand en la pgina 3-285 Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para actualizar registros en la base de datos. Propiedad IfxDataAdapter.SelectCommand: Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para seleccionar registros en la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property SelectCommand As IfxCommand [C#] public new IfxCommand SelectCommand {get; set;} [C++] public: __property IfxCommand * get_SelectCommand(); public: __property void set_SelectCommand(IfxCommand *); [JScript] public function get SelectCommand() : IfxCommand ; public function set SelectCommand(IfxCommand );
Valor de la propiedad IfxCommand que se utiliza durante una operacin de relleno para seleccionar registros de la base de datos y colocarlos en el DataSet. Comentarios Cuando SelectCommand est asignado a un IfxCommand creado previamente, IfxCommand no se clona. En su lugar, SelectCommand mantiene una referencia al objeto IfxCommand creado previamente. Si SelectCommand no devuelve ninguna fila, no se aaden tablas a DataSet, y no se emite ninguna excepcin.
3-283
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxDataAdapter y establece algunas de sus propiedades.
Visual Basic] Public Sub CreateIfxDataAdapter() Dim myConnection As IfxConnection = New IfxConnection("DATABASE=SAMPLE") Dim myDataAdapter As New IfxDataAdapter() Dim mySelectCommand As New IfxCommand() myDataAdapter.SelectCommand.CommandText = _ "SELECT * FROM STAFF ORDER BY ID" End Sub [C#] public void CreateIfxDataAdapter () { IfxConnection myConnection = new IfxConnection("DATABASE=SAMPLE"); IfxDataAdapter myDataAdapter = new IfxDataAdapter(); IfxCommand mySelectCommand = new IfxCommand(); myDataAdapter.SelectCommand.CommandText = "SELECT * FROM STAFF ORDER BY ID"; }
Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataAdapter.DeleteCommand en la pgina 3-280 Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para suprimir registros en la base de datos. Propiedad IfxDataAdapter.InsertCommand en la pgina 3-281 Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para insertar nuevos registros en la base de datos. Propiedad IfxDataAdapter.UpdateCommand en la pgina 3-285 Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para actualizar registros en la base de datos. Ejemplos DbDatAdp.cs DbDatAdp.vb Propiedad IfxDataAdapter.UpdateBatchSize: Obtiene o establece el nmero de mandatos de un lote que se deben enviar al servidor de bases de datos para su ejecucin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-284
Sintaxis
Visual Basic] Public Overrides Property UpdateBatchSize As Integer [C#] public override int UpdateBatchSize { get; set; } [C++] public: virtual property int UpdateBatchSize { int get () override; void set (int value) override; } [JScript] public override function get UpdateBatchSize () : int public override function set UpdateBatchSize (value : int)
Valor de la propiedad Obtiene o establece un valor entero que especifica el nmero de mandatos que se procesarn en cada lote de mandatos enviado al servidor de bases de datos.
Value 0 1 > 1 Comportamiento Toda la actualizacin se ejecuta en un nico lote. Inhabilita el proceso por lotes. Cada actualizacin se enva a la base de datos individualmente. Nmero de mandatos que se ejecutarn como un lote antes de iniciar un nuevo lote. Si este valor es mayor que el nmero de filas, la actualizacin se realizar como un nico lote.
Ejemplo [C#] Las lneas siguientes de cdigo dan como resultado un tamao de lote de 99.
[C#] IfxDataAdapter adapter = new IfxDataAdapter(); adapter.UpdateBatchSize = 99;
Informacin de versin Versin de .NET Framework Soportado en: 2.0 Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataAdapter.UpdateCommand: Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para actualizar registros en la base de datos.
3-285

Visual Basic] Public Property UpdateCommand As IfxCommand [C#] public new IfxCommand UpdateCommand {get; set;} [C++] public: __property IfxCommand * get_UpdateCommand(); public: __property void set_UpdateCommand(IfxCommand *); [JScript] public function get UpdateCommand() : IfxCommand ; public function set UpdateCommand(IfxCommand );
Valor de la propiedad IfxCommand utilizado durante una operacin de actualizacin para actualizar registros en la base de datos que corresponden a filas modificadas del DataSet. Comentarios Cuando UpdateCommand est asignado a un IfxCommand creado previamente, IfxCommand no se clona. En su lugar, UpdateCommand mantiene una referencia al objeto IfxCommand creado previamente. Durante una operacin de actualizacin, si UpdateCommand no est definido y existe informacin de clave primaria en el DataSet, puede utilizar la clase IfxCommandBuilder para generar automticamente UpdateCommand y los mandatos adicionales necesarios para reconciliar el DataSet con la base de datos. Para hacer esto, defina la propiedad SelectCommand del IfxDataAdapter. La lgica de la generacin tambin necesita que exista informacin de columna de claves en DataSet. Para obtener ms informacin, consulte el apartado Mandatos generados automticamente en la documentacin del SDK de Microsoft(R) .NET Framework. Nota: Si la ejecucin de este mandato devuelve filas, estas filas se pueden fusionar con el DataSet dependiendo de cmo se haya definido la propiedad IfxCommand.UpdatedRowSource del objeto IfxCommand. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxDataAdapter y establece algunas de sus propiedades.
Visual Basic] Public Sub CreateIfxDataAdapter() Dim mySelectText As String = _ "SELECT * FROM STAFF ORDER BY ID" Dim myConn As New IfxConnection _ ("DATABASE=SAMPLE;") Dim myDataAdapter As New IfxDataAdapter(mySelectText, myConn) Dim myDataAdapter.UpdateCommand As New IfxCommand( "UPDATE STAFF SET DEPT=100 where JOB=Mgr", myConnString)
3-286
End Sub [C#] public void CreateIfxDataAdapter () { string mySelectText = "SELECT * FROM STAFF ORDER BY ID"; IfxConnection myConn = new IfxConnection("DATABASE=SAMPLE;"); IfxDataAdapter myDataAdapter = new IfxDataAdapter(mySelectText,myConn); myDataAdapter.UpdateCommand = new IfxCommand( "UPDATE STAFF SET DEPT=100 where JOB=Mgr", myConnString); }
Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataAdapter.DeleteCommand en la pgina 3-280 Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para suprimir registros en la base de datos. Propiedad IfxDataAdapter.InsertCommand en la pgina 3-281 Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para insertar nuevos registros en la base de datos. Propiedad IfxDataAdapter.SelectCommand en la pgina 3-283 Obtiene o establece una sentencia de SQL o un procedimiento almacenado utilizado para seleccionar registros en la base de datos.
Sucesos de IfxDataAdapter
Los sucesos de la clase IfxDataAdapter se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxDataAdapter, consulte el tema Miembros de IfxDataAdapter.
Sucesos pblicos
Nombre Disposed (heredado de Component) Descripcin Sobrecargado. Aade un manejador de sucesos para escuchar al suceso Disposed en el componente.
Devuelto cuando se produce un error FillError (heredado de DbDataAdapter) durante una operacin de relleno. RowUpdated Se produce durante una operacin de actualizacin despus de ejecutar un mandato contra la base de datos. Se produce durante Update antes de ejecutar un mandato contra la base de datos.
RowUpdating
Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos.
3-287
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbEvent.cs DbEvent.vb Suceso IfxDataAdapter.RowUpdated: Se produce durante una operacin Update despus de ejecutar un mandato en la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Event RowUpdated As IfxRowUpdatedEventHandler [C#] public event IfxRowUpdatedEventHandler RowUpdated; [C++] public: __event IfxRowUpdatedEventHandler * RowUpdated;
[JScript] En JScript(R), puede manejar los sucesos definidos por una clase, pero no podr declarar nuevos eventos. Datos de suceso El manejador de sucesos recibe un argumento de tipo IfxRowUpdatedEventArgs que contiene datos relacionados con este suceso. Las siguientes propiedades IfxRowUpdatedEventArgs proporcionan informacin especfica para este suceso.
Propiedad IfxRowUpdatingEventArgs.Command Descripcin Obtiene el IfxCommand que se ejecuta cuando se llama a Update.
Errors (heredado de RowUpdatedEventArgs) Obtiene los errores que gener IBM Data Server Provider for .NET cuando se ejecut el Command. RecordsAffected (heredado de RowUpdatedEventArgs) Row (heredado de RowUpdatedEventArgs) StatementType (heredado de RowUpdatedEventArgs) Obtiene el nmero de filas cambiadas, insertadas o suprimidas por la ejecucin de la sentencia de SQL. Obtiene la DataRow enviada mediante una Update. Obtiene el tipo de sentencia de SQL ejecutada.
Status (heredado de RowUpdatedEventArgs) Obtiene el UpdateStatus del Command. TableMapping (heredado de RowUpdatedEventArgs) Obtiene la DataTableMapping enviada mediante una Update.
3-288
Comentarios Al utilizar el mtodo Update, se producen dos sucesos por cada fila de datos actualizada. El orden de ejecucin es el siguiente: 1. Los valores de DataRow se mueven a los valores de parmetro. 2. Se emite el suceso OnRowUpdating. 3. Se ejecuta el mandato. 4. Si la enumeracin UpdateRowSource se establece en FirstReturnedRecord, el primer resultado devuelto se coloca en DataRow. 5. Si hay parmetros de salida, se colocan en DataRow. 6. Se emite el suceso OnRowUpdated. 7. Se llama a AcceptChanges. Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbEvent.cs DbEvent.vb Suceso IfxDataAdapter.RowUpdating: Se produce durante una operacin Update antes de ejecutar el mandato en la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Event RowUpdating As IfxRowUpdatingEventHandler [C#] public event IfxRowUpdatingEventHandler RowUpdating; [C++] public: __event IfxRowUpdatingEventHandler* RowUpdating;
[JScript] En JScript(R), puede manejar los sucesos definidos por una clase, pero no podr declarar nuevos eventos.
3-289
Datos de suceso El manejador de sucesos recibe un argumento de tipo IfxRowUpdatingEventArgs que contiene datos relacionados con este suceso. Las siguientes propiedades IfxRowUpdatingEventArgs proporcionan informacin especfica para este suceso.
Propiedad IfxRowUpdatingEventArgs.Command Errors (heredado de RowUpdatingEventArgs) Row (heredado de RowUpdatingEventArgs) StatementType (heredado de RowUpdatingEventArgs) Status (heredado de RowUpdatingEventArgs) TableMapping (heredado de RowUpdatingEventArgs) Descripcin Obtiene o establece el IfxCommand que se debe ejecutar cuando se llama a Update. Obtiene los errores generados por IBM Data Server Provider for .NET cuando se ejecuta Command. Obtiene la DataRow que se va a enviar mediante una Update. Obtiene el tipo de sentencia de SQL que se va a ejecutar. Obtiene el UpdateStatus del Command. Obtiene la DataTableMapping que se va a enviar mediante la Update.
Comentarios Al utilizar el mtodo Update, se producen dos sucesos por cada fila de datos actualizada. El orden de ejecucin es el siguiente: 1. Los valores de DataRow se mueven a los valores de parmetro. 2. Se emite el suceso OnRowUpdating. 3. Se ejecuta el mandato. 4. Si la enumeracin UpdateRowSource se establece en FirstReturnedRecord, el primer resultado devuelto se coloca en DataRow. 5. Si hay parmetros de salida, se colocan en DataRow. 6. Se emite el suceso OnRowUpdated. 7. Se llama a AcceptChanges. Consulta Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Miembros de IfxDataAdapter en la pgina 3-257 Visin general de IfxDataAdapter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbEvent.cs DbEvent.vb
3-290
Clase IfxDataReader
Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)

System.Object System.MarshalByRefObject IBM.Data.Informix.IfxDataReader

System.Object System.MarshalByRefObject System.Data.Common.DbDataReader IBM.Data.Informix.IfxDataReader

Visual Basic] NotInheritable Public Class IfxDataReader Inherits MarshalByRefObject Implements IDataReader, IEnumerable [C#] public sealed class IfxDataReader : MarshalByRefObject, IDataReader, IEnumerable [C++] public __gc __sealed class IfxDataReader : public MarshalByRefObject, IDataReader, IEnumerable [JScript] public class IfxDataReader extends MarshalByRefObject implements IDataReader, IEnumerable

Visual Basic] NotInheritable Public Class IfxDataReader Inherits MarshalByRefObject Implements IDataReader, IDisposable, IDataRecord, IEnumerable [C#] public sealed class IfxDataReader : MarshalByRefObject, IDataReader, IDisposable, IDataRecord, IEnumerable [C++] public __gc __sealed class IfxDataReader : public MarshalByRefObject, IDataReader, IDisposable, IDataRecord, IEnumerable [JScript] public class IfxDataReader extends MarshalByRefObject implements IDataReader, IDisposable, IDataRecord, IEnumerable
Comentarios
Para crear un IfxDataReader, debe llamar al IfxCommand.ExecuteReader method del objeto IfxCommand, en lugar de utilizar directamente un constructor.
3-291
Puede acceder simultneamente a datos desde varias instancias de IfxDataReader que utilizan la misma instancia de IfxConnection. Cada instancia de IfxDataReader debe estar asociada con su propia instancia de IfxCommand. Los cambios realizados en un conjunto de resultados por otro proceso o por otra hebra mientras se estn leyendo datos pueden ser visibles para el usuario del IfxDataReader. Sin embargo, el comportamiento preciso depende del tiempo. Si la aplicacin necesita desplazarse por los conjuntos de resultados en varias direcciones, o insertar, actualizar o suprimir filas, puede utilizr una instancia de IfxResultSet. IsClosed y RecordsAffected son las nicas propiedades que puede invocar despus de cerrar IfxDataReader. En algunos casos, deber llamar a Close antes de poder llamar a RecordsAffected.
Ejemplo
[Visual Basic, C#] El ejemplo siguiente crea una IfxConnection, un IfxCommand y un IfxDataReader. El ejemplo lee los datos y los escribe en la consola. Finalmente, el ejemplo cierra el IfxDataReader y luego la IfxConnection.
[Visual Basic] Public Sub ReadMyData(myConnString As String) Dim mySelectQuery As String = "SELECT SALES, SALES_PERSON FROM SALES" Dim myConnection As New IfxConnection(myConnString) Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myConnection.Open() Dim myReader As IfxDataReader myReader = myCommand.ExecuteReader() Always call Read before accessing data. While myReader.Read() Console.WriteLine(myReader.GetInt32(0).ToString() + ", " _ + myReader.GetString(1)) End While always call Close when done reading. myReader.Close() Close the connection when done with it. myConnection.Close() End Sub [C#] public void ReadMyData(string myConnString) { string mySelectQuery = "SELECT SALES, SALES_PERSON FROM SALES"; IfxConnection myConnection = new IfxConnection(myConnString); IfxCommand myCommand = new IfxCommand(mySelectQuery,myConnection); myConnection.Open(); IfxDataReader myReader; myReader = myCommand.ExecuteReader(); // Always call Read before accessing data. while (myReader.Read()) { Console.WriteLine(myReader.GetInt32(0) + ", " + myReader.GetString(1)); } // always call Close when done reading. myReader.Close(); // Close the connection when done with it. myConnection.Close(); }
3-292
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxDataReader Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Miembros de IfxDataReader
Visin general de IfxDataReader
Propiedades pblicas
Depth FieldCount HasRows IsClosed This Sobrecargado. Obtiene el valor de una columna en su formato nativo. En C#, esta propiedad es el indexador para la clase IfxDataReader. RecordsAffected Obtiene el nmero de filas cambiadas, insertadas o suprimidas por la ejecucin de la sentencia de SQL. Obtiene un valor que indica la profundidad de anidacin para la fila actual. Obtiene el nmero de columnas de la fila actual. Obtiene un valor que indica si IfxDataReader contiene una o ms filas. Indica si IfxDataReader est cerrado.
Mtodos pblicos
Cierra el objeto IfxDataReader. Close CreateObjRef (heredado de MarshalByRefObject) Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Sobrecargado. Determina si dos instancias de Object son iguales. Obtiene el valor de la columna especificada como un Booleano.
Equals (heredado de Object) GetBoolean
3-293
GetByte GetBytes
Obtiene el valor de la columna especificada como un byte. Lee una corriente de bytes desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio determinado. Obtiene el valor de la columna especificada como un carcter. Lee una corriente de caracteres desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio determinado. Obtiene el nombre del tipo de datos fuente.
GetChar GetChars
GetDataTypeName GetDate GetDateTime GetIfxBinary GetIfxBlob GetIfxClob GetIfxDate GetIfxDecimal GetIfxDouble GetIfxInt16 GetIfxInt32 GetIfxInt64 GetIfxReal GetIfxReal370 GetIfxRowId GetIfxString GetIfxTime Obtiene el valor de la columna especificada como un objeto Date. Obtiene el valor de la columna especificada como un objeto DateTime. Crea una instancia de un objeto IfxBinary a partir de los datos de columna. Crea una instancia de un objeto IfxBlob a partir de los datos de columna. Crea una instancia de un objeto IfxClob a partir de los datos de columna. Crea una instancia de un objeto IfxDate a partir de los datos de columna. Crea una instancia de un objeto IfxDecimal a partir de los datos de columna. Crea una instancia de un objeto IfxDouble a partir de los datos de columna. Crea una instancia de un objeto IfxInt16 a partir de los datos de columna. Crea una instancia de un objeto IfxInt32 a partir de los datos de columna. Crea una instancia de un objeto IfxInt64 a partir de los datos de columna. Crea una instancia de un objeto IfxReal a partir de los datos de columna. Crea una instancia de un objeto IfxReal370 a partir de los datos de columna. Crea una instancia de un objeto IfxRowId a partir de los datos de columna. Crea una instancia de un objeto IfxString a partir de los datos de columna. Crea una instancia de un objeto IfxTime a partir de los datos de columna.
3-294
GetIfxTimeStamp
Crea una instancia de un objeto IfxTimeStamp a partir de los datos de columna. Crea una instancia de Object a partir de datos de columna. Obtiene todos los valores de las columnas correspondientes a la fila actual. Obtiene el valor de la columna especificada como un objeto Decimal. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin doble. Devuelve un enumerador que ejecuta un proceso iterativo sobre IfxDataReader. Obtiene el Type que es el tipo de datos del objeto. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin simple. No est soportado.
GetIfxValue GetIfxValues GetDecimal GetDouble
GetEnumerator GetFieldType GetFloat
GetGuid GetHashCode (heredado de Object) Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el valor de la columna especificada como un entero con signo de 16 bits. Obtiene el valor de la columna especificada como un entero con signo de 32 bits. Obtiene el valor de la columna especificada como un entero con signo de 64 bits. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el nombre de la columna especificada. Obtiene el ordinal de columna, dado el nombre de la columna. Devuelve DataTable que describe los metadatos de columna de IfxDataReader. Obtiene el valor de la columna especificada, en forma de objeto System.IO.Stream. Obtiene el valor de la columna especificada como una serie de caracteres. Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna especificada en forma de objeto TimeSpan.
GetInt16 GetInt32 GetInt64 GetLifetimeService (heredado de MarshalByRefObject) GetName GetOrdinal GetSchemaTable GetStream GetString GetTime GetTimeSpan
3-295
Obtiene el Type de la instancia actual. GetType (heredado de Object) GetValue GetValues InitializeLifetimeService (heredado de MarshalByRefObject) IsDBNull NextResult Obtiene el valor de la columna en el ordinal especificado en su formato nativo. Obtiene todas las columnas de atributos en la fila actual. Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Obtiene un valor que indica si la columna contiene valores no existentes o si faltan. Avanza IfxDataReader hasta el siguiente resultado cuando se leen los resultados de las sentencias de SQL de proceso por lotes o un procedimiento almacenado de mltiples conjuntos de resultados. Avanza el IfxDataReader al siguiente registro. Devuelve una String que representa el Object actual.
Read ToString (heredado de Object)
Mtodos protegidos
Crea una copia superficial del Object actual. MemberwiseClone (heredado de Object)
Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxDataReader
Los mtodos de la clase IfxDataReader se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxDataReader, consulte el tema Miembros de IfxDataReader.
Mtodos pblicos
Cierra el objeto IfxDataReader. Close CreateObjRef (heredado de MarshalByRefObject) Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.
3-296
Equals (heredado de Object) GetBoolean GetByte GetBytes
Sobrecargado. Determina si dos instancias de Object son iguales. Obtiene el valor de la columna especificada como un Booleano. Obtiene el valor de la columna especificada como un byte. Lee una corriente de bytes desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio determinado. Obtiene el valor de la columna especificada como un carcter. Lee una corriente de caracteres desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio determinado. Obtiene el nombre del tipo de datos fuente.
GetChar GetChars
GetDataTypeName GetDate GetDateTime GetIfxBinary GetIfxBlob GetIfxClob GetIfxDate GetIfxDecimal GetIfxDouble GetIfxInt16 GetIfxInt32 GetIfxInt64 GetIfxReal GetIfxReal370 GetIfxRowId Obtiene el valor de la columna especificada como un objeto Date. Obtiene el valor de la columna especificada como un objeto DateTime. Crea una instancia de un objeto IfxBinary a partir de los datos de columna. Crea una instancia de un objeto IfxBlob a partir de los datos de columna. Crea una instancia de un objeto IfxClob a partir de los datos de columna. Crea una instancia de un objeto IfxDate a partir de los datos de columna. Crea una instancia de un objeto IfxDecimal a partir de los datos de columna. Crea una instancia de un objeto IfxDouble a partir de los datos de columna. Crea una instancia de un objeto IfxInt16 a partir de los datos de columna. Crea una instancia de un objeto IfxInt32 a partir de los datos de columna. Crea una instancia de un objeto IfxInt64 a partir de los datos de columna. Crea una instancia de un objeto IfxReal a partir de los datos de columna. Crea una instancia de un objeto IfxReal370 a partir de los datos de columna. Crea una instancia de un objeto IfxRowId a partir de los datos de columna.
3-297
GetIfxString GetIfxTime GetIfxTimeStamp
Crea una instancia de un objeto IfxString a partir de los datos de columna. Crea una instancia de un objeto IfxTime a partir de los datos de columna. Crea una instancia de un objeto IfxTimeStamp a partir de los datos de columna. Crea una instancia de Object a partir de datos de columna. Obtiene todos los valores de las columnas correspondientes a la fila actual. Obtiene el valor de la columna especificada como un objeto Decimal. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin doble. Devuelve un enumerador que ejecuta un proceso iterativo sobre IfxDataReader. Obtiene el Type que es el tipo de datos del objeto. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin simple. No est soportado.
GetIfxValue GetIfxValues GetDecimal GetDouble
GetEnumerator GetFieldType GetFloat
GetGuid GetHashCode (heredado de Object) Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el valor de la columna especificada como un entero con signo de 16 bits. Obtiene el valor de la columna especificada como un entero con signo de 32 bits. Obtiene el valor de la columna especificada como un entero con signo de 64 bits. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el nombre de la columna especificada. Obtiene el ordinal de columna, dado el nombre de la columna. Devuelve DataTable que describe los metadatos de columna de IfxDataReader. Obtiene el valor de la columna especificada, en forma de objeto System.IO.Stream. Obtiene el valor de la columna especificada como una serie de caracteres.
GetInt16 GetInt32 GetInt64 GetLifetimeService (heredado de MarshalByRefObject) GetName GetOrdinal GetSchemaTable GetStream GetString
3-298
GetTime GetTimeSpan GetType (heredado de Object) GetValue GetValues InitializeLifetimeService (heredado de MarshalByRefObject) IsDBNull NextResult
Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna especificada en forma de objeto TimeSpan. Obtiene el Type de la instancia actual. Obtiene el valor de la columna en el ordinal especificado en su formato nativo. Obtiene todas las columnas de atributos en la fila actual. Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Obtiene un valor que indica si la columna contiene valores no existentes o si faltan. Avanza IfxDataReader hasta el siguiente resultado cuando se leen los resultados de las sentencias de SQL de proceso por lotes o un procedimiento almacenado de mltiples conjuntos de resultados. Avanza el IfxDataReader al siguiente registro. Devuelve una String que representa el Object actual.
Read ToString (heredado de Object)
Mtodos protegidos
Crea una copia superficial del Object actual. MemberwiseClone (heredado de Object)
Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.Close: Cierra el objeto IfxDataReader. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-299
Sintaxis
Visual Basic] Public Sub Close() [C#] public void Close(); [C++] public: void Close(); [JScript] public function Close();
Comentarios Debe llamar explcitamente al mtodo Close cuando termine de utilizar IfxDataReader o IfxResultSet para poder utilizar el IfxCommand asociado para cualquier otra finalidad. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection, un IfxCommand y un IfxDataReader. El ejemplo lee los datos y los escribe en la consola. Finalmente, el ejemplo cierra el IfxDataReader y luego la IfxConnection.
Visual Basic] Public Sub ReadMyData(myConnString As String) Dim mySelectQuery As String = "SELECT ID, NAME FROM STAFF" Dim myConnection As New IfxConnection(myConnString) Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myConnection.Open() Dim myReader As IfxDataReader myReader = myCommand.ExecuteReader() Always call Read before accessing data. While myReader.Read() Console.WriteLine(myReader.GetInt16(0).ToString() + ", " _ + myReader.GetString(1)) End While always call Close when done reading. myReader.Close() Close the connection when done with it. myConnection.Close() End Sub [C#] public void ReadMyData(string myConnString) { string mySelectQuery = "SELECT ID, NAME FROM STAFF"; IfxConnection myConnection = new IfxConnection(myConnString); IfxCommand myCommand = new IfxCommand(mySelectQuery,myConnection); myConnection.Open(); IfxDataReader myReader; myReader = myCommand.ExecuteReader(); // Always call Read before accessing data. while (myReader.Read()) { Console.WriteLine(myReader.GetInt16(0) + ", " + myReader.GetString(1)); } // always call Close when done reading. myReader.Close(); // Close the connection when done with it. myConnection.Close(); }
Consulta
3-300
Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos TbUse.cs TbUse.vb Mtodo IfxDataReader.GetBoolean: Obtiene el valor de la columna especificada como un Booleano. Este mtodo no est soportado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetBoolean( _ ByVal i As Integer _ ) As Boolean [C#] public bool GetBoolean( int i ); [C++] public: bool GetBoolean( int i ); [JScript] public function GetBoolean( i : int ) : Boolean;
Parmetros i El ordinal de columna basado en cero.
Valor de retorno Un Booleano que es el valor de la columna. Excepciones

Tipo de excepcin InvalidCastException IfxException Condicin La difusin especificada no es vlida. Conversin no vlida.
3-301
Comentarios Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetByte: Obtiene el valor de la columna especificada como un byte. Este mtodo no est soportado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetByte( _ ByVal i As Integer _ ) As Byte [C#] public byte GetByte( int i ); [C++] public: unsigned char GetByte( int i ); [JScript] public function GetByte( i : int ) : Byte;
Valor de retorno El valor de la columna especificada como un byte.
3-302
Excepciones
Comentarios Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetBytes: Lee una corriente de bytes desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio determinado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetBytes( _ ByVal i As Integer, _ ByVal dataIndex As Long, _ ByVal buffer() As Byte, _ ByVal bufferIndex As Integer, _ ByVal length As Integer _ ) As Long [C#] public long GetBytes( int i, long dataIndex, byte[] buffer, int bufferIndex, int length ); [C++] public: __int64 GetBytes( int i, __int64 dataIndex, unsigned char buffer __gc[], int bufferIndex, int length
3-303
); [JScript] public function GetBytes( i : int, dataIndex : long, buffer : Byte[], bufferIndex : int, length : int ) : long;
dataIndex ndice dentro del campo donde debe comenzar la operacin de lectura. buffer Almacenamiento intermedio donde se copia y lee la corriente de bytes. bufferIndex El ndice donde buffer debe empezar la operacin de grabacin. length El nmero de bytes que se va a leer. Valor de retorno El nmero real de bytes ledos. Excepciones
Tipo de excepcin IfxException Condicin Conversin no vlida.
Comentarios GetBytes devuelve el nmero de bytes disponibles en el campo. En la mayora de casos esta es la longitud exacta del campo. Sin embargo, el nmero devuelto puede ser menor que la longitud verdadera del campo si GetBytes ya se ha utilizado para obtener bytes del campo. Este caso puede darse, por ejemplo, si IfxDataReader est leyendo un BLOB en un almacenamiento intermedio. Para obtener ms informacin, consulte el valor SequentialAccess de System.Data.CommandBehavior en la documentacin del SDK de Microsoft(R) .NET Framework. Si especifica un almacenamiento intermedio que es un valor nulo, GetBytes devuelve la longitud del campo en bytes. No se realizan conversiones. El tipo de los datos que se deben recuperar debe ser uno de los siguientes: v IfxType.Blob La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx Blob Tipo de datos Informix BLOB, BYTE
Consulta
3-304
Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DtLob.cs DtLob.vb Mtodo IfxDataReader.GetChar: Obtiene el valor de la columna especificada como un carcter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetChar( _ ByVal i As Integer _ ) As Char [C#] public char GetChar( int i ); [C++] public: __wchar_t GetChar( int i ); [JScript] public function GetChar( i : int ) : Char;
Valor de retorno El valor de la columna especificada como un carcter. Excepciones

3-305
Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser uno de los siguientes tipos: v IfxType.Char v IfxType.VarChar v IfxType.LongVarChar v IfxType.Clob La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx Char VarChar LongVarChar Clob Tipo de datos Informix CHAR VARCHAR LVARCHAR CLOB, TEXT
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetChars: Lee una corriente de caracteres desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio determinado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetChars( _ ByVal i As Integer, _ ByVal dataIndex As Long, _ ByVal buffer() As Char, _ ByVal bufferIndex As Integer, _ ByVal length As Integer _
3-306
) As Long [C#] public long GetChars( int i, long dataIndex, char[] buffer, int bufferIndex, int length ); [C++] public: __int64 GetChars( int i, __int64 dataIndex, __wchar_t buffer __gc[], int bufferIndex, int length ); [JScript] public function GetChars( i : int, dataIndex : long, buffer : Char[], bufferIndex : int, length : int ) : long;
dataIndex El ndice de la fila donde debe empezar la operacin de lectura. buffer El almacenamiento intermedio en el que se deben copiar los datos. bufferIndex El ndice donde buffer debe empezar la operacin de grabacin. length El nmero de caracteres que se va a leer. Valor de retorno El nmero real de caracteres ledos. Excepciones
Comentarios GetChars devuelve el nmero de caracteres disponibles en el campo. En la mayora de casos esta es la longitud exacta del campo. Sin embargo, el nmero devuelto puede ser inferior a la longitud verdadera del campo si GetChars ya se ha utilizado para obtener caracteres del campo. Este caso puede darse, por ejemplo, si IfxDataReader est leyendo un CLOB en un almacenamiento intermedio. Para obtener ms informacin, consulte el valor SequentialAccess de System.Data.CommandBehavior en la documentacin del SDK de Microsoft(R) .NET Framework. Si pasa un almacenamiento intermedio que es un valor nulo, GetChars devuelve la longitud del campo en caracteres.
3-307
No se realizan conversiones. Los datos que se van a recuperar deben ser uno de los siguientes tipos: v IfxType.Char v IfxType.VarChar v v IfxType.LongVarChar IfxType.Clob
La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxBinary: Crea una instancia de un objeto IfxBinary a partir de los datos de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxBinary( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxBinary [C#] public IBM.Data.IfxTypes.IfxBinary GetIfxBinary (int i) [C++] public: IBM.Data.IfxTypes.IfxBinary GetIfxBinary( int i ); [JScript] public function GetIfxBinary( i : int ) : IBM.Data.IfxTypes.IfxBinary;
3-308
Valor de retorno Objeto IfxBinary que representa el valor de columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos. Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Estructura IfxBinary en la pgina 3-803 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxBlob: Crea una instancia de un objeto IfxBlob a partir de los datos de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxBlob( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxBlob [C#] public IBM.Data.IfxTypes.IfxBlob GetIfxBlob (int i) [C++] public: IBM.Data.IfxTypes.IfxBlob GetIfxBlob( int i );
3-309
[JScript] public function GetIfxBlob( i : int ) : IBM.Data.IfxTypes.IfxBlob;
Valor de retorno Objeto IfxBlob que representa el valor de la columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx DB2Blob Tipo de datos Informix BLOB, BYTE
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxClob: Crea una instancia de un objeto IfxClob a partir de los datos de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-310
Sintaxis
Visual Basic] Public Function GetIfxClob( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxClob [C#] public IBM.Data.IfxTypes.IfxClob GetIfxClob (int i) [C++] public: IBM.Data.IfxTypes.IfxClob GetIfxClob( int i ); [JScript] public function GetIfxClob( i : int ) : IBM.Data.IfxTypes.IfxClob;
Valor de retorno Objeto IfxClob que representa el valor de columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx IfxClob Tipo de datos Informix CLOB, TEXT
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Clase IfxClob en la pgina 3-811 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-311
Mtodo IfxDataReader.GetIfxDate: Crea una instancia de un objeto IfxDate a partir de los datos de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxDate( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxDate [C#] public IBM.Data.IfxTypes.IfxDate GetIfxDate (int i) [C++] public: IBM.Data.IfxTypes.IfxDate GetIfxDate( int i ); [JScript] public function GetIfxDate( i : int ) : IBM.Data.IfxTypes.IfxDate;
Valor de retorno Objeto IfxDate que representa el valor de la columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx IfxDate Tipo de datos Informix DATETIME (date precision)
Excepciones
3-312
Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxDecimal: Crea una instancia de un objeto IfxDecimal a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxDecimal( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxDecimal [C#] public IBM.Data.IfxTypes.IfxDecimal GetIfxDecimal (int i) [C++] public: IBM.Data.IfxTypes.IfxDecimal GetIfxDecimal( int i ); [JScript] public function GetIfxDecimal( i : int ) : IBM.Data.IfxTypes.IfxDecimal;
Valor de retorno Objeto IfxDecimal que representa el valor de columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx IfxDecimal Tipo de datos Informix MONEY
3-313
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxDouble: Crea una instancia de un objeto IfxDouble a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxDouble( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxDouble [C#] public IBM.Data.IfxTypes.IfxDouble GetIfxDouble (int i) [C++] public: IBM.Data.IfxTypes.IfxDouble GetIfxDouble( int i ); [JScript] public function GetIfxDouble( i : int ) : IBM.Data.IfxTypes.IfxDouble;
Valor de retorno Objeto IfxDouble que representa el valor de columna.
3-314
Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx IfxDouble Tipo de datos Informix DECIMAL (31), DOUBLE PRECISION
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxInt16: Crea una instancia de un objeto IfxInt16 a partir de los datos de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxInt16( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxInt16 [C#] public IBM.Data.IfxTypes.IfxInt16 GetIfxInt16 (int i) [C++] public: IBM.Data.IfxTypes.IfxInt16 GetIfxInt16( int i );
3-315
[JScript] public function GetIfxInt16( i : int ) : IBM.Data.IfxTypes.IfxInt16;
Valor de retorno Objeto IfxInt16 que representa el valor de la columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx IfxInt16 Tipo de datos Informix BOOLEAN, SMALLINT
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxInt32: Crea una instancia de un objeto IfxInt32 a partir de los datos de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-316
Sintaxis
Visual Basic] Public Function GetIfxInt32( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxInt32 [C#] public IBM.Data.IfxTypes.IfxInt32 GetIfxInt32 (int i) [C++] public: IBM.Data.IfxTypes.IfxInt32 GetIfxInt32( int i ); [JScript] public function GetIfxInt32( i : int ) : IBM.Data.IfxTypes.IfxInt32;
Valor de retorno Objeto IfxInt32 que representa el valor de columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx IfxInt32 Tipo de datos Informix INT, INTEGER, SERIAL
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-317
Mtodo IfxDataReader.GetIfxInt64: Crea una instancia de un objeto IfxInt64 a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Tipo de datos Ifx IfxInt64 Tipo de datos Informix INT8, SERIAL8
Excepciones
3-318
Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxReal370: Crea una instancia de un objeto IfxReal370 a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxReal370( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxReal370 [C#] public IBM.Data.IfxTypes.IfxReal370 GetIfxReal370 (int i) [C++] public: IBM.Data.IfxTypes.IfxReal370 GetIfxReal370( int i ); [JScript] public function GetIfxReal370( i : int ) : IBM.Data.IfxTypes.IfxReal370;
Valor de retorno Un objeto IfxReal370 representa el valor de la columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx IfxReal370 Tipo de datos Informix REAL, SMALLFLOAT
3-319
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxReal: Crea una instancia de un objeto IfxReal a partir de los datos de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxReal( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxReal [C#] public IBM.Data.IfxTypes.IfxReal GetIfxReal (int i) [C++] public: IBM.Data.IfxTypes.IfxReal GetIfxReal( int i ); [JScript] public function GetIfxReal( i : int ) : IBM.Data.IfxTypes.IfxReal;
Valor de retorno Objeto IfxReal que representa el valor de columna.
3-320
Tipo de datos Ifx IfxReal Tipo de datos Informix REAL, SMALLFLOAT
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxRowId: Crea una instancia de un objeto IfxRowId a partir de los datos de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxRowId( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxRowId [C#] public IBM.Data.IfxTypes.IfxRowId GetIfxRowId (int i) [C++] public: IBM.Data.IfxTypes.IfxRowId GetIfxRowId( int i );
3-321
[JScript] public function GetIfxRowId( i : int ) : IBM.Data.IfxTypes.IfxRowId;
Valor de retorno Objeto IfxRowId que representa el valor de columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos. Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Estructura IfxRowId en la pgina 3-913 Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxString: Crea una instancia de un objeto IfxString a partir de los datos de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-322
Sintaxis
Visual Basic] Public Function GetIfxString( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxString [C#] public IBM.Data.IfxTypes.IfxString GetIfxString (int i) [C++] public: IBM.Data.IfxTypes.IfxString GetIfxString( int i ); [JScript] public function GetIfxString( i : int ) : IBM.Data.IfxTypes.IfxString;
Valor de retorno Objeto IfxString que representa el valor de columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx IfxString Tipo de datos Informix CHAR, VARCHAR, LVARCHAR
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Estructura IfxString en la pgina 3-919 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-323
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxTime: Crea una instancia de un objeto IfxTime a partir de los datos de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxTime( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxTime [C#] public IBM.Data.IfxTypes.IfxTime GetIfxTime (int i) [C++] public: IBM.Data.IfxTypes.IfxTime GetIfxTime( int i ); [JScript] public function GetIfxTime( i : int ) : IBM.Data.IfxTypes.IfxTime;
Valor de retorno Objeto IfxTime que representa el valor de columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx IfxTime Tipo de datos Informix DATETIME (time precision)
Excepciones
3-324
Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxTimeStamp: Crea una instancia de un objeto IfxTimeStamp a partir de los datos de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxTimeStamp( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxTimeStamp [C#] public IBM.Data.IfxTypes.IfxTimeStamp GetIfxTimeStamp (int i) [C++] public: IBM.Data.IfxTypes.IfxTimeStamp GetIfxTimeStamp( int i ); [JScript] public function GetIfxTimeStamp( i : int ) : IBM.Data.IfxTypes.IfxTimeStamp;
Valor de retorno Objeto IfxTimeStamp que representa el valor de la columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx IfxTimeStamp Tipo de datos Informix DATETIME (date and time precision)
3-325
El tipo de datos Informix DATETIME tiene el formato interno como AAAA-MM-DD HH:MM:SS.nnnnn, el tipo de datos IfxType, TIMESTAMP, tiene un formato de AAAA-MM-DD-HH.MM.SS.nnnnnn. Esta diferencia en formato en la parte fraccional requiere un pequeo ajuste para que coincidan los formato. Al leer de la base de datos, se aadir un cero como dgito menos significativo para que coincida con los seis dgitos fraccionales. De forma similar, cuando se escriba en la base de datos, se truncar el dgito menos significativo en la fraccin para que coincida con el formato de tipo Informix DATETIME. Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxValue: Crea una instancia de Object a partir de datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxValue( _ ByVal i As Integer _ ) As Object [C#] public object GetIfxValue (int i) [C++] public: Object GetIfxValue( int i ); [JScript] public function GetIfxValue( i : int ) : Object;
3-326
Valor de retorno Objeto (object) que representa el valor de la columna en su formato nativo. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetIfxValues: Obtiene todos los valores de las columnas correspondientes a la fila actual. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxValues( _ values As Object() _ ) As Integer [C#] public int GetIfxValues (Object [] valores) [C++] public: int GetIfxValues( Object* values __gc[] ); [JScript] public function GetIfxValues( values : Object[] ) : int
Parmetros values Matriz de Object en la que se copiarn los valores de las columnas correspondientes a la fila actual. Valor de retorno Nmero de instancias de Object de la matriz.
3-327
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetDataTypeName: Obtiene el nombre del tipo de datos fuente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetDataTypeName( _ ByVal i As Integer _ ) As String [C#] public string GetDataTypeName( int i ); [C++] public: String* GetDataTypeName( int i ); [JScript] public function GetDataTypeName( i : int ) : String;
Valor de retorno El nombre del tipo de datos fuente. Excepciones

Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos.
3-328
Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetDate: Obtiene el valor de la columna especificada como un objeto DateTime. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetDate( _ ByVal i As Integer _ ) As DateTime [C#] public DateTime GetDate( int i ); [C++] public: DateTime GetDate( int i ); [JScript] public function GetDate( i : int ) : DateTime;
Valor de retorno Objeto Date que representa el valor de columna. Excepciones

Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser IfxType.Date. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
3-329
Tipo de datos Ifx Date
Tipo de datos Informix DATETIME (date precision)
Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetDateTime: Obtiene el valor de la columna especificada como un objeto DateTime. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetDateTime( _ ByVal i As Integer _ ) As DateTime [C#] public DateTime GetDateTime( int i ); [C++] public: DateTime GetDateTime( int i ); [JScript] public function GetDateTime( i : int ) : DateTime;
Valor de retorno El valor de la columna especificada como un objeto DateTime. Excepciones

3-330
Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser IfxType.Date o IfxType.Timestamp. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx Date Tipo de datos Informix DATETIME (date precision)
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetDecimal: Obtiene el valor de la columna especificada como un objeto Decimal. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetDecimal( _ ByVal i As Integer _ ) As Decimal [C#] public decimal GetDecimal( int i ); [C++] public: Decimal GetDecimal( int i ); [JScript] public function GetDecimal( i : int ) : Decimal;

3-331
Valor de retorno El valor de la columna especificada como un objeto Decimal. Excepciones

Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser de tipo DB2Type.Decimal. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx Decimal Tipo de datos Informix MONEY
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos TbUse.cs TbUse.vb Mtodo IfxDataReader.GetDouble: Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin doble. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetDouble( _ ByVal i As Integer _
3-332
) As Double [C#] public double GetDouble( int i ); [C++] public: double GetDouble( int i ); [JScript] public function GetDouble( i : int ) : double;
Valor de retorno El valor de la columna especificada como un nmero de coma flotante de precisin doble. Excepciones
Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser de tipo DB2Type.Double. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx Double Tipo de datos Informix DECIMAL (31), DOUBLE PRECISION
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetEnumerator:
3-333
Devuelve un enumerador que ejecuta un proceso iterativo sobre IfxDataReader. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function GetEnumerator As System.Collections.IEnumerator [C#] public override System.Collections.IEnumerator GetEnumerator () [C++] public: virtual System.Collections.IEnumerator^ GetEnumerator () override [JScript] public override function GetEnumerator () : System.Collections.IEnumerator
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetFieldType: Obtiene el Type que es el tipo de datos del objeto. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetFieldType( _ ByVal i As Integer _ ) As Type [C#] public Type GetFieldType( int i ); [C++] public: Type* GetFieldType( int i ); [JScript] public function GetFieldType( i : int ) : Type;
3-334
Valor de retorno El Type que es el tipo de datos del objeto. Excepciones

Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetFloat: Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin simple. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetFloat( _ ByVal i As Integer _ ) As Single [C#] public float GetFloat( int i ); [C++] public: float GetFloat( int i ); [JScript] public function GetFloat( i : int ) : float;
3-335
Valor de retorno El valor de la columna especificada como un nmero de coma flotante de precisin simple. Excepciones
Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser IfxType.Real. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx Real Tipo de datos Informix REAL, SMALLFLOAT
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetGuid: Obtiene el valor de la columna especificada como identificador global exclusivo (GUID). Este mtodo no est soportado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetGuid( _ ByVal i As Integer _ ) As Guid [C#] public Guid GetGuid( int i
3-336
); [C++] public: Guid GetGuid( int i ); [JScript] public function GetGuid( i : int ) : Guid;
Valor de retorno El valor de la columna especificada como un GUID. Excepciones

Comentarios Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetInt16: Obtiene el valor de la columna especificada como un entero con signo de 16 bits. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetInt16( _ ByVal i As Integer _ ) As Short [C#] public short GetInt16(
3-337
int i ); [C++] public: short GetInt16( int i ); [JScript] public function GetInt16( i : int ) : Int16;
Valor de retorno El valor de la columna especificada como un entero con signo de 16 bits. Excepciones
Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser DB2Type.SmallInt. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx SmallInt Tipo de datos Informix BOOLEAN, SMALLINT
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos TbUse.cs TbUse.vb Mtodo IfxDataReader.GetInt32:
3-338
Obtiene el valor de la columna especificada como un entero con signo de 32 bits. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetInt32( _ ByVal i As Integer _ ) As Integer [C#] public int GetInt32( int i ); [C++] public: int GetInt32( int i ); [JScript] public function GetInt32( i : int ) : int;
Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser de tipo DB2Type.Integer. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx Integer Tipo de datos Informix INT, INTEGER, SERIAL
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos.
3-339
Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetInt64: Obtiene el valor de la columna especificada como un entero con signo de 64 bits. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetInt64( _ ByVal i As Integer _ ) As Long [C#] public long GetInt64( int i ); [C++] public: __int64 GetInt64( int i ); [JScript] public function GetInt64( i : int ) : long;
Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser de tipo DB2Type.BigInt. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
3-340
Tipo de datos Ifx BigInt
Tipo de datos Informix INT8, SERIAL8
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetName: Obtiene el nombre de la columna especificada. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetName( _ ByVal i As Integer _ ) As String [C#] public string GetName( int i ); [C++] public: String* GetName( int i ); [JScript] public function GetName( i : int ) : String;
Valor de retorno Una serie que es el nombre de la columna especificada. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos.
3-341
Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetOrdinal Obtiene el ordinal de columna, dado el nombre de la columna. Mtodo IfxDataReader.GetOrdinal: Obtiene el ordinal de columna, dado el nombre de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetOrdinal( _ ByVal value As String _ ) As Integer [C#] public int GetOrdinal( string value ); [C++] public: int GetOrdinal( String* value ); [JScript] public function GetOrdinal( value : String ) : int;
Parmetros value El nombre de la columna.
Valor de retorno El ordinal de columna basado en cero. Comentarios GetOrdinal realiza en primer lugar una bsqueda sensible a maysculas y minsculas. Si falla, se realiza una segunda bsqueda no sensible a maysculas y minsculas. GetOrdinal no es sensible al ancho kana. Puesto que las bsquedas basadas en ordinal son ms eficaces que las bsquedas con nombre, no es eficaz llamar a GetOrdinal dentro de un bucle. En su lugar, llame a GetOrdinal una vez y, a continuacin, asigne los resultados a una variable de entero para utilizarla dentro del bucle. Consulta
3-342
Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetName en la pgina 3-341 Obtiene el nombre de la columna especificada. Mtodo IfxDataReader.GetSchemaTable: Devuelve DataTable que describe los metadatos de columna de IfxDataReader. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetSchemaTable() As DataTable [C#] public DataTable GetSchemaTable(); [C++] public: DataTable* GetSchemaTable(); [JScript] public function GetSchemaTable() : DataTable;
Valor de retorno Una DataTable que describe los metadatos de columna. Excepciones
Tipo de excepcin InvalidOperationException Condicin IfxDataReader est cerrado.
Comentarios El mtodo GetSchemaTable devuelve metadatos sobre cada columna en el orden siguiente:
DataReader ColumnName Descripcin El nombre de la columna; podra no ser exclusivo. Si no se puede determinar el nombre de la columna, se devuelve un valor nulo. Este nombre siempre refleja la nomenclatura ms reciente de la columna en la vista o texto de mandato actual.
3-343
DataReader ColumnOrdinal
Descripcin El ordinal de la columna. Es cero para la columna de marcadores de la fila, si es que la hay. Otras columnas se numeran empezando por 1. Esta columna no puede contener un valor nulo. La longitud mxima posible de un valor en la columna. Para columnas que utilizan un tipo de datos de longitud fija, es el tamao del tipo de datos. Si DbType es un tipo de datos numrico, es la mxima precisin de la columna. La precisin depende de la definicin de la columna. Si DbType no es un tipo de datos numrico, es un valor nulo. Si DbType es Decimal, el nmero de dgitos a la derecha de la coma decimal. De lo contrario, es un valor nulo. Se correlaciona con el tipo en tiempo de ejecucin de lenguaje comn de DbType. Enumeracin de IfxType. true si la columna contiene un BLOB (Binary Large ObjectB) que contiene datos muy grandes. true si el consumidor puede establecer la columna en un valor nulo o si el controlador no puede determinar si el consumidor puede establecer la columna en un valor nulo. De lo contrario, false. Una columna puede contener valores nulos, incluso si no se puede establecer en un valor nulo. true si la columna se puede modificar; de lo contrario false. Establecido si la columna contiene un identificador de filas persistente en el que no se puede grabar, y no tiene valor con significado excepto para identificar la fila. true: Dos filas de la tabla base (la tabla devuelta en BaseTableName) no pueden tener el mismo valor en esta columna. Se garantiza que IsUnique ser true si la columna constituye una clave en si misma o si hay una restriccin de tipo UNIQUE que slo se aplica a esta columna. false: La columna puede contener valores duplicados en la tabla base. El valor por omisin para esta columna es false.
ColumnSize
NumericPrecision
NumericScale
DataType ProviderType IsLong
AllowDBNull
IsReadOnly IsRowVersion
IsUnique
3-344
DataReader IsKey
Descripcin true: Se trata de una columna del conjunto de columnas del conjunto de filas que, combinadas, identifican exclusivamente la fila. El conjunto de columnas con IsKey establecido en true debe identificar exclusivamente una fila del conjunto de filas. No hay ningn requisito para que este conjunto de columnas sea un conjunto mnimo de columnas. Este conjunto de columnas puede ser generado desde una clave primaria de tabla base, una restriccin exclusiva o un ndice exclusivo. false: La columna no es necesaria para identificar de forma exclusiva la fila. true si la columna asigna valores a las nuevas filas en incrementos fijos; de lo contrario false. El valor por omisin para esta columna es false. El nombre del esquema en la base de datos que contiene la columna. NULL si el nombre de esquema base no se puede determinar. El valor por omisin para esta columna es un valor nulo. El nombre del catlogo en la base de datos que contiene la columna. NULL si el nombre de catlogo base no se puede determinar. El valor por omisin para esta columna es un valor nulo. El nombre de la tabla o vista en la base de datos que contiene la columna. Un valor nulo si el nombre de la tabla base no se puede determinar. El valor por omisin de esta columna es un valor nulo. El nombre de la columna en la base de datos. Podra ser diferente del nombre de columna devuelto en la columna ColumnName si se ha utilizado un alias. Un valor nulo si el nombre de columna base no se puede determinar o si la columna de conjunto de filas deriva, pero no es idntica, a una columna en la base de datos. El valor por omisin para esta columna es un valor nulo.
IsAutoIncrement
BaseSchemaName
BaseCatalogName
BaseTableName
BaseColumnName
Se devolver una fila para cada columna en el conjunto de resultados. IfxCommandBuilder necesita la identificacin correcta de las claves primarias de la tabla para poder funcionar correctamente. Si no se devuelve BaseTableName para cada columna en los resultados de la consulte, IBM Data Server Provider for .NET intentar analizar la sentencia de SQL para encontrar los nombres de tabla implicados en la consulta. Esto funciona con sentencias UPDATE, INSERT, DELETE y con sentencias SELECT simples, pero no con procedimientos almacenados ni con sentencias SELECT basadas en uniones. En los casos en los que falta parte o toda la informacin de esquema en esta tabla, IfxCommandBuilder no funcionar correctamente, ya que no tiene suficiente
3-345
informacin para generar automticamente las sentencias INSERT, UPDATE o DELETE correctas. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbDatAdp.cs DbDatAdp.vb Mtodo IfxDataReader.GetStream: Obtiene el valor de la columna XML especificada, en forma de objeto System.IO.Stream. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetStream( _ ByVal i As Integer _ ) As Stream [C#] public Stream GetStream( int i ); [C++] public: Stream* GetStream( int i ); [JScript] public function GetStream( i : int ) : Stream;
Valor de retorno El valor en forma de objeto Stream de la columna XML especificada. Excepciones
Tipo de excepcin InvalidCastException Condicin La difusin especificada no es vlida.
3-346
Tipo de excepcin IfxException
Condicin Conversin no vlida.
Comentarios No se realizan conversiones. Los datos a recuperar deben ser del tipo IfxType.Xml. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos. Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetString: Obtiene el valor de la columna especificada como una serie de caracteres. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetString( _ ByVal i As Integer _ ) As String [C#] public string GetString( int i ); [C++] public: String* GetString( int i ); [JScript] public function GetString( i : int ) : String;
3-347
Valor de retorno El valor de la columna especificada como una serie. Excepciones

Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser uno de los siguientes tipos: v IfxType.Xml v IfxType.Char v IfxType.VarChar v IfxType.LongVarChar v IfxType.Clob v IfxType.Graphic v IfxType.VarGraphic v IfxType.LongVarGraphic v IfxType.DbClob La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-348
Ejemplos TbUse.cs TbUse.vb Mtodo IfxDataReader.GetTime: Obtiene el valor de la columna especificada como un objeto Time. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetTime( _ ByVal i As Integer _ ) As TimeSpan [C#] public TimeSpan GetTime( int i ); [C++] public: TimeSpan GetTime( int i ); [JScript] public function GetTime( i : int ) : TimeSpan;
Excepciones
Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser de tipo DB2Type.Time. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Tipo de datos Ifx Time Tipo de datos Informix DATETIME (time precision)
Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader
3-349
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetTimeSpan: Obtiene el valor de la columna especificada en forma de objeto TimeSpan. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetTimeSpan( _ ByVal i As Integer _ ) As TimeSpan [C#] public TimeSpan GetTimeSpan( int i ); [C++] public: TimeSpan GetTimeSpan( int i ); [JScript] public function GetTimeSpan( i : int ) : TimeSpan;
Excepciones
Tipos de datos IfxType Time Tipo de datos Informix DATETIME (time precision)
Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos.
3-350
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetValue: Obtiene el valor de la columna en el ordinal especificado en su formato nativo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetValue( _ ByVal i As Integer _ ) As Object [C#] public object GetValue( int i ); [C++] public: Object* GetValue( int i ); [JScript] public function GetValue( i : int ) : Object;
Valor de retorno El valor de la columna en su formato nativo. Comentarios Este mtodo devuelve DBNull para columnas de base de datos nula. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.GetValues:
3-351
Obtiene todas las columnas de atributos en la fila actual. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetValues( _ ByVal values() As Object _ ) As Integer [C#] public int GetValues( object[] values ); [C++] public: int GetValues( Object* values __gc[] ); [JScript] public function GetValues( values : Object[] ) : int;
Parmetros values Una matriz de tipo Object en la que se deben copiar las columnas de atributos. Valor de retorno El nmero de instancias de Object en la matriz. Comentarios Para la mayora de aplicaciones, el mtodo GetValues proporciona un medio eficaz de recuperar todas las columnas, en lugar de recuperar cada columna individualmente. Puede pasar una matriz Object que contenga menos columnas que el nmero de columnas contenidas en la fila resultante. Slo se copia en la matriz la cantidad de datos que contiene la matriz Object. Tambin se puede pasar una matriz Object cuya longitud sea superior al nmero de columnas contenidas en la fila resultante. Este mtodo devuelve DBNull para columnas de base de datos nula. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-352
Mtodo IfxDataReader.IsDBNull: Obtiene un valor que indica si la columna contiene valores no existentes o si faltan. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function IsDBNull( _ ByVal i As Integer _ ) As Boolean [C#] public bool IsDBNull( int i ); [C++] public: bool IsDBNull( int i ); [JScript] public function IsDBNull( i : int ) : Boolean;
Valor de retorno true si el valor de columna especificado es equivalente a DBNull; de lo contrario, false. Comentarios Para evitar que se emita un error, invoque este mtodo para comprobar si hay valores de columna nulos antes de llamar a los mtodos Get tipificados Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos TbUse.cs TbUse.vb Mtodo IfxDataReader.NextResult:
3-353
Avanza IfxDataReader hasta el siguiente resultado cuando se leen los resultados de las sentencias de SQL de proceso por lotes o un procedimiento almacenado de mltiples conjuntos de resultados. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function NextResult() As Boolean [C#] public bool NextResult(); [C++] public: bool NextResult(); [JScript] public function NextResult() : Boolean;
Valor de retorno true si hay ms conjuntos de resultados; de lo contrario, false. Comentarios Utilizado para procesar mltiples resultados, que se pueden generar ejecutando sentencias de SQL de proceso por lotes o un procedimiento almacenados de mltiples conjuntos de resultados. Por omisin, IfxDataReader se sita en el primer resultado. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataReader.Read: Avanza el IfxDataReader al siguiente registro. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function Read() As Boolean [C#] public bool Read();
3-354
[C++] public: bool Read(); [JScript] public function Read() : Boolean;
Valor de retorno true si hay ms filas; de lo contrario, false. Comentarios La posicin por omisin de IfxDataReader es anterior al primer registro. Por lo tanto, debe invocar Read antes que cualquier dato. Puede leer simultneamente datos de mltiples instancias de IfxDataReader que utilizan la misma instancia de IfxConnection. Cada instancia de IfxDataReader debe estar asociada con su propia instancia de IfxCommand. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection, un IfxCommand y un IfxDataReader. El ejemplo lee los datos y los escribe en la consola. Finalmente, el ejemplo cierra el IfxDataReader y luego la IfxConnection.
Visual Basic] Public Sub ReadMyData(myConnString As String) Dim mySelectQuery As String = "SELECT ID, NAME FROM STAFF" Dim myConnection As New IfxConnection(myConnString) Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myConnection.Open() Dim myReader As IfxDataReader myReader = myCommand.ExecuteReader() Always call Read before accessing data. While myReader.Read() Console.WriteLine(myReader.GetInt16(0).ToString() + ", " _ + myReader.GetString(1)) End While always call Close when done reading. myReader.Close() Close the connection when done with it. myConnection.Close() End Sub [C#] public void ReadMyData(string myConnString) { string mySelectQuery = "SELECT ID, NAME FROM STAFF"; IfxConnection myConnection = new IfxConnection(myConnString); IfxCommand myCommand = new IfxCommand(mySelectQuery,myConnection); myConnection.Open(); IfxDataReader myReader; myReader = myCommand.ExecuteReader(); // Always call Read before accessing data. while (myReader.Read()) { Console.WriteLine(myReader.GetInt16(0) + ", " + myReader.GetString(1)); } // always call Close when done reading. myReader.Close(); // Close the connection when done with it. myConnection.Close(); }
Consulta
3-355
Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos TbUse.cs TbUse.vb
Propiedades de IfxDataReader
Las propiedades de la clase IfxDataReader se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxDataReader, consulte el tema Miembros de IfxDataReader.
Propiedades pblicas
Depth FieldCount HasRows IsClosed This Sobrecargado. Obtiene el valor de una columna en su formato nativo. En C#, esta propiedad es el indexador para la clase IfxDataReader. RecordsAffected Obtiene el nmero de filas cambiadas, insertadas o suprimidas por la ejecucin de la sentencia de SQL. Obtiene un valor que indica la profundidad de anidacin para la fila actual. Obtiene el nmero de columnas de la fila actual. Obtiene un valor que indica si IfxDataReader contiene una o ms filas. Indica si IfxDataReader est cerrado.
Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataReader.CacheData: Indica si los datos almacenados en la posicin de cursor actual de la instancia de IfxDataReader se van a almacenar en la antememoria.
3-356
Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis

Visual Basic] Public Property CacheData As Boolean [C#] public bool CacheData {get; set;} [C++] public: __property bool get_CacheData(); public: __property void set_CacheData(bool); [JScript] public function get CacheData() : Boolean; public function set CacheData(Boolean);
Valor de la propiedad true si la instancia del objet IfxDataReader debe ponerse en la antememoria; de no ser as, false. El valor por omisin es false. Comentarios Si la propiedad CacheData se establece en true, los datos de la instancia de IfxDataReader se pueden recuperar cualquier nmero de veces utilizando cualquiera de las interfaces de acceso (por ejemplo, GetDB2String o GetInt16). Esta propiedad debe establecerse antes de la primera recuperacin de datos de este objeto o los datos no se pondrn en antememoria. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxDataReader.Depth: Obtiene un valor que indica la profundidad de anidacin para la fila actual. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Depth As Integer [C#] public int Depth {get;}
3-357
[C++] public: __property int get_Depth(); [JScript] public function get Depth() : int;
Valor de la propiedad La profundidad de anidacin para la fila actual. Comentarios La tabla ms exterior tiene una profundidad de cero. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataReader.FieldCount: Obtiene el nmero de columnas de la fila actual. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property FieldCount As Integer [C#] public int FieldCount {get;} [C++] public: __property int get_FieldCount(); [JScript] public function get FieldCount() : int;
Valor de la propiedad Cuando no est posicionado en un conjunto de registros vlido, 0; de lo contrario, el nmero de columnas en el registro actual. El valor por omisin es -1. Excepciones
Tipo de excepcin NotSupportedException Condicin No hay una conexin actual con una base de datos.
3-358
Comentarios Despus de ejecutar una consulta que no devuelve filas, FieldCount devuelve 0. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataReader.HasRows: Obtiene un valor que indica si IfxDataReader contiene una o ms filas. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property HasRows As Boolean [C#] public bool HasRows {get;} [C++] public: __property bool get_HasRows(); [JScript] public function get HasRows() : Boolean;
Valor de la propiedad true si IfxDataReader contiene una o ms filas; de lo contrario, false. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataReader.IsClosed: Indica si IfxDataReader est cerrado.
3-359

Visual Basic] Public ReadOnly Property IsClosed As Boolean [C#] public bool IsClosed {get;} [C++] public: __property bool get_IsClosed(); [JScript] public function get IsClosed() : Boolean;
Valor de la propiedad true si IfxDataReader est cerrado; de lo contrairo, false. Comentarios IsClosed y RecordsAffected son las nicas propiedades que puede invocar despus de cerrar IfxDataReader. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataReader.RecordsAffected: Obtiene el nmero de filas cambiadas, insertadas o suprimidas por la ejecucin de la sentencia de SQL. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property RecordsAffected As Integer [C#] public int RecordsAffected {get;} [C++] public: __property int get_RecordsAffected(); [JScript] public function get RecordsAffected() : int;
3-360
Valor de la propiedad El nmero de filas cambiadas, insertadas o suprimidas. -1 para sentencias SELECT; 0 si no hay filas afectadas o si la sentencia ha fallado. Comentarios La propiedad RecordsAffected no se establece hasta que se han ledo todas lasfilas y se cierra IfxDataReader. El valor de esta propiedad es acumulativo. Por ejemplo, si se insertan dos registros en modalidad de proceso por lotes, el valor de RecordsAffected ser 2. IsClosed y RecordsAffected son las nicas propiedades que puede invocar despus de cerrar IfxDataReader. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataReader.this: Obtiene el valor de una columna en su formato nativo. Lista de sobrecargas
Nombre this(Integer) As Object Descripcin Obtiene el valor de la columna especificada en su formato nativo dado el ordinal de columna. Obtiene el valor de la columna especificada en su formato nativo dado el nombre de columna.
this(String) As Object
Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataReader.this (Int32):
3-361
Obtiene el valor de la columna especificada en su formato nativo dado el ordinal de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Default ReadOnly Property this( _ ByVal i As Integer _ ) As Object [C#] public object this[ int i ] {get;} [C++] public: __property Object* get_this( int i ); [JScript] returnValue = IfxDataReaderObject.this(i); -o bienreturnValue = IfxDataReaderObject(i);
Valor de la propiedad El valor de la columna especificada en su formato nativo. Excepciones

Tipo de excepcin IndexOutOfRangeException Condicin El ndice que se ha pasado estaba fuera del rango de 0 a FieldCount.
Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataReader.this en la pgina 3-361 Obtiene el valor de una columna en su formato nativo. Propiedad IfxDataReader.this (String): Obtiene el valor de la columna especificada en su formato nativo dado el nombre de columna. Espacio de nombres: IBM.Data.Informix
3-362

Visual Basic] Public Default ReadOnly Property this( _ ByVal value As String _ ) As Object [C#] public object this[ string value ] {get;} [C++] public: __property Object* get_this( String* value ); [JScript] returnValue = IfxDataReaderObject.this(value); -o bienreturnValue = IfxDataReaderObject(value);
Valor de la propiedad El valor de la columna especificada en su formato nativo. Excepciones

Tipo de excepcin IndexOutOfRangeException Condicin No se ha encontrado ninguna columna con el nombre especificado.
Comentarios En primer lugar se realiza una bsqueda sensible a maysculas y minsculas. Si falla, se realiza una segunda bsqueda no sensible a maysculas y minsculas. Este mtodo no es sensible al ancho kana. Consulta Clase IfxDataReader en la pgina 3-291 Proporciona una manera de leer filas de corrientes de datos de slo avance de una base de datos. Miembros de IfxDataReader en la pgina 3-293 Visin general de IfxDataReader Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxDataReader.this en la pgina 3-361 Obtiene el valor de una columna en su formato nativo.
Clase IfxDataSourceEnumerator
Utilice esta clase para descubrir las fuentes de datos visibles de la familia DB2. Espacio de nombres: IBM.Data.Informix
3-363
Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)

System.Object IBM.Data.Informix.IfxDataSourceEnumerator

System.Object System.Data.Common.DbDataSourceEnumerator IBM.Data.Informix.IfxDataSourceEnumerator

Visual Basic] Public NotInheritable Class IfxDataSourceEnumerator [C#] public sealed class IfxDataSourceEnumerator [C++] public ref class IfxDataSourceEnumerator sealed [JScript] public final class IfxDataSourceEnumerator

Visual Basic] Public NotInheritable Class IfxDataSourceEnumerator Inherits DbDataSourceEnumerator [C#] public sealed class IfxDataSourceEnumerator : DbDataSourceEnumerator [C++] public ref class IfxDataSourceEnumerator sealed : public DbDataSourceEnumerator [JScript] public final class IfxDataSourceEnumerator ampla DbDataSourceEnumerator
Ejemplo
[C#] El ejemplo siguiente demuestra cmo crear una instancia de IfxDataSourceEnumerator (con el campo Instance) y obtener una lista de todas las fuentes de datos visibles de la familia DB2 (con el mtodo GetDataSources).
[C#] IfxDataSourceEnumerator dsenum = IfxDataSourceEnumerator.Instance; DataTable table = dsenum.GetDataSources();
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxDataSourceEnumerator en la pgina 3-365 Los miembros de la clase IfxDataSourceEnumerator se listan a continuacin.
3-364
Miembros de IfxDataSourceEnumerator
Los miembros de la clase IfxDataSourceEnumerator se listan a continuacin.
Mtodos pblicos
Nombre GetDataSources Descripcin Sobrecargado. Devuelve una DataTable con informacin sobre todas las instancias visibles de servidores de bases de datos de la familia DB2 y las bases de datos de estas instancias.
Campos pblicos
Nombre Instancia Descripcin Obtiene una instancia de IfxDataSourceEnumerator.
Consulta Clase IfxDataSourceEnumerator en la pgina 3-363 Utilice esta clase para descubrir las fuentes de datos visibles de la familia DB2. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Campos de IfxDataSourceEnumerator
Los campos de la clase IfxDataSourceEnumerator se listan a continuacin.
Campos pblicos
Nombre Instancia Descripcin Obtiene una instancia de IfxDataSourceEnumerator.
Consulta Clase IfxDataSourceEnumerator en la pgina 3-363 Utilice esta clase para descubrir las fuentes de datos visibles de la familia DB2. Miembros de IfxDataSourceEnumerator Los miembros de la clase IfxDataSourceEnumerator se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Campo IfxDataSourceEnumerator.Instance:
3-365
Obtiene una instancia de IfxDataSourceEnumerator. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Instance As IfxDataSourceEnumerator [C#] public static readonly IfxDataSourceEnumerator Instance [C++] public: static initonly IfxDataSourceEnumerator^ Instance [JScript] public static final var Instance () : IfxDataSourceEnumerator
Ejemplo [C#] El ejemplo siguiente demuestra cmo crear una instancia de IfxDataSourceEnumerator (con el campo Instance) y obtener una lista de todas las fuentes de datos visibles de la familia DB2 (con el mtodo GetDataSources).
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 Consulta Clase IfxDataSourceEnumerator en la pgina 3-363 Utilice esta clase para descubrir las fuentes de datos visibles de la familia DB2. Miembros de IfxDataSourceEnumerator en la pgina 3-365 Los miembros de la clase IfxDataSourceEnumerator se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxDataSourceEnumerator
Mtodos pblicos
Nombre GetDataSources Descripcin Sobrecargado. Devuelve una DataTable con informacin sobre todas las instancias visibles de servidores de bases de datos de la familia DB2 y las bases de datos de estas instancias.
Consulta Clase IfxDataSourceEnumerator en la pgina 3-363 Utilice esta clase para descubrir las fuentes de datos visibles de la familia DB2.
3-366
Miembros de IfxDataSourceEnumerator en la pgina 3-365 Los miembros de la clase IfxDataSourceEnumerator se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataSourceEnumerator.GetDataSources: Devuelve una DataTable con informacin sobre todas las instancias visibles de servidores de bases de datos de la familia DB2 y las bases de datos de estas instancias. Lista de sobrecargas
Nombre GetDataSources() Descripcin Alterado temporalmente. Devuelve una DataTable con informacin sobre todas las instancias visibles de servidores de bases de datos de la familia DB2 y las bases de datos de estas instancias. Devuelve una DataTable con informacin sobre todas las instancias visibles de servidores de bases de datos de la familia DB2 y las bases de datos de estas instancias. Un parmetro booleano habilita la restriccin de los resultados a las bases de datos de la familia de DB2 catalogadas localmente y a la instancia local.
GetDataSources(Boolean)
Comentarios Utilizando el mtodo GetDataSources podr hallar todas las instancias visibles de servidores de bases de datos de la familia de DB2 y las bases de datos de estas instancias. El mtodo GetDataSources funciona con IBM Data Server Provider for .NET y puede ver la informacin siguiente: v todas las bases de datos catalogadas en la instancia local. En caso de que existan varias instancias locales en ejecucin, slo se ver la instancia a la que la aplicacin est conectada. v todas las instancias visibles de servidores de bases de datos remotos y las bases de datos de las mismas. Para poder verse, las instancias de servidores de bases de datos remotos deben tener un servidor de administracin de bases de datos (DAS) en ejecucin, que est configurado para responder a las solicitudes de descubrimiento conocido y bsqueda. v Las instancias de servidores de bases de datos que no tengan ninguna base de datos no aparecern en la DataTable. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 Consulta
3-367
Clase IfxDataSourceEnumerator en la pgina 3-363 Utilice esta clase para descubrir las fuentes de datos visibles de la familia DB2. Miembros de IfxDataSourceEnumerator en la pgina 3-365 Los miembros de la clase IfxDataSourceEnumerator se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataSourceEnumerator.GetDataSources (): Devuelve una DataTable con informacin sobre todas las instancias visibles de servidores de bases de datos de la familia DB2 y las bases de datos de estas instancias. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function GetDataSources As DataTable [C#] public override DataTable GetDataSources () [C++] public: virtual DataTable^ GetDataSources () override [JScript] public override function GetDataSources () : DataTable
Valor de retorno Instancia de DataTable que contiene informacin sobre las instancias visibles de servidores de bases de datos de la familia DB2 y las bases de datos de estas instancias. DataTable contiene las columnas siguientes:
Tabla 3-1. Columnas de la tabla de enumeracin de la fuente de datos Nombre de la columna DatabaseAlias DatabaseName ServerName Descripcin El alias por el que se conoce la base de datos. El nombre de la base de datos. El nombre del servidor. Esta columna contendr un valor nulo si la base de datos correspondientes existe en una instancia de DB2 local. El nombre del servicio a travs del cual el servidor de bases de datos acepta conexiones. Esta columna contendr un valor nulo si la base de datos correspondientes existe en una instancia de DB2 local. El nombre de la instancia del servidor de bases de datos. La ubicacin de la base de datos (LOCAL o REMOTE).
ServiceName
InstanceName DatabaseLocation
3-368
Comentarios Utilizando el mtodo GetDataSources podr hallar todas las instancias visibles de servidores de bases de datos de la familia de DB2 y las bases de datos de estas instancias. El mtodo GetDataSources funciona con IBM Data Server Provider for .NET y puede ver la informacin siguiente: v todas las bases de datos catalogadas en la instancia local. En caso de que existan varias instancias de DB2 locales en ejecucin, no se ha definido el comportamiento de GetDataSources. v todas las instancias visibles de servidores de bases de datos remotos y las bases de datos de las mismas. Para poder verse, las instancias de servidores de bases de datos remotos deben tener un servidor de administracin de bases de datos (DAS) en ejecucin, que est configurado para responder a las solicitudes de descubrimiento conocido y bsqueda. Las instancias de servidores de bases de datos sin ninguna base de datos sern visibles para el mtodo GetDataSources. Ejemplo [C#] El ejemplo siguiente demuestra cmo crear una instancia de IfxDataSourceEnumerator (con el campo Instance) y obtener una lista de todas las fuentes de datos visibles de la familia DB2 (con el mtodo GetDataSources).
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 Consulta Clase IfxDataSourceEnumerator en la pgina 3-363 Utilice esta clase para descubrir las fuentes de datos visibles de la familia DB2. Miembros de IfxDataSourceEnumerator en la pgina 3-365 Los miembros de la clase IfxDataSourceEnumerator se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxDataSourceEnumerator.GetDataSources (Boolean): Devuelve una DataTable con informacin sobre todas las instancias visibles de servidores de bases de datos de la familia DB2 y las bases de datos de estas instancias. Un parmetro booleano habilita la restriccin de los resultados a las bases de datos de la familia de DB2 catalogadas localmente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-369
Sintaxis
Visual Basic] Public Overrides Function GetDataSources ( _ bLocalDBsOnly As Boolean _ ) As DataTable [C#] public override DataTable GetDataSources ( bool bLocalDBsOnly ); [C++] public: virtual DataTable^ GetDataSources ( bool bLocalDBsOnly ) override [JScript] public override function GetDataSources ( bLocalDBsOnly : Boolean ) : DataTable
Parmetros bLocalDBsOnly true para recuperar informacin acerca de la instancia local visible de la familia DB2 y las bases de datos de la misma; false para recuperar informacin sobre todas las instancias de servidores de bases de datos visibles de la familia DB2 y las bases de datos de estas instancias. Valor de retorno Instancia de DataTable que contiene informacin sobre las instancias visibles de servidores de bases de datos de la familia DB2 y las bases de datos de estas instancias. DataTable contiene las columnas siguientes:
Tabla 3-2. Columnas de la tabla de enumeracin de la fuente de datos Nombre de la columna DatabaseAlias DatabaseName ServerName Descripcin El alias por el que se conoce la base de datos. El nombre de la base de datos. El nombre del servidor. Esta columna contendr un valor nulo si la base de datos correspondientes existe en una instancia de DB2 local. El nombre del servicio a travs del cual el servidor de bases de datos acepta conexiones. Esta columna contendr un valor nulo si la base de datos correspondientes existe en una instancia de DB2 local. El nombre de la instancia del servidor de bases de datos. La ubicacin de la base de datos (LOCAL o REMOTE).
ServiceName
InstanceName DatabaseLocation
Comentarios Utilizando el mtodo GetDataSources podr hallar todas las instancias visibles de servidores de bases de datos de la familia de DB2 y las bases de datos de estas instancias. El mtodo GetDataSources funciona con IBM Data Server Provider for .NET y puede ver la informacin siguiente:
3-370
v todas las bases de datos catalogadas en la instancia local. En caso de que existan varias instancias de DB2 locales en ejecucin, no se ha definido el comportamiento de GetDataSources. v todas las instancias visibles de servidores de bases de datos remotos y las bases de datos de las mismas. Para poder verse, las instancias de servidores de bases de datos remotos deben tener un servidor de administracin de bases de datos (DAS) en ejecucin, que est configurado para responder a las solicitudes de descubrimiento conocido y bsqueda. Las instancias de servidores de bases de datos sin ninguna base de datos sern visibles para el mtodo GetDataSources. Ejemplo [C#] El ejemplo siguiente demuestra cmo crear una instancia de IfxDataSourceEnumerator (con el campo Instance) y obtener una lista de todas las fuentes de datos visibles locales de la familia DB2 (con el mtodo GetDataSources).
[C#] IfxDataSourceEnumerator dsenum = IfxDataSourceEnumerator.Instance; DataTable table = dsenum.GetDataSources(true);
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 Consulta Clase IfxDataSourceEnumerator en la pgina 3-363 Utilice esta clase para descubrir las fuentes de datos visibles de la familia DB2. Miembros de IfxDataSourceEnumerator en la pgina 3-365 Los miembros de la clase IfxDataSourceEnumerator se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxError
Recopila informacin relevante para un aviso o error devuelto por la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object IBM.Data.Informix.IfxError
Sintaxis
Visual Basic] <Serializable> NotInheritable Public Class IfxError [C#] [Serializable] public sealed class IfxError
3-371
[C++] [Serializable] public __gc __sealed class IfxError [JScript] public Serializable class IfxError
Comentarios
Se crea una instancia de esta clase siempre que se produce un error en una operacin de base de datos en la aplicacin. Cada instancia de IfxError creada por IfxDataAdapter es gestionada por la clase IfxErrorCollection, que a su vez es creada por la clase IfxException. Si la gravedad del error es demasiado alta, puede que el servidor cierre IfxConnection. Si el servidor cierra la conexin, ser necesario que la aplicacin abra una nueva conexin.
Ejemplo
[Visual Basic, C#] El ejemplo siguiente muestra las propiedades del IfxError.
[Visual Basic] Public Sub DisplayIfxErrorCollection(myException As IfxException) Dim i As Integer For i = 0 To myException.Errors.Count - 1 MessageBox.Show("Index #" + i.ToString() + ControlChars.Cr _ + "Message: " + myException.Errors(i).Message + ControlChars.Cr _ + "Native: " + myException.Errors(i).NativeError.ToString() + ControlChars.Cr _ + "Source: " + myException.Errors(i).Source + ControlChars.Cr _ + "SQL: " + myException.Errors(i).SQLState + ControlChars.Cr) Next i End Sub [C#] public void DisplayIfxErrorCollection(IfxException myException) { for (int i=0; i < myException.Errors.Count; i++) { MessageBox.Show("Index #" + i + "\n" + "Message: " + myException.Errors[i].Message + "\n" + "Native: " + myException.Errors[i].NativeError.ToString() + "\n" + "Source: " + myException.Errors[i].Source + "\n" + "SQL: " + myException.Errors[i].SQLState + "\n"); } }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxError en la pgina 3-373 Visin general de IfxError
3-372
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Clase IfxErrorCollection en la pgina 3-384 Recopila todos los errores generados. Clase IfxException en la pgina 3-392 La excepcin que se genera cuando una base de datos devuelve un aviso o un error.
Miembros de IfxError
Visin general de IfxError
Propiedades pblicas
Obtiene una breve descripcin del error. Message Obtiene la informacin de error. NativeError RowNumber Obtiene un valor entero que indica el nmero del mandato dentro de la serie de mandatos encadenados que ha causado el error. Esta propiedad es vlida siempre que se ejecutan varias sentencias de SQL como parte de una nica operacin. Por ejemplo, esta propiedad es vlida cuando el encadenado est activo, durante una operacin de copia masiva y en operaciones Update realizadas por IfxDataAdapter. Obtiene el nombre del controlador que ha generado el error. El valor es actualmente IBM.Data.DB2. Obtiene el cdigo de error de cinco caracteres que sigue al estndar de SQL ANSI para la base de datos.
Source
SQLState
Mtodos pblicos
Equals (heredado de Object) GetHashCode (heredado de Object) Sobrecargado. Determina si dos instancias de Object son iguales. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el Type de la instancia actual. GetType (heredado de Object) ToString Alterado temporalmente. Obtiene el texto completo del mensaje de error.
3-373
Mtodos protegidos
Finalize (heredado de Object) Alterado temporalmente. Permite que un Object intente liberar recursos y realizar otras operaciones de limpieza antes de que el Object sea reclamado para la recopilacin de basura. En C# y Microsoft(R) Visual C++(R), los finalizadores se expresan utilizando sintaxis de destructor. Crea una copia superficial del Object actual. MemberwiseClone (heredado de Object)
Consulta Clase IfxError en la pgina 3-371 Recopila informacin relevante para un aviso o error devuelto por la base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxError
Los mtodos de la clase IfxError se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxError, consulte el tema Miembros de IfxError.
Mtodos pblicos
Equals (heredado de Object) GetHashCode (heredado de Object) Sobrecargado. Determina si dos instancias de Object son iguales. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el Type de la instancia actual. GetType (heredado de Object) ToString Alterado temporalmente. Obtiene el texto completo del mensaje de error.
3-374
Mtodos protegidos
Consulta Clase IfxError en la pgina 3-371 Recopila informacin relevante para un aviso o error devuelto por la base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxError.ToString: Obtiene el texto completo del mensaje de error. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <Serializable> Overrides Public Function ToString() As String [C#] [Serializable] public override string ToString(); [C++] [Serializable] public: String* ToString(); [JScript] public Serializable override function ToString() : String;
Valor de retorno El texto completo del error.
3-375
Ejemplo [Visual Basic, C#] El ejemplo siguiente muestra cada IfxError contenido en la coleccin IfxErrorCollection.
Visual Basic] Public Sub DisplayIfxErrors(myException As IfxException) Dim i As Integer For i = 0 To myException.Errors.Count - 1 MessageBox.Show("Index #" + i.ToString() + ControlChars.Cr _ + "Error: " + myException.Errors(i).ToString() + ControlChars.Cr) Next i End Sub [C#] public void DisplayIfxErrors(IfxException myException) { for (int i=0; i < myException.Errors.Count; i++) { MessageBox.Show("Index #" + i + "\n" + "Error: " + myException.Errors[i].ToString() + "\n"); } }
Consulta Clase IfxError en la pgina 3-371 Recopila informacin relevante para un aviso o error devuelto por la base de datos. Miembros de IfxError en la pgina 3-373 Visin general de IfxError Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxError
Las propiedades de la clase IfxError se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxError, consulte el tema Miembros de IfxError.
Propiedades pblicas
Obtiene una breve descripcin del error. Message Obtiene la informacin de error. NativeError RowNumber Obtiene un valor entero que indica el nmero del mandato dentro de la serie de mandatos encadenados que ha causado el error. Esta propiedad es vlida siempre que se ejecutan varias sentencias de SQL como parte de una nica operacin. Por ejemplo, esta propiedad es vlida cuando el encadenado est activo, durante una operacin de copia masiva y en operaciones Update realizadas por IfxDataAdapter.
3-376
Source
Obtiene el nombre del controlador que ha generado el error. El valor es actualmente IBM.Data.DB2. Obtiene el cdigo de error de cinco caracteres que sigue al estndar de SQL ANSI para la base de datos.
SQLState
Consulta Clase IfxError en la pgina 3-371 Recopila informacin relevante para un aviso o error devuelto por la base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxError.Message: Obtiene una breve descripcin del error. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <Serializable> Public ReadOnly Property Message As String [C#] [Serializable] public string Message {get;} [C++] [Serializable] public: __property String* get_Message(); [JScript] public Serializable function get Message() : String;
Valor de la propiedad Una descripcin del error. Ejemplo [Visual Basic, C#] El ejemplo siguiente muestra las propiedades de IfxError.
[Visual Basic] Public Sub DisplayIfxErrorCollection(myException As IfxException) Dim i As Integer For i = 0 To myException.Errors.Count - 1 MessageBox.Show("Index #" + i.ToString() + ControlChars.Cr _ + "Message: " + myException.Errors(i).Message + ControlChars.Cr _ + "Native: " + myException.Errors(i).NativeError.ToString() + ControlChars.Cr _ + "Source: " + myException.Errors(i).Source + ControlChars.Cr _ + "SQL: " + myException.Errors(i).SQLState + ControlChars.Cr) Next i
3-377
End Sub [C#] public void DisplayIfxErrorCollection(IfxException myException) { for (int i=0; i < myException.Errors.Count; i++) { MessageBox.Show("Index #" + i + "\n" + "Message: " + myException.Errors[i].Message + "\n" + "Native: " + myException.Errors[i].NativeError.ToString() + "\n" + "Source: " + myException.Errors[i].Source + "\n" + "SQL: " + myException.Errors[i].SQLState + "\n"); } }
Consulta Clase IfxError en la pgina 3-371 Recopila informacin relevante para un aviso o error devuelto por la base de datos. Miembros de IfxError en la pgina 3-373 Visin general de IfxError Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxError.NativeError: Obtiene la informacin de error. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <Serializable> Public ReadOnly Property NativeError As Integer [C#] [Serializable] public int NativeError {get;} [C++] [Serializable] public: __property int get_NativeError(); [JScript] public Serializable function get NativeError() : int;
Valor de la propiedad Informacin de error. Ejemplo [Visual Basic, C#] El ejemplo siguiente muestra las propiedades de IfxError.
3-378
Consulta Clase IfxError en la pgina 3-371 Recopila informacin relevante para un aviso o error devuelto por la base de datos. Miembros de IfxError en la pgina 3-373 Visin general de IfxError Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxError.RowNumber: Obtiene un valor entero que indica el nmero del mandato dentro de la serie de mandatos encadenados que ha causado el error. Esta propiedad es vlida siempre que se ejecutan varias sentencias de SQL como parte de una nica operacin. Por ejemplo, esta propiedad es vlida cuando el encadenado est activo, durante una operacin de copia masiva y en operaciones Update realizadas por IfxDataAdapter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property RowNumber As Integer [C#] public int RowNumber {get;} [C++] public: __property int get_RowNumber(); [JScript] public function get RowNumber() : int;
3-379
Valor de la propiedad Nmero de la sentencia en la serie de sentencias encadenadas que ha causado el IfxError. Por ejemplo, un valor RowNumber de 2 significa que la segunda sentencia de la serie de sentencias encadenadas ha causado el IfxError. Esta propiedad es vlida siempre que el encadenado est activo (cuando la propiedad IfxConnection.Chaining es true) y tambin siempre que se ejecutan varias sentencias de SQL como parte de una nica operacin. Ejemplo [Visual Basic, C#] El ejemplo siguiente utiliza el encadenamiento para insertar 10000 filas en la tabla STAFF.
Visual Basic] Dim con As IfxConnection = new IfxConnection("DATABASE=sample;") Dim cmd As IfxCommand = con.CreateCommand() con.Open() Initialize an insert statement using parameter markers cmd.CommandText = "INSERT INTO STAFF(ID) VALUES( ? )" Add a parameter Dim p1 As IfxParameter = cmd.Parameters.Add("@ID", IfxType.Integer ) Start the chain con.BeginChain() Try Loop to add 10000 rows Dim I As Int32 For I = 1 To 10000 Set the parameter value p1.Value = I Execute the command. Since chaining is active, this statement is now added to the chain cmd.ExecuteNonQuery() Next I Execute the chain con.EndChain() Catch db2Ex As IfxException Dim db2Error As IfxError Loop through all the errors For Each db2Error in db2Ex.Errors Console.WriteLine("SQLSTATE =" & db2Error.SQLState ) Console.WriteLine("NativeErr=" & db2Error.NativeError ) Console.WriteLine("RowNumber=" & db2Error.RowNumber ) Console.WriteLine( db2Error.Message ) Next IfxError Finally Explicitly turn chaining off in case it is still on If (con.Chaining) Then con.EndChain() End If End Try con.Close()[C#] DB2Connection con = new IfxConnection("DATABASE=sample;"); DB2Command cmd = con.CreateCommand(); con.Open();
3-380
// Initialize an insert statement using parameter markers cmd.CommandText = "INSERT INTO STAFF(ID) VALUES( ? )"; // Add a parameter DB2Parameter p1 = cmd.Parameters.Add("@ID", IfxType.Integer ); // Start the chain con.BeginChain(); try { // Loop to add 10000 rows for( Int32 i = 1; i <= 10000; i++ ) { // Set the parameter value p1.Value = i; // Execute the command. // Since chaining is active, this statement is now added // to the chain cmd.ExecuteNonQuery(); } // Execute the chain con.EndChain(); } catch( IfxException db2Ex ) { // Loop through all the errors foreach( IfxError db2Error in db2Ex.Errors ) { Console.WriteLine("SQLSTATE =" + db2Error.SQLState ); Console.WriteLine("NativeErr=" + db2Error.NativeError ); Console.WriteLine("RowNumber=" + db2Error.RowNumber ); Console.WriteLine( db2Error.Message ); } } finally { // Explicitly turn chaining off in case it is still on if( con.Chaining ) { con.EndChain(); } } con.Close();
Consulta Clase IfxError en la pgina 3-371 Recopila informacin relevante para un aviso o error devuelto por la base de datos. Miembros de IfxError en la pgina 3-373 Visin general de IfxError Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxError.SQLState: Obtiene el cdigo de error de cinco caracteres que sigue al estndar de SQL ANSI para la base de datos.
3-381

Visual Basic] <Serializable> Public ReadOnly Property SQLState As String [C#] [Serializable] public string SQLState {get;} [C++] [Serializable] public: __property String* get_SQLState(); [JScript] public Serializable function get SQLState() : String;
Valor de la propiedad El cdigo de error de cinco caracteres, que identifica la fuente del error si el error se puede emitir desde ms de un sitio. Ejemplo [Visual Basic, C#] El ejemplo siguiente muestra las propiedades de IfxError.
Consulta Clase IfxError en la pgina 3-371 Recopila informacin relevante para un aviso o error devuelto por la base de datos. Miembros de IfxError en la pgina 3-373 Visin general de IfxError Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-382
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxError.Source: Obtiene el nombre del controlador que ha generado el error. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <Serializable> Public ReadOnly Property Source As String [C#] [Serializable] public string Source {get;} [C++] [Serializable] public: __property String* get_Source(); [JScript] public Serializable function get Source() : String;
Valor de la propiedad El nombre del controlador que ha generado el error. Este valor actualmente es IBM.Data.Informix. Ejemplo [Visual Basic, C#] El ejemplo siguiente muestra las propiedades de un IfxError.
Consulta
3-383
Clase IfxError en la pgina 3-371 Recopila informacin relevante para un aviso o error devuelto por la base de datos. Miembros de IfxError en la pgina 3-373 Visin general de IfxError Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxErrorCollection
Recopila todos los errores generados. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object IBM.Data.Informix.IfxErrorCollection
Sintaxis
Visual Basic] <Serializable> NotInheritable Public Class IfxErrorCollection Implements ICollection, IEnumerable [C#] [Serializable] public sealed class IfxErrorCollection : ICollection, IEnumerable [C++] [Serializable] public __gc __sealed class IfxErrorCollection : public ICollection, IEnumerable [JScript] public Serializable class IfxErrorCollection implements ICollection, IEnumerable
Comentarios
Esta clase es creada por IfxException para recoger instancia de la clase IfxError. IfxErrorCollection siempre contiene como mnimo una instancia de la clase IfxError.
Ejemplo
[Visual Basic, C#] El ejemplo siguiente muestra cada IfxError contenido en la coleccin IfxErrorCollection.
[Visual Basic] Public Sub DisplayIfxErrorCollection(myException As IfxException) Dim i As Integer For i = 0 To myException.Errors.Count - 1 MessageBox.Show("Index #" + i.ToString() + ControlChars.Cr _ + "Message: " + myException.Errors(i).Message + ControlChars.Cr _
3-384
+ "Native: " + myException.Errors(i).NativeError.ToString() + ControlChars.Cr _ + "Source: " + myException.Errors(i).Source + ControlChars.Cr _ + "SQL: " + myException.Errors(i).SQLState + ControlChars.Cr) Next i End Sub [C#] public void DisplayIfxErrorCollection(IfxException myException) { for (int i=0; i < myException.Errors.Count; i++) { MessageBox.Show("Index #" + i + "\n" + "Message: " + myException.Errors[i].Message + "\n" + "Native: " + myException.Errors[i].NativeError.ToString() + "\n" + "Source: " + myException.Errors[i].Source + "\n" + "SQL: " + myException.Errors[i].SQLState + "\n"); } }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxErrorCollection Visin general de IfxErrorCollection Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Clase IfxError en la pgina 3-371 Recopila informacin relevante para un aviso o error devuelto por la base de datos. Clase IfxException en la pgina 3-392 La excepcin que se genera cuando una base de datos devuelve un aviso o un error.
Miembros de IfxErrorCollection
Visin general de IfxErrorCollection
Propiedades pblicas
Count this Obtiene el nmero de errores existentes en la coleccin. Obtiene el error en el ndice especificado. En C#, esta propiedad es el indexador para la clase IfxErrorCollection.
3-385
Mtodos pblicos
CopyTo Copia los elementos de la IfxErrorCollection en una matriz, empezando por el ndice determinado dentro de la matriz. Sobrecargado. Determina si dos instancias de Object son iguales. Sobrecargado. Este miembro da soporte a la infraestructura Microsoft(R) .NET Framework y no est diseado para utilizarlo directamente a partir del cdigo. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el Type de la instancia actual. GetType (heredado de Object) ToString (heredado de Object) Devuelve una String que representa el Object actual.
Equals (heredado de Object) GetEnumerator (heredado de Object)
Mtodos protegidos
Consulta Clase IfxErrorCollection en la pgina 3-384 Recopila todos los errores generados. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxErrorCollection
Los mtodos de la clase IfxErrorCollection se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxErrorCollection, consulte el tema Miembros de IfxErrorCollection.
3-386
Mtodos pblicos
CopyTo Copia los elementos de la IfxErrorCollection en una matriz, empezando por el ndice determinado dentro de la matriz. Sobrecargado. Determina si dos instancias de Object son iguales. Sobrecargado. Este miembro da soporte a la infraestructura Microsoft(R) .NET Framework y no est diseado para utilizarlo directamente a partir del cdigo. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el Type de la instancia actual. GetType (heredado de Object) ToString (heredado de Object) Devuelve una String que representa el Object actual.
Equals (heredado de Object) GetEnumerator (heredado de Object)
Mtodos protegidos
Consulta Clase IfxErrorCollection en la pgina 3-384 Recopila todos los errores generados. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxErrorCollection.CopyTo: Copia los elementos de la IfxErrorCollection en una matriz, empezando por el ndice determinado dentro de la matriz. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-387
Sintaxis
Visual Basic] <Serializable> NotOverridable Public Sub CopyTo( _ ByVal array As Array, _ ByVal i As Integer _ ) Implements ICollection.CopyTo [C#] [Serializable] public void CopyTo( Array array, int i ); [C++] [Serializable] public: __sealed void CopyTo( Array* array, int i ); [JScript] public Serializable function CopyTo( array : Array, i : int );
Implementa: ICollection.CopyTo Parmetros array i La matriz en la que se deben copiar los elementos. El ndice de inicio de array.
Excepciones
Tipo de excepcin ArgumentException Condicin La suma de index y el nmero de elementos de IfxErrorCollection es mayor que la longitud de la matriz. array es una referencia nula (Nothing en Microsoft(R) Visual Basic(R)). El index no es vlido para la array.
ArgumentNullException ArgumentOutOfRangeException
Consulta Clase IfxErrorCollection en la pgina 3-384 Recopila todos los errores generados. Miembros de IfxErrorCollection en la pgina 3-385 Visin general de IfxErrorCollection Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxErrorCollection.GetEnumerator:
3-388
Este miembro da soporte a la infraestructura Microsoft(R) .NET Framework y no est diseado para utilizarlo directamente a partir del cdigo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <Serializable> NotOverridable Public Function GetEnumerator() As IEnumerator _ Implements IEnumerable.GetEnumerator [C#] [Serializable] public IEnumerator GetEnumerator(); [C++] [Serializable] public: __sealed IEnumerator* GetEnumerator(); [JScript] public Serializable function GetEnumerator() : IEnumerator;
Consulta Clase IfxErrorCollection en la pgina 3-384 Recopila todos los errores generados. Miembros de IfxErrorCollection en la pgina 3-385 Visin general de IfxErrorCollection Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxErrorCollection
Las propiedades de la clase IfxErrorCollection se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxErrorCollection, consulte el tema Miembros de IfxErrorCollection.
Propiedades pblicas
Count this Obtiene el nmero de errores existentes en la coleccin. Obtiene el error en el ndice especificado. En C#, esta propiedad es el indexador para la clase IfxErrorCollection.
Consulta Clase IfxErrorCollection en la pgina 3-384 Recopila todos los errores generados. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-389
Propiedad IfxErrorCollection.Count: Obtiene el nmero de errores existentes en la coleccin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <Serializable> Public ReadOnly Property Count As Integer ICollection.Count [C#] [Serializable] public int Count {get;} [C++] [Serializable] public: __property int get_Count(); [JScript] public Serializable function get Count() : int;
Implements _
Implementa: ICollection.Count Valor de la propiedad El nmero total de errores en la coleccin. Ejemplo [Visual Basic, C#] El ejemplo siguiente muestra cada IfxError contenido en la IfxErrorCollection.
Consulta
3-390
Clase IfxErrorCollection en la pgina 3-384 Recopila todos los errores generados. Miembros de IfxErrorCollection en la pgina 3-385 Visin general de IfxErrorCollection Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxErrorCollection.Item: Obtiene el error en el ndice especificado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <Serializable> Public Default ReadOnly Property Item( _ ByVal i As Integer _ ) As IfxError [C#] [Serializable] public IfxError this[ int i ] {get;} [C++] [Serializable] public: __property IfxError * get_Item( int i ); [JScript] returnValue = IfxErrorCollectionObject.Item(i); -o bienreturnValue = IfxErrorCollectionObject(i);
Valor de la propiedad IfxError que contiene el error en el ndice especificado. Comentarios El ejemplo siguiente muestra cada IfxError contenido en la IfxErrorCollection.
[C#] public void DisplayIfxErrorCollection(IfxException myException) { for (int i=0; i < myException.Errors.Count; i++) { MessageBox.Show("Index #" + i + "\n" + "Message: " + myException.Errors[i].Message + "\n" + "Native: " + myException.Errors[i].NativeError.ToString() + "\n" +
3-391
"Source: " + myException.Errors[i].Source + "\n" + "SQL: " + myException.Errors[i].SQLState + "\n"); } }
Consulta Clase IfxErrorCollection en la pgina 3-384 Recopila todos los errores generados. Miembros de IfxErrorCollection en la pgina 3-385 Visin general de IfxErrorCollection Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxException
La excepcin que se genera cuando una base de datos devuelve un aviso o un error. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)

System.Object System.Exception System.SystemException IBM.Data.Informix.IfxException

System.Object System.Exception System.SystemException System.Runtime.InteropServices.SystemException System.Data.Common.DbException IBM.Data.Informix.IfxException

Visual Basic] <Serializable> NotInheritable Public Class IfxException Inherits SystemException [C#] [Serializable] public sealed class IfxException : SystemException [C++] [Serializable] public __gc __sealed class IfxException : public SystemException [JScript] public Serializable class IfxException extends SystemException
3-392

Visual Basic] <Serializable> NotInheritable Public Class IfxException Inherits DbException [C#] [Serializable] public sealed class IfxException : DbException [C++] [Serializable] public __gc __sealed class IfxException : public DbException [JScript] public Serializable class IfxException extends DbException
Comentarios
Esta clase se crea cada vez que el servidor de bases de datos genera un error. (Los errores del extremo cliente se emiten como excepciones de ejecucin del lenguaje comn estndar.) Siempre contiene como mnimo una instancia de IfxError. Si la gravedad del error es demasiado alta, puede que el servidor cierre IfxConnection. Si el servidor cierra la conexin, ser necesario que la aplicacin abra una nueva conexin.
Ejemplo
[Visual Basic, C#] El ejemplo siguiente genera una IfxException debido a que falta una base de datos y, a continuacin, visualiza la excepcin.
Visual Basic] Public Sub ThrowIfxException() Dim mySelectQuery As String = "SELECT column1 FROM table1" Dim myConnection As New IfxConnection _ ("DATABASE=BADDB;") Dim myCommand As New IfxCommand(mySelectQuery, myConnection) Try myCommand.Connection.Open() Catch myException As IfxException Dim i As Integer For i = 0 To myException.Errors.Count - 1 MessageBox.Show("Index #" + i.ToString() + ControlChars.Cr _ + "Message: " + myException.Errors(i).Message + ControlChars.Cr _ + "Native: " + myException.Errors(i).NativeError.ToString() + ControlChars.Cr _ + "Source: " + myException.Errors(i).Source + ControlChars.Cr _ + "SQL: " + myException.Errors(i).SQLState + ControlChars.Cr) Next i End Try End Sub [C#] public void ThrowIfxException() { string mySelectQuery = "SELECT column1 FROM table1"; IfxConnection myConnection = new IfxConnection("DATABASE=BADDB;"); IfxCommand myCommand = new IfxCommand(mySelectQuery,myConnection); try { myCommand.Connection.Open(); } catch (IfxException myException) {
3-393
for (int i=0; i < myException.Errors.Count; i++) { MessageBox.Show("Index #" + i + "\n" + "Message: " + myException.Errors[i].Message + "\n" + "Native: " + myException.Errors[i].NativeError.ToString() + "\n" + "Source: " + myException.Errors[i].Source + "\n" + "SQL: " + myException.Errors[i].SQLState + "\n"); } } }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de excepcin de Ifx Visin general de IfxException Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Clase IfxError en la pgina 3-371 Recopila informacin relevante para un aviso o error devuelto por la base de datos. Clase IfxErrorCollection en la pgina 3-384 Recopila todos los errores generados.
Miembros de excepcin de Ifx

Visin general de IfxException
Propiedades pblicas
Errors Obtiene una coleccin de uno o ms objetos IfxError que proporcionan informacin detallada sobre excepciones generadas por IBM Data Server Provider for .NET. Obtiene o establece un enlace con el archivo de ayuda asociado con esta excepcin. Obtiene la instancia de Exception que ha causado la excepcin actual. Alterado temporalmente. Obtiene el texto que describe el error. Alterado temporalmente. Obtiene el nombre del controlador que ha generado el error.
HelpLink (heredada de Exception) InnerException (heredada de Exception) Message Source
3-394
StackTrace (heredada de Exception)
Obtiene una representacin de series de las tramas en la pila de llamada en el momento en que se ha emitido la excepcin actual. Obtiene el mtodo que emite la excepcin actual.
TargetSite (heredada de Exception)
Mtodos pblicos
Equals (heredado de Object) GetBaseException (heredado de Exception) Sobrecargado. Determina si dos instancias de Object son iguales. Cuando est alterado temporalmente en una clase derivada, devuelve la Exception que es la causa inicial de una o ms excepciones subsiguientes. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Alterado temporalmente. Consulte Exception.GetObjectData. Obtiene el Type de la instancia actual. GetType (heredado de Object) ToString (heredado de Exception) Alterado temporalmente. Crea y devuelve una representacin de series de la excepcin actual.
GetObjectData
HResult (heredada de Exception) Obtiene o establece HRESULT, un valor numrico codificado que se asigna a una excepcin especfica.
Mtodos protegidos
Consulta Clase IfxException en la pgina 3-392 La excepcin que se genera cuando una base de datos devuelve un aviso o un error.
3-395
Mtodos de IfxException
Los mtodos de la clase IfxException se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxException, consulte el tema Miembros de IfxException.
Mtodos pblicos
GetObjectData
Mtodos protegidos
Consulta Clase IfxException en la pgina 3-392 La excepcin que se genera cuando una base de datos devuelve un aviso o un error. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-396
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxException.GetObjectData: Este miembro altera temporalmente System.Exception.GetObjectData. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <Serializable> Overrides Public Sub GetObjectData( _ ByVal si As SerializationInfo, _ ByVal context As StreamingContext _ ) Implements ISerializable.GetObjectData [C#] [Serializable] public override void GetObjectData( SerializationInfo si, StreamingContext context ); [C++] [Serializable] public: void GetObjectData( SerializationInfo* si, StreamingContext context ); [JScript] public Serializable override function GetObjectData( si : SerializationInfo, context : StreamingContext );
Consulta Clase IfxException en la pgina 3-392 La excepcin que se genera cuando una base de datos devuelve un aviso o un error. Miembros de excepcin de Ifx en la pgina 3-394 Visin general de IfxException Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxException
Las propiedades de la clase IfxException se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxException, consulte el tema Miembros de IfxException.
3-397
Propiedades pblicas
Errors Obtiene una coleccin de uno o ms objetos IfxError que proporcionan informacin detallada sobre excepciones generadas por IBM Data Server Provider for .NET. Obtiene o establece un enlace con el archivo de ayuda asociado con esta excepcin. Obtiene la instancia de Exception que ha causado la excepcin actual. Alterado temporalmente. Obtiene el texto que describe el error. Alterado temporalmente. Obtiene el nombre del controlador que ha generado el error. Obtiene una representacin de series de las tramas en la pila de llamada en el momento en que se ha emitido la excepcin actual. Obtiene el mtodo que emite la excepcin actual.
HelpLink (heredada de Exception) InnerException (heredada de Exception) Message Source StackTrace (heredada de Exception)
Consulta Clase IfxException en la pgina 3-392 La excepcin que se genera cuando una base de datos devuelve un aviso o un error. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedades de IfxException.Errors: Obtiene una coleccin de uno o ms objetos IfxError que proporcionan informacin detallada sobre excepciones generadas por IBM Data Server Provider for .NET. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <Serializable> Public ReadOnly Property Errors As IfxErrorCollection [C#] [Serializable]
3-398
public IfxErrorCollection Errors {get;} [C++] [Serializable] public: __property IfxErrorCollection * get_Errors(); [JScript] public Serializable function get Errors() : IfxErrorCollection ;
Valor de la propiedad Las instanacias recogidas de la clase IfxError. Comentarios Esta propiedad es un envoltorio de IfxErrorCollection. Ejemplo [Visual Basic, C#] El ejemplo siguiente muestra cada IfxError contenido en una coleccin IfxErrorCollection.
Consulta Clase IfxException en la pgina 3-392 La excepcin que se genera cuando una base de datos devuelve un aviso o un error. Miembros de excepcin de Ifx en la pgina 3-394 Visin general de IfxException Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-399
Propiedad IfxException.Message: Obtiene el texto que describe el error. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <Serializable> Overrides Public ReadOnly Property Message As String [C#] [Serializable] public override string Message {get;} [C++] [Serializable] public: __property virtual String* get_Message(); [JScript] public Serializable function get Message() : String;
Valor de la propiedad El texto que describe el error. Comentarios Esto es un envoltorio para la propiedad IfxError.Message del primer IfxError de la propiedad Errors. Ejemplo [Visual Basic, C#] El ejemplo siguiente muestra el IfxError.Message del primer IfxError contenido en una coleccin Ifx ErrorCollection.
Visual Basic] Public Sub DisplayIfxErrorCollection(myException As IfxException) MessageBox.Show("Message: " + myException.Message + ControlChars.Cr _ + "StackTrace: " + myException.StackTrace + ControlChars.Cr End Sub End Class [C#] public void DisplayIfxErrorCollection(IfxException myException) { MessageBox.Show("Message: " + myException.Message + "\n" + "StackTrace: " + myException.StackTrace + "\n"; }
Consulta Clase IfxException en la pgina 3-392 La excepcin que se genera cuando una base de datos devuelve un aviso o un error. Miembros de excepcin de Ifx en la pgina 3-394 Visin general de IfxException Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-400
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxException.Source: Obtiene el nombre del controlador que ha generado el error. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <Serializable> Overrides Public ReadOnly Property Source As String [C#] [Serializable] public override string Source {get;} [C++] [Serializable] public: __property virtual String* get_Source(); [JScript] public Serializable function get Source() : String;
Valor de la propiedad IBM.Data.DB2 Comentarios Est oes un envoltorio para la propiedad IfxError.Source del primer IfxError de la coleccin Errors. Ejemplo [Visual Basic, C#] El ejemplo siguiente muestra las propiedades de rastreo de pilas, IfxError.Message, IfxError.Source del primer IfxError contenido en la coleccin Ifx ErrorCollection.
Visual Basic] Public Sub DisplayIfxErrorCollection(myException As IfxException) MessageBox.Show("Message: " + myException.Message + ControlChars.Cr _ + "StackTrace: " + myException.StackTrace + ControlChars.Cr _ + "Source: " + myException.Source + ControlChars.Cr) End Sub [C#] public void DisplayIfxErrorCollection(IfxException myException) { MessageBox.Show("Message: " + myException.Message + "\n" + "StackTrace: " + myException.StackTrace + "\n" + "Source: " + myException.Source + "\n"); }
Consulta Clase IfxException en la pgina 3-392 La excepcin que se genera cuando una base de datos devuelve un aviso o un error.
3-401
Miembros de excepcin de Ifx en la pgina 3-394 Visin general de IfxException Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxFactory
Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.Data.Common.DbProviderFactory IBM.Data.Informix.IfxFactory
Sintaxis
Visual Basic] Public NotInheritable Class IfxFactory Inherits DbProviderFactory [C#] public sealed class IfxFactory : DbProviderFactory [C++] public ref class IfxFactory sealed : public DbProviderFactory [JScript] public final class IfxFactory extends DbProviderFactory
Ejemplo
[C#] El ejemplo siguiente demuestra la creacin de una instancia de DbConnection utilizando el mtodo IfxFactory.CreateConnection.
[C#] IfxFactory myFactory = IfxFactory.Instance; DbConnection conn = myFactory.CreateConnection();
[C#] Tambin puede obtener una instancia de factoria de bases de datos utilizando la clase genrica DbProviderFactories. En el ejemplo siguiente, que realiza la misma tarea que el ejemplo anterior, observe la serie de caracteres "IBM.Data.DB2" pasada al mtodo GetFactory. Esta serie de caracteres identifica de forma exclusiva IBM Data Server Provider for .NET de todos los dems proveedores de datos .NET.
[C#] DbProviderFactory myFactory = DbProviderFactories.GetFactory("IBM.Data.DB2"); DbConnection conn = myFactory.CreateConnection();
Seguridad de hebra
3-402
Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Miembros de IfxFactory Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Miembros de IfxFactory
Los miembros de la clase IfxFactory se listan a continuacin.
Propiedades pblicas
Nombre Descripcin Alterado temporalmente. Obtiene un valor booleano que indica si IfxFactory puede crear una instancia de DbDataSourceEnumerator. CanCreateDataSourceEnumerator
Mtodos pblicos
Nombre CreateCommand Alterado temporalmente. Devuelve una instancia de DbCommandBuilder. CreateCommandBuilder Alterado temporalmente. Devuelve una instancia de DbConnection. CreateConnection CreateConnectionStringBuilder CreateDataAdapter CreateDataSourceEnumerator CreateParameter CreatePermission Alterado temporalmente. Devuelve una instancia de System.Security.CodeAccessPermission. Alterado temporalmente. Devuelve una instancia de DbDataSourceEnumerator. Alterado temporalmente. Devuelve una instancia de DbParameter. Alterado temporalmente. Devuelve una instancia de DbConnectionStringBuilder. Alterado temporalmente. Devuelve una instancia de DbDataAdapter. Descripcin Alterado temporalmente. Devuelve una instancia de DbCommand.
Campos pblicos
Nombre Instancia Descripcin Obtiene una instancia de IfxFactory.
Consulta
3-403
Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Campos de IfxFactory
Los campos de la clase IfxFactory se listan a continuacin.
Campos pblicos
Nombre Instancia Descripcin Obtiene una instancia de IfxFactory.
Consulta Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET. Miembros de IfxFactory en la pgina 3-403 Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Campo IfxFactory.Instance: Obtiene una instancia de IfxFactory. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Instance As IfxFactory [C#] public static readonly IfxFactory Instance [C++] public: static initonly IfxFactory^ Instance [JScript] public static final var Instance () : IfxFactory
Ejemplo [C#] El ejemplo siguiente demuestra la creacin de una instancia de IfxFactory.
3-404
[C#] IfxFactory myFactory = IfxFactory.Instance;
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET. Miembros de IfxFactory en la pgina 3-403 Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxFactory
Los mtodos de la clase IfxFactory se listan a continuacin.
Mtodos pblicos
Nombre CreateCommand Alterado temporalmente. Devuelve una instancia de DbCommandBuilder. CreateCommandBuilder Alterado temporalmente. Devuelve una instancia de DbConnection. CreateConnection CreateConnectionStringBuilder CreateDataAdapter CreateDataSourceEnumerator CreateParameter CreatePermission Alterado temporalmente. Devuelve una instancia de System.Security.CodeAccessPermission. Alterado temporalmente. Devuelve una instancia de DbDataSourceEnumerator. Alterado temporalmente. Devuelve una instancia de DbParameter. Alterado temporalmente. Devuelve una instancia de DbConnectionStringBuilder. Alterado temporalmente. Devuelve una instancia de DbDataAdapter. Descripcin Alterado temporalmente. Devuelve una instancia de DbCommand.
Consulta Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET. Miembros de IfxFactory en la pgina 3-403 Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-405
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxFactory.CreateCommandBuilder: Devuelve una instancia de DbCommandBuilder. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function CreateCommandBuilder As DbCommandBuilder [C#] public override DbCommandBuilder CreateCommandBuilder () [C++] public: virtual DbCommandBuilder^ CreateCommandBuilder () override [JScript] public override function CreateCommandBuilder () : DbCommandBuilder
Valor de retorno instancia de DbCommandBuilder, que permitir el intercambio de datos con bases de datos de la familia DB2, mediante IBM Data Server Provider for .NET. Ejemplo [C#] El ejemplo siguiente demuestra la creacin de una instancia de DbCommandBuilder, utilizando el mtodo IfxFactory.CreateCommandBuilder.
[C#] IfxFactory myFactory = IfxFactory.Instance; DbCommandBuilder cmdbld = myFactory.CreateCommandBuilder();
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET. Miembros de IfxFactory en la pgina 3-403 Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxFactory.CreateCommand: Devuelve una instancia de DbCommand.
3-406

Visual Basic] Public Overrides Function CreateCommand As DbCommand [C#] public override DbCommand CreateCommand () [C++] public: virtual DbCommand^ CreateCommand () override [JScript] public override function CreateCommand () : DbCommand
Valor de retorno Una instancia de DbCommand, que puede representar sentencias de SQL o procedimientos almacenados que ejecuta contra bases de datos de la familia DB2 mediante IBM Data Server Provider for .NET. Ejemplo [C#] El ejemplo siguiente demuestra la creacin de una instancia de DbCommand utilizando el mtodo IfxFactory.CreateCommand.
[C#] IfxFactory myFactory = IfxFactory.Instance; DbCommand cmd = myFactory.CreateCommand();
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET. Miembros de IfxFactory en la pgina 3-403 Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxFactory.CreateConnection: Devuelve una instancia de DbConnection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-407
Sintaxis
Visual Basic] Public Overrides Function CreateConnection As DbConnection [C#] public override DbConnection CreateConnection () [C++] public: virtual DbConnection^ CreateConnection () override [JScript] public override function CreateConnection () : DbConnection
Valor de retorno instancia de DbConnection, que permitir las conexiones con bases de datos de la familia DB2 mediante IBM Data Server Provider for .NET. Ejemplo [C#] El ejemplo siguiente demuestra la creacin de una instancia de DbConnection utilizando el mtodo IfxFactory.CreateConnection.
[C#] IfxFactory myFactory = IfxFactory.Instance; DbConnection conn = myFactory.CreateConnection();
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET. Miembros de IfxFactory en la pgina 3-403 Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxFactory.CreateConnectionStringBuilder: Devuelve una instancia de DbConnectionStringBuilder. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function CreateConnectionStringBuilder As DbConnectionStringBuilder [C#] public override DbConnectionStringBuilder CreateConnectionStringBuilder () [C++] public:
3-408
virtual DbConnectionStringBuilder^ CreateConnectionStringBuilder () override [JScript] public override function CreateConnectionStringBuilder () : DbConnectionStringBuilder
Valor de retorno Instancia de DbConnectionStringBuilder que facilitar la creacin de series de conexin para un servidor de datos de IBM. Ejemplo [C#] El ejemplo siguiente demuestra la creacin de una instancia de DbConnectionStringBuilder, utilizando el mtodo IfxFactory.ConnectionStringBuilder.
[C#] IfxFactory myFactory = IfxFactory.Instance; DbConnectionStringBuilder stringbuilder = myFactory.CreateConnectionStringBuilder();
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET. Miembros de IfxFactory en la pgina 3-403 Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxFactory.CreateDataAdapter: Devuelve una instancia de DbDataAdapter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function CreateDataAdapter As DbDataAdapter [C#] public override DbDataAdapter CreateDataAdapter () [C++] public: virtual DbDataAdapter^ CreateDataAdapter () override [JScript] public override function CreateDataAdapter () : DbDataAdapter
3-409
Valor de retorno instancia de DbDataAdapter, que permitir las conexiones con bases de datos de la familia DB2, mediante IBM Data Server Provider for .NET. Ejemplo [C#] El ejemplo siguiente demuestra la creacin de una instancia de DbDataAdapter utilizando el mtodo IfxFactory.CreateDataAdapter.
[C#] IfxFactory myFactory = IfxFactory.Instance; DbDataAdapter adapter = myFactory.CreateDataAdapter();
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET. Miembros de IfxFactory en la pgina 3-403 Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxFactory.CreateDataSourceEnumerator: Devuelve una instancia de DbDataSourceEnumerator. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function CreateDataSourceEnumerator As DbDataSourceEnumerator [C#] public override DbDataSourceEnumerator CreateDataSourceEnumerator () [C++] public: virtual DbDataSourceEnumerator^ CreateDataSourceEnumerator () override [JScript] public override function CreateDataSourceEnumerator () : DbDataSourceEnumerator
Valor de retorno instancia de DbDataSourceEnumerator, que le permitir encontrar instancias visibles de servidores de bases de datos de la familia DB2 y bases de datos en esas instancias. La instancia de DbDataSourceEnumerator funciona mediante IBM Data Server Provider for .NET y puede ver lo siguiente:
3-410
v todas las bases de datos catalogadas en la instancia local. En caso de que existan varias instancias locales en ejecucin, slo se ver la instancia a la que la aplicacin est conectada. v todas las instancias visibles de servidores de bases de datos remotos y las bases de datos de las mismas. Para poder verse, las instancias de servidores de bases de datos remotos deben tener un servidor de administracin de bases de datos (DAS) en ejecucin, que est configurado para responder a las solicitudes de descubrimiento conocido y bsqueda. v Se vern las instancias de servidores de bases de datos sin ninguna base de datos. Ejemplo [C#] El ejemplo siguiente demuestra la creacin de una instancia de DbDataSourceEnumerator, utilizando el mtodo IfxFactory.CreateDataSourceEnumerator.
[C#] IfxFactory myFactory = IfxFactory.Instance; if (myFactory.CanCreateDataSourceEnumerator) { DbDataSourceEnumerator dsenum = myFactory.CreateDataSourceEnumerator(); }
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET. Miembros de IfxFactory en la pgina 3-403 Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxFactory.CreateParameter: Devuelve una instancia de DbParameter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function CreateParameter As DbParameter [C#] public override DbParameter CreateParameter () [C++]
3-411
public: virtual DbParameter^ CreateParameter () override [JScript] public override function CreateParameter () : DbParameter
Valor de retorno instancia de DbParameter, que puede representar parmetros para una instancia de DbCommand. Ejemplo [C#] El ejemplo siguiente demuestra la creacin de una instancia de DbParameter utilizando el mtodo IfxFactory.CreateParameter.
[C#] IfxFactory myFactory = IfxFactory.Instance; DbParameter param = myFactory.CreateParameter();
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET. Miembros de IfxFactory en la pgina 3-403 Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxFactory.CreatePermission (System.Security.Permissions.PermissionState): Devuelve una instancia de System.Security.CodeAccessPermission. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function CreatePermission ( _ state As PermissionState _ ) As CodeAccessPermission [C#] public override CodeAccessPermission CreatePermission ( PermissionState state ) [C++] public: virtual CodeAccessPermission^ CreatePermission ( PermissionState state
3-412
) override [JScript] public override function CreatePermission ( state : PermissionState ) : CodeAccessPermission
Parmetros state Instancia de System.Security.Permissions.PermissionState.
Valor de retorno instancia de System.Security.CodeAccessPermission. Ejemplo [C#] El ejemplo siguiente demuestra la creacin de una instancia de CodeAccessPermission, utilizando el mtodo IfxFactory.CreatePermission.
[C#] IfxFactory myFactory = IfxFactory.Instance; System.Security.Permissions.PermissionState state = System.Security.Permissions.PermissionState.None; CodeAccessPermission permission = myFactory.CreatePermission(state);
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET. Miembros de IfxFactory en la pgina 3-403 Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxFactory
Las propiedades de la clase IfxFactory se listan a continuacin.
Propiedades pblicas
Nombre Descripcin Alterado temporalmente. Obtiene un valor booleano que indica si IfxFactory puede crear una instancia de DbDataSourceEnumerator. CanCreateDataSourceEnumerator
Consulta Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET.
3-413
Miembros de IfxFactory en la pgina 3-403 Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxFactory.CanCreateDataSourceEnumerator: Obtiene un valor booleano que indica si IfxFactory puede crear una instancia de DbDataSourceEnumerator. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides ReadOnly Property CanCreateDataSourceEnumerator As Boolean [C#] public override bool CanCreateDataSourceEnumerator { get; } [C++] public: virtual property bool CanCreateDataSourceEnumerator { bool get () override; } [JScript] public override function get CanCreateDataSourceEnumerator () : boolean
Valor de la propiedad true si IfxFactory puede crear una instancia de DbDataSourceEnumerator; de lo contrario, false. Ejemplo [C#] El ejemplo siguiente demuestra el uso de la propiedad CanCreateDataSourceEnumerator, en la creacin de una instancia de DbDataSourceEnumerator.
[C#] IfxFactory myFactory = IfxFactory.Instance; if (myFactory.CanCreateDataSourceEnumerator) { DbDataSourceEnumerator dsenum = myFactory.CreateDataSourceEnumerator(); }
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxFactory en la pgina 3-402 Representa un conjunto de mtodos para la creacin de instancias de las clases de fuente de datos System.Data.Common para IBM Data Server Provider for .NET.
3-414
Mtodo IfxFactory.CreateDataSourceEnumerator en la pgina 3-410 Devuelve una instancia de DbDataSourceEnumerator. Miembros de IfxFactory en la pgina 3-403 Los miembros de la clase IfxFactory se listan a continuacin. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxInfoMessageEventArgs
Proporciona datos para el suceso InfoMessage. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.EventArgs IBM.Data.Informix.IfxInfoMessageEventArgs
Sintaxis
Visual Basic] NotInheritable Public Class IfxInfoMessageEventArgs Inherits EventArgs [C#] public sealed class IfxInfoMessageEventArgs : EventArgs [C++] public __gc __sealed class IfxInfoMessageEventArgs : public EventArgs [JScript] public class IfxInfoMessageEventArgs extends EventArgs
Comentarios
El suceso InfoMessage contiene una coleccin IfxErrorCollection con avisos enviados desde la base de datos.
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxInfoMessageEventArgs en la pgina 3-416 Visin general de IfxInfoMessageEventArgs Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-415
Miembros de IfxInfoMessageEventArgs
Visin general de IfxInfoMessageEventArgs
Propiedades pblicas
Mtodos pblicos
Equals (heredado de Object) GetHashCode (heredado de Object) Sobrecargado. Determina si dos instancias de Object son iguales. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el Type de la instancia actual. GetType (heredado de Object) ToString (heredado de Object) Devuelve una String que representa el Object actual.
Mtodos protegidos
Consulta Clase IfxInfoMessageEventArgs en la pgina 3-415 Proporciona datos para el suceso InfoMessage. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxInfoMessageEventArgs
Las propiedades de la clase IfxInfoMessageEventArgs se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxInfoMessageEventArgs, consulte el tema Miembros de IfxInfoMessageEventArgs.
3-416
Propiedades pblicas
Consulta Clase IfxInfoMessageEventArgs en la pgina 3-415 Proporciona datos para el suceso InfoMessage. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxInfoMessageEventArgs.Errors: Obtiene la coleccin de avisos enviados desde la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Errors As IfxErrorCollection [C#] public IfxErrorCollection Errors {get;} [C++] public: __property IfxErrorCollection * get_Errors(); [JScript] public function get Errors() : IfxErrorCollection ;
Valor de la propiedad La coleccin de avisos enviados desde la base de datos. Consulta Clase IfxInfoMessageEventArgs en la pgina 3-415 Proporciona datos para el suceso InfoMessage. Miembros de IfxInfoMessageEventArgs en la pgina 3-416 Visin general de IfxInfoMessageEventArgs Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Delegado de IfxInfoMessageEventHandler: Representa el mtodo que manejar el suceso InfoMessage de una IfxConnection. Espacio de nombres: IBM.Data.Informix
3-417

Visual Basic] <Serializable> Public Delegate Sub IfxInfoMessageEventHandler( _ ByVal sender As Object, _ ByVal e As IfxInfoMessageEventArgs _ ) [C#] [Serializable] public delegate void IfxInfoMessageEventHandler( object sender, IfxInfoMessageEventArgs e ); [C++] [Serializable] public __gc __delegate void IfxInfoMessageEventHandler( Object* sender, IfxInfoMessageEventArgs* e );
Comentarios Cuando crea un delegado de IfxInfoMessageEventArgs, identifica el mtodo que manejar el suceso. Para asociar el suceso con el manejador de sucesos, aada una instancia del delegado al suceso. Se llama al manejador de sucesos siempre que se produce el suceso, a menos que se elimine el delegado. Para obtener ms informacin sobre delegados de manejador de sucesos, consulte el apartado Sucesos y delegados en la documentacin del SDK de .NET Framework. Consulta Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxParameter
Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)

System.Object System.MarshalByRefObject IBM.Data.Informix.IfxParameter
3-418

System.Object System.MarshalByRefObject System.Data.Common.DbParameter IBM.Data.Informix.IfxParameter

Visual Basic] NotInheritable Public Class IfxParameter Inherits MarshalByRefObject Implements IDbDataParameter, IDataParameter, ICloneable [C#] public sealed class IfxParameter : MarshalByRefObject, IDbDataParameter, IDataParameter, ICloneable [C++] public __gc __sealed class IfxParameter : public MarshalByRefObject, IDbDataParameter, IDataParameter, ICloneable [JScript] public class IfxParameter extends MarshalByRefObject implements IDbDataParameter, IDataParameter, ICloneable

Visual Basic] NotInheritable Public Class IfxParameter Inherits DbParameter Implements IDbDataParameter, IDataParameter, ICloneable [C#] public sealed class IfxParameter : DbParameter, IDbDataParameter, IDataParameter, ICloneable [C++] public __gc __sealed class IfxParameter : public DbParameter, IDbDataParameter, IDataParameter, ICloneable [JScript] public class IfxParameter extends DbParameter implements IDbDataParameter, IDataParameter, ICloneable
Comentarios
Los nombres de parmetros no son sensibles a maysculas y minsculas. A los parmetros pueden asignrseles dos tipos de valores: v valores asignados a un tipo enumerado DB2Type. v valores de clases y estructuras de espacios de nombres de IBM.Data.IfxTypes
Ejemplo
[Visual Basic, C#] El ejemplo siguiente crea varias instancias de IfxParameter en la IfxParameterCollection contenidos en el IfxDataAdapter. Estos parmetros se utilizan para seleccionar datos de la base de datos y colocar los datos en el DataSet. Este ejemplo asume que ya se ha creado un DataSet y un IfxDataAdapter con el esquema, los mandatos y la conexin adecuados.
[Visual Basic] Public Sub AddIfxParameters() ... create myDataSet and myDataAdapter ... myDataAdapter.SelectCommand.Parameters.Add( "CategoryName", IfxType.VarChar, 80).Value = "toasters" myDataAdapter.SelectCommand.Parameters.Add(
3-419
"SerialNum", IfxType.Integer).Value = 239 myDataAdapter.Fill(myDataSet) End Sub AddIfxParmetros [C#] public void AddIfxParameters() { // ... // create myDataSet and myDataAdapter // ... myDataAdapter.SelectCommand.Parameters.Add( "CategoryName", IfxType.VarChar, 80).Value = "toasters"; myDataAdapter.SelectCommand.Parameters.Add( "SerialNum", IfxType.Integer).Value = 239; myDataAdapter.Fill(myDataSet); }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxParameter Miembros de la clase Visin general de IfxParameter Enumeracin IfxType en la pgina 3-714 Especifica el tipo de datos de un campo, una propiedad o un IfxParameter. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbDatAdp.cs DbDatAdp.vb DbUse.cs DbUse.vb
Miembros de IfxParameter
Miembros de la clase Visin general de IfxParameter
IfxParameter Sobrecargado. Inicializa una instancia nueva de la clase IfxParameter.
3-420
Propiedades pblicas
Obtiene o establece el IfxType del parmetro. IfxType IfxTypeOutput Determina si los valores del parmetro de slo salida asociados con el IfxParameter se devolvern como tipos de datos DB2 nativos (especialmente, clases y estructuras en el espacio de nombres IBM.Data.IfxTypes). Obtiene o establece el DbType del parmetro. Obtiene o establece un valor que indica si el parmetro es slo de entrada, slo de salida, bidireccional o un parmetro de valor de retorno de procedimiento almacenado. Obtiene o establece un valor que indica si el parmetro acepta valores nulos. Obtiene o establece el nombre del IfxParameter. Obtiene o establece el nmero mximo de dgitos utilizados para representar la propiedad Value. Obtiene o establece el nmero de posiciones decimales en los que Value se resuelve. Obtiene o establece el tamao mximo, en bytes, de los datos dentro de la columna. Obtiene o establece el nombre de la columna fuente correlacionada con el DataSet y utilizada para cargar y devolver el Value. Obtiene o establece un valor que indica si la columna puede contener nulos. Obtiene o establece la DataRowVersion que se va a utilizar al cargar Value. Obtiene o establece el valor del parmetro. Value
DbType Direction
IsNullable ParameterName Precision
Scale Size SourceColumn
SourceColumnNullMapping SourceVersion
Mtodos pblicos
CreateObjRef (heredado de MarshalByRefObject) Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Sobrecargado. Determina si dos instancias de Object son iguales. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash.
Equals (heredado de Object) GetHashCode (heredado de Object)
3-421
GetLifetimeService (heredado de MarshalByRefObject) GetType (heredado de Object) InitializeLifetimeService (heredado de MarshalByRefObject) ResetDbType
Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el Type de la instancia actual. Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Alterado temporalmente. Restablece el tipo de datos asociado con esta instancia de IfxParameter. Alterado temporalmente. Obtiene una serie que contiene el ParameterName.
ToString
Mtodos protegidos
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Constructor de IfxParameter
Inicializa una instancia nueva de la clase IfxParameter.
Nombre New() Descripcin Inicializa una nueva instancia de la clase IfxParameter.
3-422
Nombre New(String, Object)
Descripcin Inicializa una instancia nueva de la clase IfxParameter con el nombre del parmetro y un objeto que contiene un valor que debe pasarse como un parmetro (por ejemplo, otra instancia de IfxParameter o instancias de estructuras o clases de IBM.Data.IfxTypes). Inicializa una nueva instancia de la clase IfxParameter con el nombre del parmetro y el tipo de datos. Inicializa una nueva instancia de la clase IfxParameter con el nombre del parmetro, el tipo de datos y el ancho. Inicializa una nueva instancia de la clase IfxParameter con el nombre del parmetro, el tipo de datos, el ancho y el nombre de la columna de origen. Inicializa una nueva instancia de la clase IfxParameter con el nombre del parmetro, el tipo de datos, el ancho, el nombre de columna de origen, la direccin del parmetro, la precisin numrica y otras propiedades.
New(String, IfxType)
New(String, IfxType, Integer)
New(String, IfxType, Integer, String)
New(String, IfxType, Integer, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)
Ejemplo
[Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y visualiza el ParameterName. Nota: [Visual Basic, C#] Este ejemplo muestra cmo utilizar una de las versiones sobrecargadas del constructor de IfxParameter. Para obtener otros ejemplos que pudieran estar disponibles, consulte los temas de sobrecarga individuales.
Visual Basic] Public Sub CreateIfxParameter() Dim myParameter As New IfxParameter("Description", IfxType.VarChar, _ 11, ParameterDirection.Output, True, 0, 0, "Description", DataRowVersion.Current, _ "garden hose") MessageBox.Show(myParameter.ToString()) End Sub CreateIfxParameter [C#] public void CreateIfxParameter() { IfxParameter myParameter = new IfxParameter("Description",IfxType.VarChar, 11,ParameterDirection.Output,true,0,0,"Description", DataRowVersion.Current,"garden hose"); MessageBox.Show(myParameter.ToString()); }
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter
3-423
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbDatAdp.cs DbDatAdp.vb Constructor de IfxParameter (): Inicializa una instancia nueva de la clase IfxParameter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New() [C#] public IfxParameter(); [C++] public: IfxParameter(); [JScript] public function IfxParameter();
Comentarios El constructor base inicializa todos los campos en sus valores por omisin. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y establece algunas de las propiedades del mismo.
Visual Basic] Public Sub CreateIfxParameter() Dim myParameter As New IfxParameter() myParameter.ParameterName = "Description" myParameter.IfxType = IfxType.VarChar myParameter.Direction = ParameterDirection.Output myParameter.Size = 88 End Sub CreateIfxParameter [C#] public void CreateIfxParameter() { IfxParameter myParameter = new IfxParameter(); myParameter.ParameterName = "Description"; myParameter.IfxType = IfxType.VarChar; myParameter.Direction = ParameterDirection.Output; myParameter.Size = 88; }
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter
3-424
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxParameter en la pgina 3-422 Inicializa una instancia nueva de la clase IfxParameter. Constructor de IfxParameter(String, Object): Inicializa una instancia nueva de la clase IfxParameter con el nombre del parmetro y un objeto que contiene un valor que debe pasarse como un parmetro (por ejemplo, otra instancia de IfxParameter o instancias de estructuras o clases de IBM.Data.IfxTypes). Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ ByVal name As String, _ ByVal value As Object _ ) [C#] public IfxParameter( string name, object value ); [C++] public: IfxParameter( String* name, Object* value ); [JScript] public function IfxParameter( name : String, value : Object );
Parmetros name value El nombre del parmetro.
Objeto que contiene un valor que debe pasarse como un parmetro (por ejemplo, otra instancia de IfxParameter o instancias de estructuras o clases de IBM.Data.IfxTypes). Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Constructor de IfxParameter en la pgina 3-422 Inicializa una instancia nueva de la clase IfxParameter. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Enumeracin IfxType en la pgina 3-714 Especifica el tipo de datos de un campo, una propiedad o un IfxParameter.
3-425
Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxParameter (String, IfxType): Inicializa una nueva instancia de la clase IfxParameter con el nombre de parmetro y el tipo de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ ByVal name As String, _ ByVal type As IfxType _ ) [C#] public IfxParameter( string name, IfxType type ); [C++] public: IfxParameter( String* name, IfxType type ); [JScript] public function IfxParameter( name : String, type : IfxType );
Parmetros name type El nombre del parmetro. Uno de los valores de enumeracin de IfxType.
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y establece algunas de las propiedades del mismo.
Visual Basic] Public Sub CreateIfxParameter() Dim myParameter As New IfxParameter("Description", IfxType.VarChar) myParameter.Direction = ParameterDirection.Output myParameter.Size = 88 End Sub CreateIfxParameter
3-426
[C#] public void CreateIfxParameter() { IfxParameter myParameter = new IfxParameter("Description",IfxType.VarChar); myParameter.Direction = ParameterDirection.Output; myParameter.Size = 88; }
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Constructor de IfxParameter en la pgina 3-422 Inicializa una instancia nueva de la clase IfxParameter. Enumeracin IfxType en la pgina 3-714 Especifica el tipo de datos de un campo, una propiedad o un IfxParameter. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbDatAdp.cs DbDatAdp.vb Constructor de IfxParameter (String, IfxType, Int32): Inicializa una nueva instancia de la clase IfxParameter con el nombre del parmetro, el tipo de datos y el ancho. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ ByVal name As String, _ ByVal type As IfxType , _ ByVal size As Integer _ ) [C#] public IfxParameter( string name, IfxType type, int size ); [C++] public: IfxParameter( String* name, IfxType type, int size );
3-427
[JScript] public function IfxParameter( name : String, type : IfxType , size : int );
Parmetros name type size El nombre del parmetro. Uno de los valores de enumeracin de IfxType. El ancho del parmetro.
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y establece algunas de las propiedades del mismo.
Visual Basic] Public Sub CreateIfxParameter() Dim myParameter As New IfxParameter("Description", IfxType.VarChar, 88) myParameter.Direction = ParameterDirection.Output End Sub CreateIfxParameter [C#] public void CreateIfxParameter() { IfxParameter myParameter = new IfxParameter("Description",IfxType.VarChar,88); myParameter.Direction = ParameterDirection.Output; }
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Constructor de IfxParameter en la pgina 3-422 Inicializa una instancia nueva de la clase IfxParameter. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbDatAdp.cs DbDatAdp.vb Constructor de IfxParameter (String, IfxType, Int32, String): Inicializa una nueva instancia de la clase IfxParameter con el nombre del parmetro, el tipo de datos, el ancho y el nombre de la columna de origen. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-428
Sintaxis
Visual Basic] Public Sub New( _ ByVal name As String, _ ByVal type As IfxType , _ ByVal size As Integer, _ ByVal sourcecolumn As String _ ) [C#] public IfxParameter( string name, IfxType type, int size, string sourcecolumn ); [C++] public: IfxParameter( String* name, IfxType type, int size, String* sourcecolumn ); [JScript] public function IfxParameter( name : String, type : IfxType , size : int, sourcecolumn : String );
Parmetros name type size El nombre del parmetro. Uno de los valores de enumeracin de IfxType. El ancho del parmetro.
sourcecolumn El nombre de la columna fuente. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y establece algunas de las propiedades del mismo.
Visual Basic] Public Sub CreateIfxParameter() Dim myParameter As New IfxParameter( "Description", IfxType.VarChar, 88, "Description") myParameter.Direction = ParameterDirection.Output End Sub CreateIfxParameter [C#] public void CreateIfxParameter() { IfxParameter myParameter = new IfxParameter("Description",IfxType.VarChar, 88,"Description"); myParameter.Direction = ParameterDirection.Output; }
Consulta
3-429
Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Constructor de IfxParameter en la pgina 3-422 Inicializa una instancia nueva de la clase IfxParameter. Enumeracin IfxType en la pgina 3-714 Especifica el tipo de datos de un campo, una propiedad o un IfxParameter. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbDatAdp.cs DbDatAdp.vb Constructor de IfxParameter (String, IfxType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object): Inicializa una nueva instancia de la clase IfxParameter con el nombre del parmetro, el tipo de datos, el ancho, el nombre de columna de origen, la direccin del parmetro, la precisin numrica y otras propiedades. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New( _ ByVal parameterName As String, _ ByVal IfxType As IfxType , _ ByVal size As Integer, _ ByVal parameterDirection As ParameterDirection, _ ByVal isNullable As Boolean, _ ByVal precision As Byte, _ ByVal scale As Byte, _ ByVal srcColumn As String, _ ByVal srcVersion As DataRowVersion, _ ByVal value As Object _ ) [C#] public IfxParameter( string parameterName, IfxType IfxType, int size, ParameterDirection parameterDirection, bool isNullable, byte precision, byte scale, string srcColumn, DataRowVersion srcVersion, object value );
3-430
[C++] public: IfxParameter( String* parameterName, IfxType IfxType, int size, ParameterDirection parameterDirection, bool isNullable, unsigned char precision, unsigned char scale, String* srcColumn, DataRowVersion srcVersion, Object* value ); [JScript] public function IfxParameter( parameterName : String, IfxType : IfxType , size : int, parameterDirection : ParameterDirection, isNullable : Boolean, precision : Byte, scale : Byte, srcColumn : String, srcVersion : DataRowVersion, value : Object );
Parmetros parameterName El nombre del parmetro. IfxType Uno de los valores de IfxType. size El ancho del parmetro.
parameterDirection Uno de los valores de System.Data.ParameterDirection. isNullable true si el valor del campo puede ser nulo; de lo contrario, false. precision El nmero total de dgitos a la izquierda y derecha de la coma decimal en los que se resuelve IfxParameterClassValue. scale Nmero total de posiciones decimales en las que se resuelve IfxParameterClassValue.
srcColumn El nombre de la columna fuente. srcVersion Uno de los valores de System.Data.DataRowVersion. value Objeto que contiene un valor que debe pasarse como un parmetro (por ejemplo, otra instancia de IfxParameter o instancias de estructuras o clases de IBM.Data.IfxTypes).
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y visualiza el ParameterName.
3-431
[Visual Basic] Public Sub CreateIfxParameter() Dim myParameter As New IfxParameter("Description", IfxType.VarChar, 11, ParameterDirection.Output, True, 0, 0, "Description", DataRowVersion.Current, "garden hose") MessageBox.Show(myParameter.ToString()) End Sub CreateIfxParameter [C#] public void CreateIfxParameter() { IfxParameter myParameter = new IfxParameter("Description",IfxType.VarChar, 11,ParameterDirection.Output,true,0,0,"Description", DataRowVersion.Current,"garden hose"); MessageBox.Show(myParameter.ToString()); }
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Constructor de IfxParameter en la pgina 3-422 Inicializa una instancia nueva de la clase IfxParameter. Enumeracin IfxType en la pgina 3-714 Especifica el tipo de datos de un campo, una propiedad o un IfxParameter. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbDatAdp.cs DbDatAdp.vb
Mtodos de IfxParameter
Los mtodos de la clase IfxParameter se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxParameter, consulte el tema Miembros de IfxParameter.
Mtodos pblicos
CreateObjRef (heredado de MarshalByRefObject) Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Sobrecargado. Determina si dos instancias de Object son iguales. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash.
3-432
GetLifetimeService (heredado de MarshalByRefObject) GetType (heredado de Object) InitializeLifetimeService (heredado de MarshalByRefObject) ResetDbType
Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el Type de la instancia actual. Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Alterado temporalmente. Restablece el tipo de datos asociado con esta instancia de IfxParameter. Alterado temporalmente. Obtiene una serie que contiene el ParameterName.
ToString
Mtodos protegidos
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameter.ICloneable.Clone: Este miembro da soporte a la infraestructura Microsoft(R) .NET Framework y no est diseado para utilizarlo directamente a partir del cdigo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Function Clone() As Object Implements ICloneable.Clone [C#] object ICloneable.Clone();
3-433
[C++] Object* ICloneable::Clone(); [JScript] function ICloneable.Clone() : Object;
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameter.ResetDbType: Restablece el tipo de datos asociado con esta instancia de IfxParameter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Sub ResetDbType [C#] public override void ResetDbType () [C++] public: virtual void ResetDbType () override [JScript] public override function ResetDbType ()
Comentarios Cuando se ejecuta un IfxCommand, pueden asignarse tipos de parmetros de forma explcita o permitir que el tipo de parmetro se determine de forma explcita en funcin del valor transferido al parmetro. Si se lleva a cabo una asignacin explcita del tipo de datos, una llamada a este mtodo restablecer el tipo de parmetro para un IfxParameter de forma que se base en el valor transferido al parmetro. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter
3-434
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameter.ToString: Obtiene una serie que contiene el ParameterName. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overrides Public Function ToString() As String [C#] public override string ToString(); [C++] public: String* ToString(); [JScript] public override function ToString() : String;
Valor de retorno Serie de caracteres que contiene ParameterName. Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxParameter
Las propiedades de la clase IfxParameter se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxParameter, consulte el tema Miembros de IfxParameter.
Propiedades pblicas
Obtiene o establece el IfxType del parmetro. IfxType IfxTypeOutput Determina si los valores del parmetro de slo salida asociados con el IfxParameter se devolvern como tipos de datos DB2 nativos (especialmente, clases y estructuras en el espacio de nombres IBM.Data.IfxTypes).
3-435
DbType Direction
Obtiene o establece el DbType del parmetro. Obtiene o establece un valor que indica si el parmetro es slo de entrada, slo de salida, bidireccional o un parmetro de valor de retorno de procedimiento almacenado. Obtiene o establece un valor que indica si el parmetro acepta valores nulos. Obtiene o establece el nombre del IfxParameter. Obtiene o establece el nmero mximo de dgitos utilizados para representar la propiedad Value. Obtiene o establece el nmero de posiciones decimales en los que Value se resuelve. Obtiene o establece el tamao mximo, en bytes, de los datos dentro de la columna. Obtiene o establece el nombre de la columna fuente correlacionada con el DataSet y utilizada para cargar y devolver el Value. Obtiene o establece un valor que indica si la columna puede contener nulos. Obtiene o establece la DataRowVersion que se va a utilizar al cargar Value. Obtiene o establece el valor del parmetro.
IsNullable ParameterName Precision
Scale Size SourceColumn
SourceColumnNullMapping SourceVersion Value
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameter.IfxTypeOutput: Determina si los valores del parmetro de slo salida asociados con el IfxParameter se devolvern como tipos de datos DB2 nativos (especialmente, clases y estructuras en el espacio de nombres IBM.Data.IfxTypes). Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Public Overrides Property IfxTypeOutput As Boolean [C#] public override bool IfxTypeOutput { get; set; }
3-436
[C++] public: virtual property bool IfxTypeOutput { bool get () override; void set (bool value) override; }
Valor de la propiedad Si el parmetro est establecido en slo salida, este valor booleano determina si los valores de las columnas se devolvern como instancias del tipo de datos DB2 nativo (por ejemplo, IfxString). Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameter.IfxType: Obtiene o establece el IfxType del parmetro. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property IfxType As IfxType [C#] public IfxType IfxType {get; set;} [C++] public: __property IfxType get_IfxType(); public: __property void set_IfxType(IfxType ); [JScript] public function get IfxType() : IfxType ; public function set IfxType(IfxType );
Valor de la propiedad Valor de IfxType que es el IfxType del parmetro. El valor por omisin es VarChar.
3-437
Comentarios Las propiedades IfxType y DbType properties estn enlazadas. Por lo tanto, al definir DbType el IfxType cambia a un IfxType que le d soporte. Del mismo modo, al definir el IfxType, el DbType cambia a un DbType que le d soporte. Para obtener una lista de los tipos de datos soportados, consulte el miembro IfxType apropiado. Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Enumeracin IfxType en la pgina 3-714 Especifica el tipo de datos de un campo, una propiedad o un IfxParameter. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameter.DbType: Obtiene o establece el DbType del parmetro. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property DbType As DbType Implements IDataParameter.DbType [C#] public DbType DbType {get; set;} [C++] public: __property DbType get_DbType(); public: __property void set_DbType(DbType); [JScript] public function get DbType() : DbType; public function set DbType(DbType);
Implementa: IDataParameter.DbType Valor de la propiedad Uno de los valores de System.Data.DbType. El valor por omisin es String.
3-438
Excepciones
Tipo de excepcin ArgumentOutOfRangeException Condicin La propiedad no se ha establecido en un DbType vlido.
Comentarios Las propiedades IfxType y DbType estn enlazadas. Por lo tanto, al definir el IfxType el DbType cambia a un DbType que le d soporte. Del mismo modo, al definir el DbType, el IfxType cambia a un IfxType que le d soporte. Para obtener una lista de los tipos de datos soportados, consulte el miembro DbType correspondiente. Nota: IBM Data Server Provider for .NET no da soporte a Object. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y establece algunas de las propiedades del mismo, incluida la propiedad DbType.
Visual Basic] Public Sub CreateIfxParameter() Dim myParameter As New IfxParameter() myParameter.ParameterName = "Description" myParameter.DbType = DbType.String myParameter.Direction = ParameterDirection.Output myParameter.Size = 88 End Sub CreateIfxParameter [C#] public void CreateIfxParameter() { IfxParameter myParameter = new IfxParameter(); myParameter.ParameterName = "Description"; myParameter.DbType = DbType.String; myParameter.Direction = ParameterDirection.Output; myParameter.Size = 88; }
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Enumeracin IfxType en la pgina 3-714 Especifica el tipo de datos de un campo, una propiedad o un IfxParameter. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameter.Direction:
3-439
Obtiene o establece un valor que indica si el parmetro es slo de entrada, slo de salida, bidireccional o un parmetro de valor de retorno de procedimiento almacenado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Direction As ParameterDirection Implements _ IDataParameter.Direction [C#] public ParameterDirection Direction {get; set;} [C++] public: __property ParameterDirection get_Direction(); public: __property void set_Direction(ParameterDirection); [JScript] public function get Direction() : ParameterDirection; public function set Direction(ParameterDirection);
Implementa: IDataParameter.Direction Valor de la propiedad Uno de los valores de System.Data.ParameterDirection. El valor por omisin es Input. Excepciones
Tipo de excepcin ArgumentException Condicin La propiedad no se ha establecido en uno de los valores vlidos de ParameterDirection.
Comentarios Si el valor de ParameterDirection es Output y la ejecucin del IfxCommand asociado no devuelve ningn valor, IfxParameter contendr un valor nulo. Los valores nulos se manejan utilizando la clase DBNull. Los parmetros Output, InputOut y ReturnValue se actualizan despus de ejecutar IfxCommand . Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y establece algunas de las propiedades del mismo.
Visual Basic] Public Sub CreateIfxParameter() Dim myParameter As New IfxParameter("Description", IfxType.VarChar, 88) myParameter.Direction = ParameterDirection.Output End Sub CreateIfxParameter [C#] public void CreateIfxParameter() { IfxParameter myParameter = new IfxParameter("Description", IfxType.VarChar, 88); myParameter.Direction = ParameterDirection.Output; }
3-440
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos SpClient.cs SpClient.vb SpReturn.cs SpReturn.vb Propiedad IfxParameter.IsNullable: Obtiene o establece un valor que indica si el parmetro acepta valores nulos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property IsNullable As Boolean Implements _ IDataParameter.IsNullable [C#] public bool IsNullable {get; set;} [C++] public: __property bool get_IsNullable(); public: __property void set_IsNullable(bool); [JScript] public function get IsNullable() : Boolean; public function set IsNullable(Boolean);
Implementa: IDataParameter.IsNullable Valor de la propiedad true si se aceptan valores nulos; de lo contrario, false. El valor por omisin es false. Comentarios Los valores nulos se manejan utilizando la clase System.DBNull. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y establece algunas de las propiedades del mismo.
3-441
Visual Basic] Public Sub CreateIfxParameter() Dim myParameter As New IfxParameter("Description", IfxType.VarChar, 88) myParameter.IsNullable = True myParameter.Direction = ParameterDirection.Output End Sub CreateIfxParameter [C#] public void CreateIfxParameter() { IfxParameter myParameter = new IfxParameter("Description", IfxType.VarChar, 88); myParameter.IsNullable = true; myParameter.Direction = ParameterDirection.Output; }
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameter.ParameterName: Obtiene o establece el nombre del IfxParameter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property ParameterName As String Implements _ IDataParameter.ParameterName [C#] public string ParameterName {get; set;} [C++] public: __property String* get_ParameterName(); public: __property void set_ParameterName(String*); [JScript] public function get ParameterName() : String; public function set ParameterName(String);
Implementa: IDataParameter.ParameterName Valor de la propiedad Nombre del IfxParameter. El valor por omisin es una serie de caracteres vaca (). Comentarios Cuando se utilizan parmetros con nombre en unaIfxParameterCollection, debe definirse ParameterName antes de ejecutar un IfxCommand que dependa de los
3-442
parmetros. Si se utilizan parmetros posicionados, se ignorar cualquier nombre de parmetro durante el enlace de objetos de parmetro. Los nombres de parmetro son sensibles a may/min, se les debe anteponer el smbolo @ y pueden estar constituidos por cualquier smbolo que se pueda utilizar como parte de una sentencia de SQL. Para obtener detalles relativos a los identificadores de SQL, consulte el tema Identificadores de la documentacin de DB2. En los casos en que el smbolo @ se utiliza como prefijo en un identificador de SQL para otros objetos de base de datos, estos tienen que estar delimitados o bien se tiene que desactivar el soporte de parmetros con nombre y slo se pueden utilizar parmetros posicionados. Para inhabilitar la utilizacin de parmetros con nombre, establezca en 0 la palabra clave db2netnamedparam de CLI. Puede hacer esto aadiendo la lnea siguiente al archivo db2cli.ini situado en el directorio %IfxPATH%: IfxNETNAMEDPARAM=0 Ejemplo [Visual Basic, C#] En el ejemplo siguiente se presupone que la base de datos tiene una tabla denominada MyTable y un procedimiento almacenado denominado MyProc definido de la forma siguiente:
create table MyTable (col1 int, col2 double, col3 decimal) create proc MyProc (p1 int, p2 double, p3 decimal) language sql LABEL1: begin insert into MyTable values (p1, p2, p3); end
[Visual Basic, C#] El ejemplo crea parmetros y llama al procedimiento almacenado MyProc.
[Visual Basic] Public Sub CallMyProc() Create and open IfxConnection myConnection. Dim myCommand As IfxCommand = myConnection.CreateCommand() myCommand.CommandText = "call MyProc(@param1,@param2,@param3)" Dim p1 As New IfxParameter() p1.ParameterName = "@param1" p1.IfxType = IfxType.Integer p1.Value = 1 Dim p2 As New IfxParameter() p2.ParameterName = "@param2" p2.IfxType = IfxType.Double p2.Value = 2 Dim p3 = new IfxParameter() p3.ParameterName = "@param3" p3.IfxType = IfxType.Decimal p3.Value = 3 // Add parameters to the myCommand.Parameters collection // and then execute the command. End Sub CallMyProc [C#] public void CallMyProc() { // Create and open IfxConnection myConnection. IfxCommand myCommand = myConnection.CreateCommand(); myCommand.CommandText = "call MyProc(@param1,@param2,@param3)"; Dim p1 As New IfxParameter();
3-443
p1.ParameterName = "@param1"; p1.IfxType = IfxType.Integer; p1.Value = 1; Dim p2 As New IfxParameter(); p2.ParameterName = "@param2"; p2.IfxType = IfxType.Double; p2.Value = 2; Dim p3 = new IfxParameter(); p3.ParameterName = "@param3"; p3.IfxType = IfxType.Decimal; p3.Value = 3; // Add parameters to the myCommand.Parameters collection // and then execute the command. }
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameter.Precision: Obtiene o establece el nmero mximo de dgitos utilizados para representar la propiedad Value. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Precision As Byte Implements _ IDbDataParameter.Precision [C#] public byte Precision {get; set;} [C++] public: __property unsigned char get_Precision(); public: __property void set_Precision(unsigned char); [JScript] public function get Precision() : Byte; public function set Precision(Byte);
Implementa: IDbDataParameter.Precision Valor de la propiedad Nmero mximo de dgitos utilizados para representar la propiedad Value. El valor por omisin es 0.
3-444
Comentarios La propiedad Precision slo se utiliza para parmetros de entrada decimales y numricos. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y establece algunas de las propiedades del mismo.
Visual Basic] Public Sub CreateIfxParameter() Dim myParameter As New IfxParameter("Price", IfxType.Decimal) myParameter.Value = 3.1416 myParameter.Precision = 8 myParameter.Scale = 4 End Sub CreateIfxParameter [C#] public void CreateIfxParameter() { IfxParameter myParameter = new IfxParameter("Price", IfxType.Decimal); myParameter.Value = 3.1416; myParameter.Precision = 8; myParameter.Scale = 4; }
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameter.Scale Obtiene o establece el nmero de posiciones decimales en los que se resuelve Value. Propiedad IfxParameter.Size en la pgina 3-446 Obtiene o establece el tamao mximo, en bytes, de los datos dentro de la columna. Propiedad IfxParameter.Scale: Obtiene o establece el nmero de posiciones decimales en los que se resuelve Value. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Scale As Byte [C#] public byte Scale {get; set;} Implements IDbDataParameter.Scale
3-445
[C++] public: __property unsigned char get_Scale(); public: __property void set_Scale(unsigned char); [JScript] public function get Scale() : Byte; public function set Scale(Byte);
Implementa: IDbDataParameter.Scale Valor de la propiedad Nmero de posiciones decimales en las que se resuelve Value. El valor por omisin es 0. Comentarios La propiedad Scale slo se utiliza para parmetros de entrada decimales y numricos. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y establece algunas de las propiedades del mismo.
Visual Basic] Public Sub CreateIfxParameter() Dim myParameter As New IfxParameter("Price", IfxType.Decimal) myParameter.Value = 3.1416 myParameter.Precision = 8 myParameter.Scale = 4 End Sub CreateIfxParameter [C#] public void CreateIfxParameter() { IfxParameter myParameter = new IfxParameter("Price", IfxType.Decimal); myParameter.Value = 3.1416; myParameter.Precision = 8; myParameter.Scale = 4; }
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameter.Precision en la pgina 3-444 Obtiene o establece el nmero mximo de dgitos utilizados para representar la propiedad Value. Propiedad IfxParameter.Size Obtiene o establece el tamao mximo, en bytes, de los datos dentro de la columna. Propiedad IfxParameter.Size:
3-446
Obtiene o establece el tamao mximo, en bytes, de los datos dentro de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Size As Integer Implements IDbDataParameter.Size [C#] public int Size {get; set;} [C++] public: __property int get_Size(); public: __property void set_Size(int); [JScript] public function get Size() : int; public function set Size(int);
Implementa: IDbDataParameter.Size Valor de la propiedad El tamao mximo de los datos que se van a transmitir al servidor. Comentarios La propiedad Size se utiliza para tipos binarios y de serie. Para los tipos de datos de longitud variable, la propiedad Size describe la cantidad mxima de datos que se deben transmitir al servidor. Por ejemplo, para el valor de una serie, se podra utilizar la propiedad Size para limitar la cantidad de datos enviados al servidor a los primeros cien bytes. Para los tipos de datos no de serie y los datos de serie ANSI, la propiedad Size hace referencia al nmero de bytes. Para los datos de serie Unicode, la propiedad Size hace referencia al nmero de caracteres. El recuento de series no incluye el carcter de finalizacin. Para la salida, bidireccional (entsal) y valores de retorno, debe establecer el valor de Size. Esto no es necesario para los parmetros de entrada. Si no se establecen explcitamente los parmetros de entrada, el valor de Size se deduce del tamao real del valor de parmetro especificado. Para los tipos de datos de ancho fijo, el valor de Size se pasa por alto. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y establece algunas de las propiedades del mismo.
Visual Basic] Public Sub CreateIfxParameter() Dim myValue As String = "12 foot scarf - multiple colors, one previous owner" Dim myParameter As New IfxParameter("Description", IfxType.VarChar) myParameter.Direction = ParameterDirection.Input myParameter.Size = myValue.Length myParameter.Value = myValue
3-447
End Sub CreateAdoParameter [C#] public void CreateIfxParameter() { string myValue = "12 foot scarf - multiple colors, one previous owner"; IfxParameter myParameter = new IfxParameter("Description", IfxType.VarChar); myParameter.Direction = ParameterDirection.Input; myParameter.Size = myValue.Length; myParameter.Value = myValue; }
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameter.SourceColumnNullMapping: Obtiene o establece un valor que indica si la columna puede contener nulos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Property SourceColumnNullMapping As Boolean [C#] public override bool SourceColumnNullMapping { get; set; } [C++] public: virtual property bool SourceColumnNullMapping { bool get () override; void set (bool value) override; } [JScript] public override function get SourceColumnNullMapping () : boolean public override function set SourceColumnNullMapping (value : boolean)
Valor de la propiedad Obtiene o establece un valor boolenano que indica si la columna puede contener nulos. true indica que la columna puede contener nulos. false indica que la columna no puede contener nulos. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta
3-448
Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameter.SourceColumn: Obtiene o establece el nombre de la columna fuente correlacionada con el DataSet y utilizada para cargar y devolver el Value. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property SourceColumn As String Implements _ IDataParameter.SourceColumn [C#] public string SourceColumn {get; set;} [C++] public: __property String* get_SourceColumn(); public: __property void set_SourceColumn(String*); [JScript] public function get SourceColumn() : String; public function set SourceColumn(String);
Implementa: IDataParameter.SourceColumn Valor de la propiedad Nombre de la columna fuente que se utilizar para definir el valor de este parmetro. El valor por omisin es una serie de caracteres vaca (). Comentarios Cuando el valor de SourceColumn es distinto de una serie de caracteres vaca, el valor del parmetro se obtiene de la columna cuyo nombre es SourceColumn. Si el valor de Direction es Input, el valor del parmetro se obtiene del DataSet. Si el valor de Direction es Output, el valor del parmetro se toma de la base de datos. Cuando Direction es InputOutput se trata de una combinacin de ambos casos. Ejemplo [Visual Basic, C#] En el ejemplo siguiente se presupone que la base de datos tiene una tabla denominada MyTable y un procedimiento almacenado denominado MyProc definido de la forma siguiente:
create table MyTable (col1 int, col2 double, col3 timestamp) create proc MyProc (p1 int, p2 double, p3 timestamp OUT) language sql LABEL1: begin insert into MyTable (col1, col2) values (p1, p2); end
3-449
[Visual Basic, C#] El ejemplo crea parmetros y llama al procedimiento almacenado MyProc.
[Visual Basic] Public Sub CallMyProc() Create and open IfxConnection myConnection. Dim myCommand As IfxCommand = myConnection.CreateCommand() myCommand.CommandText = "{ call MyProc(?,?,?) }" Dim p1 As New IfxParameter("Name1", IfxType.Integer) p1.Value = 1 p1.Direction = ParameterDirection.Input Dim p2 As New IfxParameter("Name2", IfxType.Double) p2.Value = 2 p2.Direction = ParameterDirection.Input Dim p3 As NewIfxParameter("Name3", IfxType.Decimal) p3.SourceColumn = "col3" p3.Direction = ParameterDirection.Output // Add parameters to the myCommand.Parameters collection // in the order in which they were created and then execute the command. End Sub CallMyProc [C#] public void CallMyProc() { // Crear y abrir IfxConnection myConnection. IfxCommand myCommand = myConnection.CreateCommand(); myCommand.CommandText = "call MyProc(?,?,?)"; IfxParameter p1 = new IfxParameter("Name1", IfxType.Integer); p1.Value = 1; p1.Direction = ParameterDirection.Input; IfxParameter p2 = new IfxParameter("Name2", IfxType.Double); p2.Value = 2; p2.Direction = ParameterDirection.Input; IfxParameter p3 = new IfxParameter("Name3", IfxType.Decimal); p3.SourceColumn = "col3"; p3.Direction = ParameterDirection.Output; // Aadir parmetros a la coleccin myCommand.Parameters // en el orden en que fueron creados y ejecutar el mandato. }
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameter.SourceVersion: Obtiene o establece la DataRowVersion que se debe utilizar al cargar Value. Espacio de nombres: IBM.Data.Informix
3-450

Visual Basic] Public Property SourceVersion As DataRowVersion Implements _ IDataParameter.SourceVersion [C#] public DataRowVersion SourceVersion {get; set;} [C++] public: __property DataRowVersion get_SourceVersion(); public: __property void set_SourceVersion(DataRowVersion); [JScript] public function get SourceVersion() : DataRowVersion; public function set SourceVersion(DataRowVersion);
Implementa: IDataParameter.SourceVersion Valor de la propiedad Uno de los valores de System.Data.DataRowVersion. El valor por omisin es Current. Excepciones
Tipo de excepcin ArgumentException Condicin La propiedad no se ha establecido en uno de los valores de DataRowVersion.
Comentarios IfxDataAdapter.UpdateCommand utiliza SourceVersion durante una operacin Update para determinar si el valor del parmetro est establecido en Current o Original. Esto permite actualizar claves primarias. IfxDataAdapter.InsertCommand yIfxDataAdapter.DeleteCommand no tienen en cuenta esta propiedad. El valor de esta propiedad es la versin de la DataRow utilizada por la propiedad Item (indexador DataRow) o por el mtodo GetChildRows del objeto DataRow. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y establece algunas de las propiedades del mismo.
Visual Basic] Public Sub CreateIfxParameter() Dim myParameter As New IfxParameter("Description", IfxType.VarChar, 88) myParameter.SourceColumn = "Description" myParameter.SourceVersion = DataRowVersion.Current End Sub CreateIfxParameter [C#] public void CreateIfxParameter() { IfxParameter myParameter = new IfxParameter("Description", IfxType.VarChar, 88); myParameter.SourceColumn = "Description"; myParameter.SourceVersion = DataRowVersion.Current; }
Consulta
3-451
Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbDatAdp.cs DbDatAdp.vb Propiedad IfxParameter.Value: Obtiene o establece el valor del parmetro. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Value As Object Implements IDataParameter.Value [C#] public object Value {get; set;} [C++] public: __property Object* get_Value(); public: __property void set_Value(Object*); [JScript] public function get Value() : Object; public function set Value(Object);
Implementa: IDataParameter.Value Valor de la propiedad Un Object que es el valor del parmetro. El valor por omisin es nulo. Comentarios Para los parmetros de entrada, el valor est vinculado al IfxCommand que se enva al servidor. Para los parmetros de salida y de valor de retorno, el valor se define al concluir IfxCommand. Al enviar un valor de parmetro nulo al servidor, el usuario puede especificar DBNull o nulo. Si la aplicacin especifica el tipo de base de datos, el valor de vinculacin se convierte a ese tipo cuando el proveedor enva los datos al servidor. El proveedor intenta convertir cualquier tipo de valor. Puede que se produzcan errores de conversin si el tipo especificado no es compatible con el valor.
3-452
Las propiedades DbType y IfxType pueden inferirse estableciendo Value. Si es aplicable, el tamao, la precisin y la escala tambin se deducirn a partir de Value. El mtodo DataAdapter.Update altera temporalmente la propiedadValue. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxParameter y establece algunas de las propiedades del mismo.
Visual Basic] Public Sub CreateIfxParameter() Dim myParameter As New IfxParameter("Description", IfxType.VarChar, 88) myParameter.Value = "garden hose" End Sub CreateIfxParameter [C#] public void CreateIfxParameter() { IfxParameter myParameter = new IfxParameter("Description", IfxType.VarChar, 88); myParameter.Value = "garden hose"; }
Consulta Clase IfxParameter en la pgina 3-418 Representa un parmetro de un IfxCommand y, opcionalmente, su correlacin con una DataColumn. Miembros de IfxParameter en la pgina 3-420 Miembros de la clase Visin general de IfxParameter Propiedad IfxParameter.IfxType en la pgina 3-437 Obtiene o establece el IfxType del parmetro. Propiedad IfxParameter.DbType en la pgina 3-438 Obtiene o establece el DbType del parmetro. Enumeracin IfxType en la pgina 3-714 Especifica el tipo de datos de un campo, una propiedad o un IfxParameter. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos SpClient.cs SpClient.vb
Clase IfxParameterCollection
Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-453

System.Object System.MarshalByRefObject IBM.Data.Informix.IfxParameterCollection

System.Object System.MarshalByRefObject System.Data.Common.DbParameterCollection IBM.Data.Informix.IfxParameterCollection

Visual Basic] NotInheritable Public Class IfxParameterCollection Inherits MarshalByRefObject Implements IDataParameterCollection, IList, ICollection, _ IEnumerable [C#] public sealed class IfxParameterCollection : MarshalByRefObject, IDataParameterCollection, IList, ICollection, IEnumerable [C++] public __gc __sealed class IfxParameterCollection : public MarshalByRefObject, IDataParameterCollection, IList, ICollection, IEnumerable [JScript] public class IfxParameterCollection extends MarshalByRefObject implements IDataParameterCollection, IList, ICollection, IEnumerable

Visual Basic] NotInheritable Public Class IfxParameterCollection Inherits DbParameterCollection Implements IDataParameterCollection, IList, ICollection, _ IEnumerable [C#] public sealed class IfxParameterCollection : DbParameterCollection, IDataParameterCollection, IList, ICollection, IEnumerable [C++] public __gc __sealed class IfxParameterCollection : public DbParameterCollection, IDataParameterCollection, IList, ICollection, IEnumerable [JScript] public class IfxParameterCollection extends DbParameterCollection implements IDataParameterCollection, IList, ICollection, IEnumerable
Excepciones
Tipo de excepcin IfxException Condicin Nmero de parmetros incorrecto. El nmero de parmetros de la coleccin debe ser igual al nmero de marcadores de posicin de parmetro dentro del texto del mandato.
3-454
Ejemplo
[Visual Basic, C#] En el ejemplo siguiente se presupone la existencia de una tabla denominada MyTable y un procedimiento almacenado denominado MyProcedure. Estos objetos se definen con las sentencias siguientes:
create table MyTable (column1 int) create procedure MyProcedure (p1 int ) language sql LABEL1: begin insert into MyTable values (p1); end
El ejemplo llama al procedimiento almacenado MyProcedure.

[Visual Basic] Public Sub AddIfxParameters() // Create myConnection and myCommand. myCommand.CommandText = "{call MyProcedure (?)}" myCommand.Parameters.Add("p1",IfxType.Integer).Value = 100 myCommand.ExecuteNonQuery() End Sub AddIfxParmetros [C#] public void AddIfxParameters() { // Create myConnection and myCommand. myCommand.CommandText = "{call MyProcedure (?)}"; myCommand.Parameters.Add("p1",IfxType.Integer).Value = 100; myCommand.ExecuteNonQuery(); }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxParameterCollection Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Miembros de IfxParameterCollection
Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection.
3-455
Propiedades pblicas
Count IsFixedSize IsReadOnly IsSynchronized this Obtiene el nmero de objetos IfxParameter de la coleccin. Obtiene un valor que indica si la IfxParameterCollection tiene un tamao fijo. Obtiene un valor que indica si la IfxParameterCollection es de slo lectura. Obtiene un valor que indica si la IfxParameterCollection est sincronizada. Sobrecargado. Obtiene o establece el IfxParameter con un atributo especificado. En C#, esta propiedad es el indexador para la clase IfxParameterCollection. SyncRoot Obtiene un objeto que puede utilizarse para sincronizar el acceso a la IfxParameterCollection.
Mtodos pblicos
Add AddRange Clear Contains CopyTo Sobrecargado. Obtiene un valor que indica si en la coleccin existe un objeto IfxParameter. Copia objetos IfxParameter de IfxParameterCollection en la matriz especificada. Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Sobrecargado. Determina si dos instancias de Object son iguales. Devuelve un enumerador que se repite en la IfxParameterCollection. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el Type de la instancia actual. GetType (heredado de Object) Sobrecargado. Aade el IfxParameter especificado a la coleccin. Alterado temporalmente. Aade una matriz de valores a la IfxParameterCollection. Elimina todos los elementos de la coleccin.
CreateObjRef (heredado de MarshalByRefObject)
Equals (heredado de Object) GetEnumerator GetHashCode (heredado de Object)
3-456
InitializeLifetimeService (heredado de MarshalByRefObject) Insert Remove RemoveAt ToString (heredado de Object)
Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Inserta un IfxParameter en la coleccin, en el ndice especificado. Elimina el IfxParameter especificado de la coleccin. Sobrecargado. Elimina el IfxParameter especificado de la coleccin. Devuelve una String que representa el Object actual.
Mtodos protegidos
Finalize (heredado de Object) Alterado temporalmente. Permite que un Object intente liberar recursos y realizar otras operaciones de limpieza antes de que el Object sea reclamado para la recopilacin de basura. En C# y Microsoft(R) Visual C++(R), los finalizadores se expresan utilizando sintaxis de destructor. GetParameter Sobrecargado. Devuelve el objeto DbParameter con el nombre especificado en la IfxParameterCollection. Crea una copia superficial del Object actual. MemberwiseClone (heredado de Object) SetParameter Sobrecargado. Establece el DbParameter especificado en el valor que se especifique.
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxParameterCollection
Los mtodos de la clase IfxParameterCollection se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxParameterCollection, consulte el tema Miembros de IfxParameterCollection.
Mtodos pblicos
Add Sobrecargado. Aade el IfxParameter especificado a la coleccin.
3-457
AddRange Clear Contains CopyTo
Alterado temporalmente. Aade una matriz de valores a la IfxParameterCollection. Elimina todos los elementos de la coleccin. Sobrecargado. Obtiene un valor que indica si en la coleccin existe un objeto IfxParameter. Copia objetos IfxParameter de IfxParameterCollection en la matriz especificada. Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Sobrecargado. Determina si dos instancias de Object son iguales. Devuelve un enumerador que se repite en la IfxParameterCollection. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el Type de la instancia actual.
CreateObjRef (heredado de MarshalByRefObject)
Equals (heredado de Object) GetEnumerator GetHashCode (heredado de Object)
GetLifetimeService (heredado de MarshalByRefObject) GetType (heredado de Object) InitializeLifetimeService (heredado de MarshalByRefObject) Insert Remove RemoveAt ToString (heredado de Object)
Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Inserta un IfxParameter en la coleccin, en el ndice especificado. Elimina el IfxParameter especificado de la coleccin. Sobrecargado. Elimina el IfxParameter especificado de la coleccin. Devuelve una String que representa el Object actual.
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.Add:
3-458
Aade el IfxParameter especificado a la coleccin. Lista de sobrecargas

Nombre Add(Object) As Integer Implements IList.Add Add(IfxParameter) As IfxParameter Add(String, Object) As IfxParameter Add(String, IfxType) As IfxParameter Descripcin Aade el IfxParameter especificado al IfxCommand. Aade el IfxParameter especificado a la IfxParameterCollection. Aade un IfxParameter al IfxCommand dado el nombre y el valor del parmetro. Aade un IfxParameter al IfxCommand dado el nombre y el tipo de datos del parmetro. Aade un IfxParameter al IfxCommand dado el nombre del parmetro, el tipo de datos y el ancho de columna. Aade un IfxParameter al IfxCommand dado el nombre del parmetro, el tipo de datos, el ancho de columna y el nombre de la columna de origen.
Add(String, IfxType, Integer) As IfxParameter Add(String, IfxType, Integer, String) As IfxParameter
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea un IfxCommand, una IfxParameterCollection para el mandato y aade una instancia de IfxParameter a la coleccin. Nota: [Visual Basic, C#] Este ejemplo muestra cmo utilizar una de las versiones sobrecargadas de Add. Para obtener otros ejemplos que pudieran estar disponibles, consulte los temas de sobrecarga individuales.
Visual Basic] Public Sub CreateIfxParamColl(myConn As IfxConnection) Dim myCommand As IfxCommand = New IfxCommand("SELECT * FROM EMPLOYEE WHERE EMPNO = ?", myConn) Dim myParamCollection As IfxParameterCollection = myCommand.Parameters Dim myNewParameter As IfxParameter = myParamCollection.Add("EMPNO", IfxType.VarChar, 6, "EMPNO") End Sub CreateIfxParamColl [C#] public void CreateIfxParamColl(IfxConnection myConn) { IfxCommand myCommand = new IfxCommand("SELECT * FROM EMPLOYEE WHERE EMPNO = ?", myConn); IfxParameterCollection myParamCollection = myCommand.Parameters; IfxParameter myNewParameter = myParamCollection.Add("EMPNO", IfxType.VarChar, 6, "EMPNO"); }
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos
3-459
DbDatAdp.cs DbDatAdp.vb SpClient.cs SpClient.vb Mtodo IfxParameterCollection.Add (Object): Aade el IfxParameter especificado a IfxCommand. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Overloads Public Function Add( _ ByVal value As Object _ ) As Integer Implements IList.Add [C#] public int Add( object value ); [C++] public: __sealed int Add( Object* value ); [JScript] public function Add( value : Object ) : int;
Implementa: IList.Add Parmetros value IfxParameter que debe aadirse a IfxCommand.
Valor de retorno Valor entero que representa el ndice del objeto IfxParameter especificado. Excepciones
Tipo de excepcin ArgumentException ArgumentNullException InvalidCastException Condicin El parmetro especificado por value ya existe. El parmetro value es nulo. El parmetro value no es un IfxParameter.
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet.
3-460
Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.Add en la pgina 3-458 Aade el IfxParameter especificado a la coleccin. Ejemplos DbDatAdp.cs DbDatAdp.vb Mtodo IfxParameterCollection.Add (IfxParameter): Aade el IfxParameter especificado a IfxCommand. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overloads Public Function Add( _ ByVal value As IfxParameter _ ) As IfxParameter [C#] public IfxParameter Add( IfxParameter value ); [C++] public: IfxParameter * Add( IfxParameter * value ); [JScript] public function Add( value : IfxParameter ) : IfxParameter ;
Parmetros value IfxParameter que debe aadirse a la coleccin.
Valor de retorno Objeto IfxParameter nuevo. Consulta
3-461
Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.Add en la pgina 3-458 Aade el IfxParameter especificado a la coleccin. Ejemplos DbDatAdp.cs DbDatAdp.vb Mtodo IfxParameterCollection.Add (String, Object): Aade un IfxParameter al IfxCommand dado el nombre y el valor del parmetro. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overloads Public Function Add( _ ByVal parameterName As String, _ ByVal value As Object _ ) As IfxParameter [C#] public IfxParameter Add( string parameterName, object value ); [C++] public: IfxParameter * Add( String* parameterName, Object* value ); [JScript] public function Add( parameterName : String, value : Object ) : IfxParameter ;
Parmetros parameterName El nombre del parmetro. value IfxParameter.Value del IfxParameter que debe aadirse a la coleccin.
3-462
Valor de retorno Objeto IfxParameter nuevo. Comentarios Cuando especifique un valor, utilice el parmetro value y defina explcitamente el IfxType tal como muestra este ejemplo para C#:
IfxCommand rComm = new IfxCommand(null, rConn); rComm.CommandText = "insert into mytable values (?)"; rComm.Parameters.Add("p1", DBNull.Value); rComm.Parameters["p1"].IfxType = IfxType.Integer;
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.Add en la pgina 3-458 Aade el IfxParameter especificado a la coleccin. Mtodo IfxParameterCollection.Add (String, IfxType): Aade un IfxParameter al IfxCommand dado el nombre y el tipo de datos del parmetro. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overloads Public Function Add( _ ByVal parameterName As String, _ ByVal IfxType As IfxType _ ) As IfxParameter [C#] public IfxParameter Add( string parameterName, IfxType IfxType ); [C++] public: IfxParameter * Add( String* parameterName, IfxType IfxType
3-463
); [JScript] public function Add( parameterName : String, IfxType : IfxType ) : IfxParameter ;
Parmetros parameterName El nombre del parmetro. IfxType Uno de los valores de IfxType. Valor de retorno Objeto IfxParameter nuevo. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxParameterCollection, aade una instancia de IfxParameter a la coleccin y devuelve una referencia al IfxParameter nuevo.
[Visual Basic] Public Function CreateIfxParamColl(myConn As IfxConnection) As IfxParameter Dim myCommand As IfxCommand = New IfxCommand( "SELECT * FROM EMPLOYEE WHERE EMPNO = ?", myConn) Dim myParamCollection As IfxParameterCollection = myCommand.Parameters Dim myParm As IfxParameter = myParamCollection.Add("EMPNO", IfxType.VarChar) Return myParm End Function CreateIfxParamColl [C#] public IfxParameter CreateIfxParamColl(IfxConnection myConn) { IfxCommand myCommand = new IfxCommand( "SELECT * FROM EMPLOYEE WHERE EMPNO = ?", myConn); IfxParameterCollection myParamCollection = myCommand.Parameters; IfxParameter myParm = myParamCollection.Add("EMPNO", IfxType.VarChar); return myParm; }
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.Add en la pgina 3-458 Aade el IfxParameter especificado a la coleccin. Ejemplos
3-464
DbDatAdp.cs DbDatAdp.vb SpClient.cs SpClient.vb Mtodo IfxParameterCollection.Add (String, IfxType, Int32): Aade un IfxParameter al IfxCommand dado el nombre del parmetro, el tipo de datos y el ancho de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overloads Public Function Add( _ ByVal parameterName As String, _ ByVal IfxType As IfxType , _ ByVal size As Integer _ ) As IfxParameter [C#] public IfxParameter Add( string parameterName, IfxType IfxType, int size ); [C++] public: IfxParameter * Add( String* parameterName, IfxType IfxType, int size ); [JScript] public function Add( parameterName : String, IfxType : IfxType , size : int ) : IfxParameter ;
Parmetros parameterName El nombre del parmetro. IfxType Uno de los valores de IfxType. size El ancho de la columna.
Valor de retorno Objeto IfxParameter nuevo.

3-465
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxParameterCollection, aade una instancia de IfxParameter a la coleccin y devuelve una referencia al IfxParameter nuevo.
[Visual Basic] Public Function CreateIfxParamColl(myConn As IfxConnection) As IfxParameter Dim myCommand As IfxCommand = New IfxCommand( "SELECT * FROM EMPLOYEE WHERE EMPNO = ?", myConn) Dim myParamCollection As IfxParameterCollection = myCommand.Parameters Dim myNewParameter As IfxParameter = myParamCollection.Add( "EMPNO", IfxType.VarChar, 6) Return myParm End Function CreateIfxParamColl [C#] public IfxParameter CreateIfxParamColl(IfxConnection myConn) { IfxCommand myCommand = new IfxCommand( "SELECT * FROM EMPLOYEE WHERE EMPNO = ?", myConn); IfxParameterCollection myParamCollection = myCommand.Parameters; IfxParameter myNewParameter = myParamCollection.Add( "EMPNO", IfxType.VarChar, 6); return myParm; }
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.Add en la pgina 3-458 Aade el IfxParameter especificado a la coleccin. Ejemplos DbDatAdp.cs DbDatAdp.vb SpClient.cs SpClient.vb Mtodo IfxParameterCollection.Add (String, IfxType, Int32, String): Aade un IfxParameter al IfxCommand dado el nombre del parmetro, el tipo de datos, el ancho de la columna y el nombre de la columna de origen. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-466
Sintaxis
Visual Basic] Overloads Public Function Add( _ ByVal parameterName As String, _ ByVal IfxType As IfxType , _ ByVal size As Integer, _ ByVal sourceColumn As String _ ) As IfxParameter [C#] public IfxParameter Add( string parameterName, IfxType IfxType, int size, string sourceColumn ); [C++] public: IfxParameter * Add( String* parameterName, IfxType IfxType, int size, String* sourceColumn ); [JScript] public function Add( parameterName : String, IfxType : IfxType , size : int, sourceColumn : String ) : IfxParameter ;
Parmetros parameterName El nombre del parmetro. IfxType Uno de los valores de IfxType. size El ancho de la columna.
sourceColumn El nombre de la columna fuente. Valor de retorno Objeto IfxParameter nuevo. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxParameterCollection, aade una instancia de IfxParameter a la coleccin y devuelve una referencia al IfxParameter nuevo.
[Visual Basic] Public Function CreateIfxParamColl(myConn As IfxConnection) As IfxParameter Dim myCommand As IfxCommand = New IfxCommand( "SELECT * FROM EMPLOYEE WHERE EMPNO = ?", myConn)
3-467
Dim myParamCollection As IfxParameterCollection = myCommand.Parameters Dim myNewParameter As IfxParameter = myParamCollection.Add( "EMPNO", IfxType.Char, 6, "EMPNO") Return myParm End Function CreateIfxParamColl [C#] public IfxParameter CreateIfxParamColl(IfxConnection myConn) { IfxCommand myCommand = new IfxCommand( "SELECT * FROM EMPLOYEE WHERE EMPNO = ?", myConn); IfxParameterCollection myParamCollection = myCommand.Parameters; IfxParameter myNewParameter = myParamCollection.Add( "EMPNO", IfxType.Char, 6, "EMPNO"); return myParm; }
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.Add en la pgina 3-458 Aade el IfxParameter especificado a la coleccin. Ejemplos DbDatAdp.cs DbDatAdp.vb Mtodo IfxParameterCollection.AddRange: Aade una matriz de valores a la IfxParameterCollection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Sub AddRange ( values As Array ) [C#] public override void AddRange ( Array values ) [C++] public: virtual void AddRange ( Array^ values ) override [JScript] public override function AddRange ( values : Array )
Parmetros values Matriz de valores que se debe aadir a la IfxParameterCollection.
3-468
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.Clear: Elimina todos los elementos de la coleccin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Public Sub Clear() Implements IList.Clear [C#] public void Clear(); [C++] public: __sealed void Clear(); [JScript] public function Clear();
Implementa: IList.Clear Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxParameterCollection, aade instancias de IfxParameter a la coleccin, muestra los nombres de sus objetos IfxParameter y borra la coleccin.
Visual Basic] Public Sub CreateIfxParamColl(myCommand As IfxCommand) Dim myParamCollection As IfxParameterCollection = myCommand.Parameters myParamCollection.Add("EMPNO", IfxType.Char) myParamCollection.Add("PHOTO_FORMAT", IfxType.VarChar) myParamCollection.Add("PICTURE", IfxType.Blob) Dim myParamNames As String = "" Dim i As Integer For i = 0 To myParamCollection.Count - 1 myParamNames += myParamCollection(i).ToString() + ControlChars.Cr Next i MessageBox.Show(myParamNames) myParamCollection.Clear() MessageBox.Show(myParamCollection.Count) End Sub CreateIfxParamColl
3-469
[C#] public void CreateIfxParamColl(IfxCommand myCommand) { IfxParameterCollection myParamCollection = myCommand.Parameters; myParamCollection.Add("EMPNO", IfxType.Char); myParamCollection.Add("PHOTO_FORMAT", IfxType.VarChar); myParamCollection.Add("PICTURE", IfxType.Blob); string myParamNames = ""; for (int i=0; i < myParamCollection.Count; i++) myParamNames += myParamCollection[i].ToString() + "\n"; MessageBox.Show(myParamNames); myParamCollection.Clear(); MessageBox.Show(myParamCollection.Count) }
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.Contains: Obtiene un valor que indica si en la coleccin existe un objeto IfxParameter. Lista de sobrecargas
Nombre Contains(Object) As Boolean Implements IList.Contains Contains(String) As Boolean Implements IDataParameterCollection.Contains Descripcin Obtiene un valor que indica si en la coleccin existe un objeto IfxParameter. Obtiene un valor que indica si en la coleccin existe un objeto IfxParameter con el nombre de parmetro especificado.
Ejemplo [Visual Basic, C#] El ejemplo siguiente busca un IfxParameter con un IfxParameter.ParameterName determinado contenido en una IfxParameterCollection. Si el parmetro existe, el ejemplo visualiza el nombre y el ndice del parmetro. Si el parmetro no existe, el ejemplo muestra un error. En este ejemplo se supone que ya se ha creado la IfxParameterCollection. Nota: [Visual Basic, C#] Este ejemplo muestra cmo utilizar una de las versiones sobrecargadas de Contains. Para obtener otros ejemplos que pudieran estar disponibles, consulte los temas de sobrecarga individuales.
[Visual Basic] Public Sub SearchIfxParams() ... create IfxParameterCollection myParameters ... If Not myParameters.Contains("Description") Then
3-470
MessageBox.Show("ERROR: no such parameter in the collection") Else MessageBox.Show("Name: " & myParameters("Description").ToString() & _ "Index: " & myParameters.IndexOf("Description").ToString()) End If End Sub SearchIfxParams [C#] public // // // if void SearchIfxParams() { ... create IfxParameterCollection myParameters ... (!myParameters.Contains("Description")) MessageBox.Show("ERROR: no such parameter in the collection"); else MessageBox.Show("Name: " + myParameters["Description"].ToString() + "Index: " + myParameters.IndexOf("Description").ToString());
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.Contains (Object): Obtiene un valor que indica si en la coleccin existe un objeto IfxParameter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Overloads Public Function Contains( _ ByVal value As Object _ ) As Boolean Implements IList.Contains [C#] public bool Contains( object value ); [C++] public: __sealed bool Contains( Object* value ); [JScript] public function Contains( value : Object ) : Boolean;
Implementa: IList.Contains
3-471
Parmetros value Valor del objeto IfxParameter que debe buscarse.
Valor de retorno true si la coleccin contiene el IfxParameter ; de lo contrario, false. Excepciones

Tipo de excepcin ArgumentNullException InvalidCastException Condicin El parmetro value es nulo. El parmetro value no era un IfxParameter.
Ejemplo [Visual Basic, C#] El ejemplo siguiente busca un IfxParameter contenido en una IfxParameterCollection. Si el parmetro existe, el ejemplo visualiza el ndice del parmetro. Si el parmetro no existe, el ejemplo muestra un error. En este ejemplo se supone que ya se ha creado la IfxParameterCollection.
Visual Basic] Public Sub SearchIfxParams() ... create IfxParameterCollection myParameters and IfxParameter myNewParam ... If Not myParameters.Contains(CType(myNewParam, Object)) Then MessageBox.Show("ERROR: no such parameter in the collection") Else MessageBox.Show("match on parameter #" & myParameters.IndexOf(CType(myNewParam, Object)).ToString()) End If End Sub SearchIfxParams [C#] public // // // if void SearchIfxParams() { ... create IfxParameterCollection myParameters and IfxParameter myNewParam ... (!myParameters.Contains((Object) myNewParam)) MessageBox.Show("ERROR: no such parameter in the collection"); else MessageBox.Show("match on parameter #" + myParameters.IndexOf((Object) myNewParam).ToString());
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.Contains en la pgina 3-470 Obtiene un valor que indica si en la coleccin existe un objeto IfxParameter.
3-472
Mtodo IfxParameterCollection.Contains (String): Obtiene un valor que indica si en la coleccin existe un objeto IfxParameter con el nombre de parmetro especificado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Overloads Public Function Contains( _ ByVal value As String _ ) As Boolean Implements IDataParameterCollection.Contains [C#] public bool Contains( string value ); [C++] public: __sealed bool Contains( String* value ); [JScript] public function Contains( value : String ) : Boolean;
Implementa: IDataParameterCollection.Contains Parmetros value Nombre del objeto IfxParameter que debe buscarse.
Valor de retorno true si la coleccin contiene el parmetro; de lo contrario, false. Ejemplo [Visual Basic, C#] El ejemplo siguiente busca un IfxParameter con un IfxParameter.ParameterName determinado contenido en una IfxParameterCollection. Si el parmetro existe, el ejemplo visualiza el nombre y el ndice del parmetro. Si el parmetro no existe, el ejemplo muestra un error. En este ejemplo se supone que ya se ha creado la IfxParameterCollection.
Visual Basic] Public Sub SearchIfxParams() ... create IfxParameterCollection myParameters ... If Not myParameters.Contains("Description") Then MessageBox.Show("ERROR: no such parameter in the collection") Else MessageBox.Show("Name: " & myParameters("Description").ToString() & _ "Index: " & myParameters.IndexOf("Description").ToString()) End If End Sub SearchIfxParams [C#] public void SearchIfxParams() { // ...
3-473
// create IfxParameterCollection myParameters // ... if (!myParameters.Contains("Description")) MessageBox.Show("ERROR: no such parameter in the collection"); else MessageBox.Show("Name: " + myParameters["Description"].ToString() + "Index: " + myParameters.IndexOf("Description").ToString()); }
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.Contains en la pgina 3-470 Obtiene un valor que indica si en la coleccin existe un objeto IfxParameter. Mtodo IfxParameterCollection.CopyTo: Copia objetos IfxParameter de IfxParameterCollection en la matriz especificada. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Public Sub CopyTo( _ ByVal array As Array, _ ByVal index As Integer _ ) Implements ICollection.CopyTo [C#] public void CopyTo( Array array, int index ); [C++] public: __sealed void CopyTo( Array* array, int index ); [JScript] public function CopyTo( array : Array, index : int );
Implementa: ICollection.CopyTo Parmetros array La matriz de destino en la que deben copiarse los objetos IfxParameter.
3-474
index
El ndice de inicio de la matriz de destino.
Ejemplo [Visual Basic, C#] El ejemplo siguiente exporta la IfxParameterCollection a una matriz de objetos IfxParameter, dobla el tamao de la matriz utilizando CopyTo y devuelve la coleccin. A continuacin, borra la coleccin y devuelve true si los parmetros ya no so permanentes. En este ejemplo se supone que ya se ha creado la IfxParameterCollection.
[Visual Basic] Public Function DoubleYourParams() As Boolean ... create IfxParameterCollection myParameters ... Dim myParamArray(2 * myParameters.Count - 1) As IfxParameter myParameters.CopyTo(myParamArray, 0) myParameters.CopyTo(myParamArray, myParameters.Count) myParameters.Clear() Return True End Function DoubleYourParams [C#] public bool DoubleYourParams() { // ... // create IfxParameterCollection myParameters // ... IfxParameter[] myParamArray = new IfxParameter[(2*myParameters.Count) - 1]; myParameters.CopyTo(myParamArray, 0); myParameters.CopyTo(myParamArray, myParameters.Count); myParameters.Clear(); return true; }
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.GetEnumerator: Devuelve un enumerador que se repite en la IfxParameterCollection. Este miembro da soporte a la infraestructura Microsoft .NET Framework y no est diseado para utilizarlo directamente a partir del cdigo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-475
Sintaxis
Visual Basic] NotOverridable Public Function GetEnumerator() As IEnumerator _ Implements IEnumerable.GetEnumerator [C#] public IEnumerator GetEnumerator(); [C++] public: __sealed IEnumerator* GetEnumerator(); [JScript] public function GetEnumerator() : IEnumerator;
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.GetParameter: Devuelve el objeto DbParameter con el nombre especificado en la IfxParameterCollection. Lista de sobrecargas
GetParameter(int) Devuelve el objeto DbParameter situado en el ndice especificado en la IfxParameterCollection. Devuelve el objeto DbParameter con el nombre especificado en la IfxParameterCollection.
GetParameter(string)
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.GetParameter(int): Devuelve el objeto DbParameter situado en el ndice especificado en la IfxParameterCollection.
3-476

Visual Basic] Public Overrides Function GetParameter (index As Integer) As DbParameter [C#] public override DbParameter GetParameter (int index) [C++] public: virtual DbParameter^ GetParameter (int index) override [JScript] public override function GetParameter (index : int) : DbParameter
Parmetros index Posicin del parmetro en la lista de parmetros.
Valor de retorno Instancia de DbParameter que representa el parmetro solicitado. Excepciones

Tipo de excepcin IndexOutOfRange Condicin No existe ningn parmetro con el ndice especificado en la coleccin.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.GetParameter(string): Devuelve el objeto DbParameter con el nombre especificado en la IfxParameterCollection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-477
Sintaxis
Visual Basic] Public Overrides Function GetParameter (parameterName As String) As DbParameter [C#] public override DbParameter GetParameter (string parameterName) [C++] public: virtual DbParameter^ GetParameter (String^ parameterName) override [JScript] public override function GetParameter (parameterName : String) : DbParameter
Parmetros parameterName El nombre del parmetro. Valor de retorno Instancia de DbParameter que representa el parmetro solicitado. Excepciones
Tipo de excepcin IndexOutOfRange Condicin No existe ningn parmetro con el nombre especificado en la coleccin.
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.Insert: Inserta un IfxParameter dentro de la coleccin en el ndice especificado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Public Sub Insert( _ ByVal index As Integer, _ ByVal value As Object _ ) [C#] public void Insert( int index,
3-478
object value ); [C++] public: __sealed void Insert( int index, Object* value ); [JScript] public function Insert( index : int, value : Object );
Parmetros index value El ndice basado en cero en el que se debe insertar el parmetro dentro de la coleccin. IfxParameter que debe aadirse a la coleccin.
Excepciones
Tipo de excepcin ArgumentNullException IndexOutOfRange InvalidCastException Condicin El parmetro value es nulo. No existe ningn parmetro con el nombre especificado en la coleccin. El parmetro value no era un IfxParameter.
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.RemoveAt: Elimina el IfxParameter especificado de la coleccin. Lista de sobrecargas
Nombre RemoveAt(Integer) Implements IList.RemoveAt RemoveAt(String) Implements IDataParameterCollection.RemoveAt Descripcin Elimina el IfxParameter del ndice especificado de la coleccin. Elimina el IfxParameter con el nombre especificado de la coleccin.
3-479
Ejemplo [Visual Basic, C#] El ejemplo siguiente busca un IfxParameter con el IfxParameter.ParameterName especificado contenido en una IfxParameterCollection. Si el parmetro existe, se elimina. En este ejemplo se supone que ya se ha creado una IfxParameterCollection. Nota: [Visual Basic, C#] Este ejemplo muestra cmo utilizar una de las versiones sobrecargadas de RemoveAt. Para obtener otros ejemplos que pudieran estar disponibles, consulte los temas de sobrecarga individuales.
[Visual Basic] Public Sub SearchIfxParams() ... create IfxParameterCollection myParameters and IfxParameter myNewParam ... If myParameters.Contains("Description") Then myParameters.RemoveAt("Description") End If End Sub SearchIfxParams [C#] public // // // if } void SearchIfxParams() { ... create IfxParameterCollection myParameters and IfxParameter myNewParam ... (myParameters.Contains("Description")) myParameters.RemoveAt("Description");
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.RemoveAt (Int32): Elimina IfxParameter del ndice especificado de la coleccin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Overloads Public Sub RemoveAt( _ ByVal index As Integer _ ) [C#]
3-480
public void RemoveAt( int index ); [C++] public: __sealed void RemoveAt( int index ); [JScript] public function RemoveAt( index : int );
Parmetros index El ndice basado en cero del parmetro que se va a eliminar.
Excepciones
Tipo de excepcin IndexOutOfRangeException Condicin No existe ningn parmetro con el nombre especificado en la coleccin.
Ejemplo [Visual Basic, C#] El siguiente ejemplo busca un objeto IfxParameter en el ndice especificado contenido en una IfxParameterCollection . Si el parmetro existe, se elimina. En este ejemplo se supone que ya se ha creado la IfxParameterCollection.
Visual Basic] Public Sub SearchIfxParams() ... create IfxParameterCollection myParameters and IfxParameter myNewParam "Param7" ... If myParameters.Contains(Param7) Then myParameters.RemoveAt(7) End If End Sub SearchIfxParams [C#] public void SearchIfxParams() { // ... // create IfxParameterCollection myParameters and IfxParameter myNewParam "Param7" // ... if (myParameters.Contains(Param7)) myParameters.RemoveAt(7); }
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-481
Mtodo IfxParameterCollection.RemoveAt en la pgina 3-479 Elimina el IfxParameter especificado de la coleccin. Mtodo IfxParameterCollection.RemoveAt (String): Elimina de la coleccin el IfxParameter con el nombre especificado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Overloads Public Sub RemoveAt( _ ByVal parameterName As String _ ) [C#] public void RemoveAt( string parameterName ); [C++] public: __sealed void RemoveAt( String* parameterName ); [JScript] public function RemoveAt( parameterName : String );
Parmetros parameterName El nombre del parmetro que se va a eliminar. Excepciones

Tipo de excepcin IndexOutOfRangeException Condicin No existe ningn parmetro con el nombre especificado en la coleccin.
Ejemplo [Visual Basic, C#] El ejemplo siguiente busca un IfxParameter con el IfxParameter.Name especificado contenido en IfxParameterCollection. Si el parmetro existe, se elimina. En este ejemplo se supone que ya se ha creado la IfxParameterCollection.
[Visual Basic] Public Sub SearchIfxParams() ... create IfxParameterCollection myParameters and IfxParameter myNewParam ... If myParameters.Contains("Description") Then myParameters.RemoveAt("Description") End If End Sub SearchIfxParams [C#] public void SearchIfxParams() { // ...
3-482
// create IfxParameterCollection myParameters and IfxParameter myNewParam // ... if (myParameters.Contains("Description")) myParameters.RemoveAt("Description"); }
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.RemoveAt en la pgina 3-479 Elimina el IfxParameter especificado de la coleccin. Mtodo IfxParameterCollection.Remove: Elimina el IfxParameter especificado de la coleccin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Public Sub Remove( _ ByVal value As Object _ ) [C#] public void Remove( object value ); [C++] public: __sealed void Remove( Object* value ); [JScript] public function Remove( value : Object );
Parmetros value Objeto IfxParameter que debe eliminarse de la coleccin.
Excepciones
Tipo de excepcin ArgumentException InvalidCastException Condicin El parmetro no existe. El parmetro no es un IfxParameter vlido.
3-483
Ejemplo [Visual Basic, C#] El ejemplo siguiente busca un objeto IfxParameter contenido en una IfxParameterCollection. Si el parmetro existe, se elimina. En este ejemplo se supone que ya se ha creado la IfxParameterCollection.
[Visual Basic] Public Sub SearchIfxParams() ... create IfxParameterCollection myParameters and IfxParameter myNewParam ... If myParameters.Contains(CType(myNewParam, Object)) Then myParameters.Remove(CType(myNewParam, Object)) End If End Sub SearchIfxParams [C#] public // // // if } void SearchIfxParams() { ... create IfxParameterCollection myParameters and IfxParameter myNewParam ... (myParameters.Contains((Object) myNewParam)) myParameters.Remove(((Object) myNewParam));
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.SetParameter: Establece el DbParameter especificado en el valor que se especifique. Lista de sobrecargas
SetParameter(int, System.Data.Common.DbParameter) SetParameter(string, System.Data.Common.DbParameter) Establece el DbParameter con el ndice especificado en el valor especificado. Establece el DbParameter con el nombre especificado en el valor especificado.
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-484
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.SetParameter(int, System.Data.Common.DbParameter): Establece el DbParameter con el ndice especificado en el valor especificado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Sub SetParameter (index As Integer, value As DbParameter) [C#] public override void SetParameter (int index, value DbParameter) [C++] public: virtual void SetParameter (int index, value^ DbParameter) override [JScript] public override function SetParameter (index : int, value : DbParameter
Parmetros index value Posicin del parmetro en el ndice basado en ceros. Instancia de DbParameter que va a asignarse en el ndice especificado.
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxParameterCollection.SetParameter(string, System.Data.Common.DbParameter): Establece el DbParameter con el nombre especificado en el valor especificado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Sub SetParameter (parameterName As String, value As DbParameter) [C#] public override void SetParameter (string parameterName, value DbParameter) [C++]
3-485
public: virtual void SetParameter (String parameterName, value^ DbParameter) override [JScript] public override function SetParameter (parameterName : String, value : DbParameter
Parmetros parameterName Serie de caracteres que representa el nombre del parmetro que se va a aadir. value Instancia de DbParameter que va a asignarse en el ndice especificado.
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxParameterCollection
Las propiedades de la clase IfxParameterCollection se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxParameterCollection, consulte el tema Miembros de IfxParameterCollection.
Propiedades pblicas
Count IsFixedSize IsReadOnly IsSynchronized this Obtiene el nmero de objetos IfxParameter de la coleccin. Obtiene un valor que indica si la IfxParameterCollection tiene un tamao fijo. Obtiene un valor que indica si la IfxParameterCollection es de slo lectura. Obtiene un valor que indica si la IfxParameterCollection est sincronizada. Sobrecargado. Obtiene o establece el IfxParameter con un atributo especificado. En C#, esta propiedad es el indexador para la clase IfxParameterCollection. SyncRoot Obtiene un objeto que puede utilizarse para sincronizar el acceso a la IfxParameterCollection.
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet.
3-486
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameterCollection.Count: Obtiene el nmero de objetos IfxParameter en la coleccin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Count As Integer [C#] public int Count {get;} [C++] public: __property int get_Count(); [JScript] public function get Count() : int;
Valor de la propiedad Nmero de objetos IfxParameter de la coleccin. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxParameterCollection, aade instancias de IfxParameter a la coleccin, muestra los nombres de los objetos IfxParameter y borra la coleccin.
Visual Basic] Public Sub CreateIfxParamColl(myCommand As IfxCommand) Dim myParamCollection As IfxParameterCollection = myCommand.Parameters myParamCollection.Add("EMPNO", IfxType.Char) myParamCollection.Add("PHOTO_FORMAT", IfxType.VarChar) myParamCollection.Add("PICTURE", IfxType.Blob) Dim myParamNames As String = "" Dim i As Integer For i = 0 To myParamCollection.Count - 1 myParamNames += myParamCollection(i).ToString() + ControlChars.Cr Next i MessageBox.Show(myParamNames) myParamCollection.Clear() End Sub CreateIfxParamColl [C#] public void CreateIfxParamColl(IfxCommand myCommand) { IfxParameterCollection myParamCollection = myCommand.Parameters; myParamCollection.Add("EMPNO", IfxType.Char); myParamCollection.Add("PHOTO_FORMAT", IfxType.VarChar); myParamCollection.Add("PICTURE", IfxType.Blob); string myParamNames = ""; for (int i=0; i < myParamCollection.Count; i++) myParamNames += myParamCollection[i].ToString() + "\n"; MessageBox.Show(myParamNames); myParamCollection.Clear(); }
3-487
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameterCollection.IsFixedSize: Obtiene un valor que indica si la IfxParameterCollection tiene un tamao fijo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property IsFixedSize As Boolean [C#] public bool IsFixedSize {get;} [C++] public: __property bool get_IsFixedSize(); [JScript] public final function get IsFixedSize() : boolean
Valor de la propiedad true si IfxParameterCollection tiene un tamao fijo; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameterCollection.IsReadOnly: Obtiene un valor que indica si la IfxParameterCollection es de slo lectura. Espacio de nombres: IBM.Data.Informix
3-488

Visual Basic] Public ReadOnly Property IsReadOnly As Boolean [C#] public bool IsReadOnly {get;} [C++] public: __property bool get_IsReadOnly(); [JScript] public final function get IsReadOnly() : boolean
Valor de la propiedad true siIfxParameterCollection es de slo lectura; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameterCollection.IsSynchronized: Obtiene un valor que indica si la IfxParameterCollection est sincronizada. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property IsSynchronized As Boolean [C#] public bool IsSynchronized {get;} [C++] public: __property bool get_IsSynchronized(); [JScript] public final function get IsSynchronized() : boolean
Valor de la propiedad true si IfxParameterCollection est sincronizada; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0
3-489
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameterCollection.SyncRoot: Obtiene un objeto que puede utilizarse para sincronizar el acceso a la IfxParameterCollection. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property SyncRoot As Object [C#] public Object SyncRoot {get;} [C++] public: __property Object get_SyncRoot(); [JScript] public final function get SyncRoot() : Object
Valor de la propiedad Objeto que puede utilizarse para sincronizar el acceso a la IfxParameterCollection. Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameterCollection.this: Obtiene o establece el IfxParameter con un atributo especificado.
3-490
Nombre Parmetro this(Integer) As Ifx this(String) As IfxParameter Descripcin Obtiene o establece el IfxParameter en el ndice especificado. Obtiene o establece el IfxParameter con el nombre especificado.
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxParameterCollection, aade instancias de IfxParameter a la coleccin, muestra los nombres de los objetos IfxParameter y, a continuacin, borra la coleccin. Nota: [Visual Basic, C#] Este ejemplo muestra cmo utilizar una de las versiones sobrecargadas de la propiedad this (indexador IfxParameterCollection). Para obtener otros ejemplos que pudieran estar disponibles, consulte los temas de sobrecarga individuales.
[Visual Basic] Public Sub CreateIfxParamColl(myCommand As IfxCommand) Dim myParamCollection As IfxParameterCollection = myCommand.Parameters myParamCollection.Add("EMPNO", IfxType.Char) myParamCollection.Add("PHOTO_FORMAT", IfxType.VarChar) myParamCollection.Add("PICTURE", IfxType.Blob) Dim myParamNames As String = "" Dim i As Integer For i = 0 To myParamCollection.Count - 1 myParamNames += myParamCollection(i).ToString() + ControlChars.Cr Next i MessageBox.Show(myParamNames) myParamCollection.Clear() End Sub CreateIfxParamColl [C#] public void CreateIfxParamColl(IfxCommand myCommand) { IfxParameterCollection myParamCollection = myCommand.Parameters; myParamCollection.Add("EMPNO", IfxType.Char); myParamCollection.Add("PHOTO_FORMAT", IfxType.VarChar); myParamCollection.Add("PICTURE", IfxType.Blob); string myParamNames = ""; for (int i=0; i < myParamCollection.Count; i++) myParamNames += myParamCollection[i].ToString() + "\n"; MessageBox.Show(myParamNames); myParamCollection.Clear(); }
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos
3-491
SpClient.cs SpClient.vb SpReturn.cs SpReturn.vb Propiedad IfxParameterCollection.This (String): Obtiene o establece el IfxParameter con el nombre especificado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overloads Public Default Property this( _ ByVal parameterName As String _ ) As IfxParameter [C#] public IfxParameter this[ string parameterName ] {get; set;} [C++] public: __property IfxParameter * get_this( String* parameterName ); public: __property void set_this( String* parameterName, IfxParameter* ); [JScript] returnValue = IfxParameterCollectionObject.this(parameterName); IfxParameterCollectionObject.this(parameterName) = returnValue; -o bienreturnValue = IfxParameterCollectionObject(parameterName); IfxParameterCollectionObject(parameterName) = returnValue;
Valor de la propiedad IfxParameter con el nombre especificado. Excepciones

Tipo de excepcin IndexOutOfRangeException Condicin El nombre especificado no existe.
Ejemplo [Visual Basic, C#] El ejemplo siguiente busca un IfxParameter con un IfxParameter.Name determinado contenido en una IfxParameterCollection. Si el parmetro existe, el ejemplo visualiza el nombre y el ndice del parmetro. Si el parmetro no existe, el ejemplo muestra un error. En este ejemplo se supone que ya se ha creado una IfxParameterCollection.
3-492
Visual Basic] Public Sub SearchIfxParams() ... create IfxParameterCollection myParameters ... If Not myParameters.Contains("Description") Then MessageBox.Show("ERROR: no such parameter in the collection") Else MessageBox.Show("Name: " & myParameters("Description").ToString() & _ "Index: " & myParameters.IndexOf("Description").ToString()) End If End Sub SearchIfxParams [C#] public // // // if void SearchIfxParams() { ... create IfxParameterCollection myParameters ... (!myParameters.Contains("Description")) MessageBox.Show("ERROR: no such parameter in the collection"); else MessageBox.Show("Name: " + myParameters["Description"].ToString() + "Index: " + myParameters.IndexOf("Description").ToString());
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameterCollection.this en la pgina 3-490 Obtiene o establece el IfxParameter con un atributo especificado. Ejemplos SpClient.cs SpClient.vb SpReturn.cs SpReturn.vb Propiedad IfxParameterCollection.this (Int32): Obtiene o establece el IfxParameter en el ndice especificado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Overloads Public Default Property this( _ ByVal index As Integer _ ) As IfxParameter
3-493
[C#] public IfxParameter this[ int index ] {get; set;} [C++] public: __property IfxParameter * get_this( int index ); public: __property void set_this( int index, IfxParameter* ); [JScript] returnValue = IfxParameterCollectionObject.this(index); IfxParameterCollectionObject.this(index) = returnValue; -o bienreturnValue = IfxParameterCollectionObject(index); IfxParameterCollectionObject(index) = returnValue;
Valor de la propiedad IfxParameter en el ndice especificado. Excepciones

Tipo de excepcin IndexOutOfRangeException Condicin El ndice especificado no existe.
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxParameterCollection, aade instancias de IfxParameter a la coleccin, muestra los nombres de los objetos IfxParameter y, a continuacin, borra la coleccin.
Visual Basic] Public Sub CreateIfxParamColl(myCommand As IfxCommand) Dim myParamCollection As IfxParameterCollection = myCommand.Parameters myParamCollection.Add("EMPNO", IfxType.Char) myParamCollection.Add("PHOTO_FORMAT", IfxType.VarChar) myParamCollection.Add("PICTURE", IfxType.Blob) Dim myParamNames As String = "" Dim i As Integer For i = 0 To myParamCollection.Count - 1 myParamNames += myParamCollection(i).ToString() + ControlChars.Cr Next i MessageBox.Show(myParamNames) myParamCollection.Clear() End Sub CreateIfxParamColl [C#] public void CreateIfxParamColl(IfxCommand myCommand) { IfxParameterCollection myParamCollection = myCommand.Parameters; myParamCollection.Add("EMPNO", IfxType.Char); myParamCollection.Add("PHOTO_FORMAT", IfxType.VarChar); myParamCollection.Add("PICTURE", IfxType.Blob); string myParamNames = ""; for (int i=0; i < myParamCollection.Count; i++) myParamNames += myParamCollection[i].ToString() + "\n"; MessageBox.Show(myParamNames); myParamCollection.Clear(); }
3-494
Consulta Clase IfxParameterCollection en la pgina 3-453 Representa una coleccin de parmetros relevantes para un IfxCommand as como las correlaciones respectivas de los mismos con columnas de un DataSet. Miembros de IfxParameterCollection en la pgina 3-455 Las tablas siguientes listan los miembros expuestos por la clase IfxParameterCollection. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxParameterCollection.this en la pgina 3-490 Obtiene o establece el IfxParameter con un atributo especificado.
Clase IfxPermissionAttribute
Asocia una accin de seguridad con un atributo de seguridad personalizado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)

System.Object System.Attribute System.Security.Permissions.SecurityAttribute System.Security.Permissions.CodeAccessSecurityAttribute IBM.Data.Informix.IfxPermissionAttribute

System.Object System.Attribute System.Security.Permissions.SecurityAttribute System.Security.Permissions.CodeAccessSecurityAttribute System.Data.Common.DBDataPermissionAttribute IBM.Data.Informix.IfxPermissionAttribute

Visual Basic] <AttributeUsage(AttributeTargets.Assembly Or AttributeTargets.Class _ Or AttributeTargets.Struct Or AttributeTargets.Constructor Or _ AttributeTargets.Method)> <Serializable> NotInheritable Public Class IfxPermissionAttribute Inherits CodeAccessSecurityAttribute [C#] [AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Constructor | AttributeTargets.Method)] [Serializable] public sealed class IfxPermissionAttribute : CodeAccessSecurityAttribute [C++] [AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class
3-495
| AttributeTargets.Struct | AttributeTargets.Constructor | AttributeTargets.Method)] [Serializable] public __gc __sealed class IfxPermissionAttribute : public CodeAccessSecurityAttribute [JScript] public AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Constructor | AttributeTargets.Method) Serializable class IfxPermissionAttribute extends CodeAccessSecurityAttribute

Visual Basic] <AttributeUsage(AttributeTargets.Assembly Or AttributeTargets.Class _ Or AttributeTargets.Struct Or AttributeTargets.Constructor Or _ AttributeTargets.Method)> <Serializable> NotInheritable Public Class IfxPermissionAttribute Inherits DBDataPermissionAttribute [C#] [AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Constructor | AttributeTargets.Method)] [Serializable] public sealed class IfxPermissionAttribute : DBDataPermissionAttribute [C++] [AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Constructor | AttributeTargets.Method)] [Serializable] public __gc __sealed class IfxPermissionAttribute : public DBDataPermissionAttribute [JScript] public AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Constructor | AttributeTargets.Method) Serializable class IfxPermissionAttribute extends DBDataPermissionAttribute
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxPermissionAttribute en la pgina 3-497 Visin general de IfxPermissionAttribute Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-496
Miembros de IfxPermissionAttribute
Visin general de IfxPermissionAttribute
IfxPermissionAttribute Inicializa una nueva instancia de la clase IfxPermissionAttribute con uno de los valores de SecurityAction.
Propiedades pblicas
Obtiene o establece una accin de seguridad. Action (heredada de SecurityAttribute) AllowBlankPassword (heredada de DBDataPermissionAttribute) TypeId (heredada de Attribute) Obtiene un valor que indica si se permite una contrasea en blanco. Cuando se implementa en una clase derivada, obtiene un identificador exclusivo para este Attribute. Obtiene o establece un valor que indica si se declara permiso completo (no restringido) al recurso protegido por el atributo.
Unrestricted (heredada de SecurityAttribute)
Mtodos pblicos
CreatePermission Alterado temporalmente. Devuelve un objeto IfxPermission que est configurado de acuerdo con las propiedades del atributo. Sobrecargado. Determina si dos instancias de Object son iguales. Alterado temporalmente. Devuelve el cdigo hash para esta instancia. Obtiene el Type de la instancia actual. GetType (heredado de Object) IsDefaultAttribute (heredado de Attribute) Cuando est alterado temporalmente en una clase derivada, devuelve una indicacin de si el valor de esta instancia es el valor por omisin para la clase derivada o no. Cuando est alterado temporalmente en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado o no. Devuelve una String que representa el Object actual.
Equals (heredado de Object) GetHashCode (heredado de Attribute)
Match (heredado de Attribute)
3-497
Mtodos protegidos
Consulta Clase IfxPermissionAttribute en la pgina 3-495 Asocia una accin de seguridad con un atributo de seguridad personalizado. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Constructor de IfxPermissionAttribute
Inicializa una nueva instancia de la clase IfxPermissionAttribute con uno de los valores de SecurityAction. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] <AttributeUsage(AttributeTargets.Assembly Or AttributeTargets.Class _ Or AttributeTargets.Struct Or AttributeTargets.Constructor Or _ AttributeTargets.Method)> <Serializable> Public Sub New( _ ByVal action As SecurityAction _ ) [C#] [AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Constructor | AttributeTargets.Method)] [Serializable] public IfxPermissionAttribute( SecurityAction action ); [C++] [AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Constructor | AttributeTargets.Method)] [Serializable] public: IfxPermissionAttribute( SecurityAction action );
3-498
[JScript] public AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Constructor | AttributeTargets.Method) Serializable function IfxPermissionAttribute( action : SecurityAction );
Parmetros
action Uno de los valores de System.Security.Permissions.SecurityAction que representan una accin que se puede realizar utilizando la seguridad declarativa.
Valor de retorno
IfxPermissionAttribute . Consulta Clase IfxPermissionAttribute en la pgina 3-495 Asocia una accin de seguridad con un atributo de seguridad personalizado. Miembros de IfxPermissionAttribute en la pgina 3-497 Visin general de IfxPermissionAttribute Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxPermissionAttribute
Los mtodos de la clase IfxPermissionAttribute se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxPermissionAttribute, consulte el tema Miembros de IfxPermissionAttribute.
Mtodos pblicos
CreatePermission Alterado temporalmente. Devuelve un objeto IfxPermission que est configurado de acuerdo con las propiedades del atributo. Sobrecargado. Determina si dos instancias de Object son iguales. Alterado temporalmente. Devuelve el cdigo hash para esta instancia. Obtiene el Type de la instancia actual. GetType (heredado de Object) IsDefaultAttribute (heredado de Attribute) Cuando est alterado temporalmente en una clase derivada, devuelve una indicacin de si el valor de esta instancia es el valor por omisin para la clase derivada o no. Cuando est alterado temporalmente en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado o no.
Equals (heredado de Object) GetHashCode (heredado de Attribute)
Match (heredado de Attribute)
3-499
Devuelve una String que representa el Object actual.
Mtodos protegidos
Consulta Clase IfxPermissionAttribute en la pgina 3-495 Asocia una accin de seguridad con un atributo de seguridad personalizado. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxPermissionAttribute.CreatePermission: Devuelve un objeto IfxPermission que est configurado de acuerdo con las propiedades del atributo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <AttributeUsage(AttributeTargets.Assembly Or AttributeTargets.Class _ Or AttributeTargets.Struct Or AttributeTargets.Constructor Or _ AttributeTargets.Method)> <Serializable> Overrides Public Function CreatePermission() As IPermission [C#] [AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Constructor | AttributeTargets.Method)] [Serializable] public override IPermission CreatePermission(); [C++] [AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Constructor | AttributeTargets.Method)] [Serializable] public: IPermission* CreatePermission(); [JScript] public
3-500
AttributeUsage(AttributeTargets.Assembly | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Constructor | AttributeTargets.Method) Serializable override function CreatePermission() : IPermission;
Valor de retorno Un objeto IfxPermission. Consulta Clase IfxPermissionAttribute en la pgina 3-495 Asocia una accin de seguridad con un atributo de seguridad personalizado. Miembros de IfxPermissionAttribute en la pgina 3-497 Visin general de IfxPermissionAttribute Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxPermission
Habilita IBM Data Server Provider for .NET para asegurar que un usuario tenga un nivel de seguridad adecuado para acceder a una base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)

System.Object System.Security.CodeAccessPermission IBM.Data.Informix.IfxPermission

System.Object System.Security.CodeAccessPermission System.Data.Common.DBDataPermission IBM.Data.Informix.IfxPermission

Visual Basic] <Serializable> NotInheritable Public Class IfxPermission Inherits CodeAccessPermission [C#] [Serializable] public sealed class IfxPermission : CodeAccessPermission [C++] [Serializable] public __gc __sealed class IfxPermission : public CodeAccessPermission [JScript]
3-501
public Serializable class IfxPermission ampla CodeAccessPermission

Visual Basic] <Serializable> NotInheritable Public Class IfxPermission Inherits DBDataPermission [C#] [Serializable] public sealed class IfxPermission : DBDataPermission [C++] [Serializable] public __gc __sealed class IfxPermission : public DBDataPermission [JScript] public Serializable class IfxPermission ampla DBDataPermission
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de permiso de Ifx Visin general de IfxPermission Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Miembros de permiso de Ifx

Visin general de IfxPermission
IfxPermission Inicializa una nueva instancia de la clase IfxPermission.
Propiedades pblicas
AllowBlankPassword (heredada de DBDataPermission) Obtiene un valor que indica si se permite una contrasea en blanco.
3-502
Mtodos pblicos
Add Aade acceso para la serie de conexin especificada al estado existente de IfxPermission. Afirma que el cdigo de llamada puede acceder al recurso identificado por el permiso actual mediante el cdigo que llama a este mtodo, incluso si a los llamadores en posiciones superiores en la pila no se les ha concedido el permiso para acceder al recurso. Alterado temporalmente. Crea y devuelve una copia idntica del objeto de permiso actual. Fuerza una SecurityException en tiempo de ejecucin si a ninguno de los llamadores en posiciones superiores en la pila de llamada se les ha concedido el permiso especificado por la instancia actual. Evita que los llamadores en posiciones superiores en la pila de llamada utilicen el cdigo que llama a este mtodo para acceder al recurso especificado por la instancia actual. Sobrecargado. Determina si dos instancias Object son iguales. Alterado temporalmente. Reconstruye un objeto de seguridad con un estado especificado desde una codificacin XML. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el Type de la instancia actual. GetType (heredado de Object) Intersect (heredado de DBDataPermission) Alterado temporalmente. Devuelve un nuevo objeto de permiso que representa la interseccin del objeto de permiso actual y el objeto de permiso especificado. Alterado temporalmente. Devuelve un valor que indica si el objeto de permiso actual es un subconjunto del objeto de permiso especificado. Devuelve un valor que indica si el permiso se puede representar como no restringido sin ningn conocimiento de la semntica de permisos.
Assert (heredado de CodeAccessPermission)
Copy (heredado de DBDataPermission) Demand (heredado de CodeAccessPermission)
Deny (heredado de CodeAccessPermission)
Equals (heredado de Object) FromXml (heredado de DBDataPermission) GetHashCode (heredado de Object)
IsSubsetOf (heredado de DBDataPermission)
IsUnrestricted (heredado de DBDataPermission)
3-503
PermitOnly (heredado de CodeAccessPermission)
Evita que los llamadores en posiciones superiores en la pila de llamada utilicen el cdigo que llama a este mtodo para acceder a todos los recursos excepto el recurso especificado por la instancia actual. Alterado temporalmente. Crea y devuelve una representacin de series del objeto de permiso actual. Alterado temporalmente. Crea una codificacin XML del objeto de seguridad y de su estado actual. Alterado temporalmente. Devuelve un nuevo objeto de permiso que es la unin de los objetos de permiso actual y especificado.
ToString (heredado de CodeAccessPermission) ToXml (heredado de DBDataPermission) Union (heredado de DBDataPermission)
Mtodos protegidos
Consulta Clase IfxPermission en la pgina 3-501 Habilita IBM Data Server Provider for .NET para asegurar que un usuario tenga un nivel de seguridad adecuado para acceder a una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Constructor de IfxPermission
Inicializa una nueva instancia de la clase IfxPermission.
Nombre New() New(PermissionState) Descripcin Inicializa una nueva instancia de la clase IfxPermission. Inicializa una nueva instancia de la clase IfxPermission con uno de los valores de PermissionState.
Consulta
3-504
Clase IfxPermission en la pgina 3-501 Habilita IBM Data Server Provider for .NET para asegurar que un usuario tenga un nivel de seguridad adecuado para acceder a una base de datos. Miembros de permiso de Ifx en la pgina 3-502 Visin general de IfxPermission Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxPermission (): Inicializa una nueva instancia de la clase IfxPermission. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <Serializable> Public Sub New() [C#] [Serializable] public IfxPermission(); [C++] [Serializable] public: IfxPermission(); [JScript] public Serializable function IfxPermission();
Comentarios El constructor base inicializa todos los campos en sus valores por omisin. Informacin de versin Versin de .NET Framework Soportado en: 1.1. Consulta Clase IfxPermission en la pgina 3-501 Habilita IBM Data Server Provider for .NET para asegurar que un usuario tenga un nivel de seguridad adecuado para acceder a una base de datos. Miembros de permiso de Ifx en la pgina 3-502 Visin general de IfxPermission Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Constructor de IfxPermission en la pgina 3-504 Inicializa una nueva instancia de la clase IfxPermission.
3-505
Constructor de IfxPermission (PermissionState): Inicializa una nueva instancia de la clase IfxPermission con uno de los valores de PermissionState. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] <Serializable> Public Sub New( _ ByVal state As PermissionState _ ) [C#] [Serializable] public IfxPermission( PermissionState state ); [C++] [Serializable] public: IfxPermission( PermissionState state ); [JScript] public Serializable function IfxPermission( state : PermissionState );
Parmetros state Uno de los valores de System.Security.Permissions.PermissionState.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxPermission en la pgina 3-501 Habilita IBM Data Server Provider for .NET para asegurar que un usuario tenga un nivel de seguridad adecuado para acceder a una base de datos. Miembros de permiso de Ifx en la pgina 3-502 Visin general de IfxPermission Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxPermission
Los mtodos de la clase IfxPermission se listan a continuacin.
3-506
Mtodos pblicos
Add Aade acceso para la serie de conexin especificada al estado existente de IfxPermission. Afirma que el cdigo de llamada puede acceder al recurso identificado por el permiso actual mediante el cdigo que llama a este mtodo, incluso si a los llamadores en posiciones superiores en la pila no se les ha concedido el permiso para acceder al recurso. Alterado temporalmente. Crea y devuelve una copia idntica del objeto de permiso actual. Fuerza una SecurityException en tiempo de ejecucin si a ninguno de los llamadores en posiciones superiores en la pila de llamada se les ha concedido el permiso especificado por la instancia actual. Evita que los llamadores en posiciones superiores en la pila de llamada utilicen el cdigo que llama a este mtodo para acceder al recurso especificado por la instancia actual. Sobrecargado. Determina si dos instancias Object son iguales. Alterado temporalmente. Reconstruye un objeto de seguridad con un estado especificado desde una codificacin XML. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Obtiene el Type de la instancia actual. GetType (heredado de Object) Intersect (heredado de DBDataPermission) Alterado temporalmente. Devuelve un nuevo objeto de permiso que representa la interseccin del objeto de permiso actual y el objeto de permiso especificado. Alterado temporalmente. Devuelve un valor que indica si el objeto de permiso actual es un subconjunto del objeto de permiso especificado. Devuelve un valor que indica si el permiso se puede representar como no restringido sin ningn conocimiento de la semntica de permisos. Evita que los llamadores en posiciones superiores en la pila de llamada utilicen el cdigo que llama a este mtodo para acceder a todos los recursos excepto el recurso especificado por la instancia actual.
Assert (heredado de CodeAccessPermission)
Copy (heredado de DBDataPermission) Demand (heredado de CodeAccessPermission)
Deny (heredado de CodeAccessPermission)
Equals (heredado de Object) FromXml (heredado de DBDataPermission) GetHashCode (heredado de Object)
IsSubsetOf (heredado de DBDataPermission)
IsUnrestricted (heredado de DBDataPermission)
PermitOnly (heredado de CodeAccessPermission)
3-507
ToString (heredado de CodeAccessPermission) ToXml (heredado de DBDataPermission) Union (heredado de DBDataPermission)
Alterado temporalmente. Crea y devuelve una representacin de series del objeto de permiso actual. Alterado temporalmente. Crea una codificacin XML del objeto de seguridad y de su estado actual. Alterado temporalmente. Devuelve un nuevo objeto de permiso que es la unin de los objetos de permiso actual y especificado.
Mtodos protegidos
Consulta Miembros de permiso de Ifx en la pgina 3-502 Visin general de IfxPermission Clase IfxPermission en la pgina 3-501 Habilita IBM Data Server Provider for .NET para asegurar que un usuario tenga un nivel de seguridad adecuado para acceder a una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxPermission.Add: Aade acceso para la serie de conexin especificada al estado existente de IfxPermission. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Sub Add ( _ connectionString As String, _ restrictions As String, _ behavior As KeyRestrictionBehavior _ ) [C#]
3-508
public override void Add ( string connectionString, string restrictions, KeyRestrictionBehavior behavior ) [C++] public: virtual void Add ( String^ connectionString, String^ restrictions, KeyRestrictionBehavior behavior ) override [JScript] public override function Add ( connectionString As String, restrictions As String, behavior As KeyRestrictionBehavior )
Parmetros connectionString Serie de conexin para la conexin de base de datos. restrictions Restricciones de clave. behavior Enumeracin KeyRestrictionBehavior. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxPermission en la pgina 3-501 Habilita IBM Data Server Provider for .NET para asegurar que un usuario tenga un nivel de seguridad adecuado para acceder a una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxRecord
Representa una nica fila de datos de solo lectura. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.MarshalByRefObject IBM.Data.Informix.IfxRecord
3-509
Sintaxis
Visual Basic] NotInheritable Public Class IfxRecord [C#] public sealed class IfxRecord [C++] public __gc __sealed class IfxRecord [JScript] public class IfxRecord
Comentarios
Para situaciones donde solo necesita recuperar una nica fila, un IfxRecord proporciona ventajas de rendimiento frente a la utilizacin de un IfxResultSet o IfxDataReader ya que el cursor que lee la fila se puede cerrar una vez que se ha llenado el IfxRecord.
Ejemplo
[C#] El ejemplo siguiente demuestra cmo crear un IfxRecord y leer sus datos de columna.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT MAX(SALES) FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxRecord salesRec = cmd.ExecuteRow(); salesData = salesRec.GetIfxInt32(0).ToString(); return salesData; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxRecord Representa un registro de slo lectura. Las tablas siguientes listan los miembros expuestos por la clase IfxRecord. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Miembros de IfxRecord
Representa un registro de slo lectura. Las tablas siguientes listan los miembros expuestos por la clase IfxRecord.
3-510
Propiedades pblicas
FieldCount this Obtiene el nmero de columnas de la fila actual. Sobrecargado. Obtiene el valor de una columna en su formato nativo.
Mtodos pblicos
Cierra la instancia de IfxRecord. Dispose GetBoolean GetByte GetBytes Obtiene el valor de la columna especificada como un Booleano. Obtiene el valor de la columna especificada como un byte. Lee una corriente de bytes desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio dado. Obtiene el valor de la columna especificada como un carcter. Lee una corriente de caracteres desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio dado. Obtiene el nombre del tipo de datos fuente. GetDataTypeName GetDate GetDateTime GetIfxBinary GetIfxDate GetIfxDecimal GetIfxDouble GetIfxInt16 GetIfxInt32 GetIfxInt64 GetIfxReal Obtiene el valor de la columna especificada como un objeto DateTime. Obtiene el valor de la columna especificada como un objeto DateTime. Crea una instancia de un objeto IfxBinary a partir de los datos de columna. Crea una instancia de un objeto IfxDate a partir de los datos de columna. Crea una instancia de un objeto IfxDecimal a partir de los datos de columna. Crea una instancia de un objeto IfxDouble a partir de los datos de columna. Crea una instancia de un objeto IfxInt16 a partir de los datos de columna. Crea una instancia de un objeto IfxInt32 a partir de los datos de columna. Crea una instancia de un objeto IfxInt64 a partir de los datos de columna. Crea una instancia de un objeto IfxReal a partir de los datos de columna.
GetChar GetChars
3-511
GetIfxReal370 GetIfxRowId GetIfxString GetIfxTime GetIfxTimeStamp
Crea una instancia de un objeto IfxReal370 a partir de los datos de columna. Crea una instancia de un objeto IfxRowId a partir de los datos de columna. Crea una instancia de un objeto IfxString a partir de los datos de columna. Crea una instancia de un objeto IfxTime a partir de los datos de columna. Crea una instancia de un objeto IfxTimeStamp a partir de los datos de columna. Obtiene el valor de la columna especificada como un decimal. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin doble. Obtiene el Type que es el tipo de datos del objeto. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin simple. No est soportado.
GetDecimal GetDouble
GetFieldType GetFloat
GetGuid GetInt16 GetInt32 GetInt64 GetName GetOrdinal GetString GetTime GetTimeSpan GetValue GetValues GetXmlSaxReader IsDBNull Obtiene un valor que indica si la columna contiene valores no existentes o si faltan. Obtiene el valor de la columna especificada como un entero con signo de 16 bits. Obtiene el valor de la columna especificada como un entero con signo de 32 bits. Obtiene el valor de la columna especificada como un entero con signo de 64 bits. Obtiene el nombre de la columna especificada. Obtiene el ordinal de columna, dado el nombre de la columna. Obtiene el valor de la columna especificada como una serie de caracteres. Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna en el ordinal especificado en su formato nativo. Obtiene todas las columnas de atributos en la fila actual. No est soportado.
3-512
Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxRecord
Los mtodos de la clase IfxRecord se listan a continuacin.
Mtodos pblicos
Cierra la instancia de IfxRecord. Dispose GetBoolean GetByte GetBytes Obtiene el valor de la columna especificada como un Booleano. Obtiene el valor de la columna especificada como un byte. Lee una corriente de bytes desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio dado. Obtiene el valor de la columna especificada como un carcter. Lee una corriente de caracteres desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio dado. Obtiene el nombre del tipo de datos fuente. GetDataTypeName GetDate GetDateTime GetIfxBinary GetIfxDate GetIfxDecimal GetIfxDouble GetIfxInt16 Obtiene el valor de la columna especificada como un objeto DateTime. Obtiene el valor de la columna especificada como un objeto DateTime. Crea una instancia de un objeto IfxBinary a partir de los datos de columna. Crea una instancia de un objeto IfxDate a partir de los datos de columna. Crea una instancia de un objeto IfxDecimal a partir de los datos de columna. Crea una instancia de un objeto IfxDouble a partir de los datos de columna. Crea una instancia de un objeto IfxInt16 a partir de los datos de columna.
GetChar GetChars
3-513
GetIfxInt32 GetIfxInt64 GetIfxReal GetIfxReal370 GetIfxRowId GetIfxString GetIfxTime GetIfxTimeStamp
Crea una instancia de un objeto IfxInt32 a partir de los datos de columna. Crea una instancia de un objeto IfxInt64 a partir de los datos de columna. Crea una instancia de un objeto IfxReal a partir de los datos de columna. Crea una instancia de un objeto IfxReal370 a partir de los datos de columna. Crea una instancia de un objeto IfxRowId a partir de los datos de columna. Crea una instancia de un objeto IfxString a partir de los datos de columna. Crea una instancia de un objeto IfxTime a partir de los datos de columna. Crea una instancia de un objeto IfxTimeStamp a partir de los datos de columna. Obtiene el valor de la columna especificada como un decimal. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin doble. Obtiene el Type que es el tipo de datos del objeto. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin simple. No est soportado.
GetGuid GetInt16 GetInt32 GetInt64 GetName GetOrdinal GetString GetTime GetTimeSpan GetValue Obtiene el valor de la columna especificada como un entero con signo de 16 bits. Obtiene el valor de la columna especificada como un entero con signo de 32 bits. Obtiene el valor de la columna especificada como un entero con signo de 64 bits. Obtiene el nombre de la columna especificada. Obtiene el ordinal de columna, dado el nombre de la columna. Obtiene el valor de la columna especificada como una serie de caracteres. Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna en el ordinal especificado en su formato nativo.
3-514
GetValues GetXmlSaxReader IsDBNull
Obtiene todas las columnas de atributos en la fila actual. No est soportado. Obtiene un valor que indica si la columna contiene valores no existentes o si faltan.
Consulta Miembros de IfxRecord en la pgina 3-510 Representa un registro de slo lectura. Las tablas siguientes listan los miembros expuestos por la clase IfxRecord. Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.Dispose: Cierra la instancia de IfxRecord. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetBoolean: Obtiene el valor de la columna especificada como un Booleano.
3-515


Comentarios Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetByte: Obtiene el valor de la columna especificada como un byte. Espacio de nombres: IBM.Data.Informix
3-516

Valor de retorno El valor de la columna especificada como un byte. Excepciones

Comentarios Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetBytes: Lee una corriente de bytes desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio determinado. Espacio de nombres: IBM.Data.Informix
3-517

Visual Basic] Public Function GetBytes( _ ByVal i As Integer, _ ByVal dataIndex As Long, _ ByVal buffer() As Byte, _ ByVal bufferIndex As Integer, _ ByVal length As Integer _ ) As Long [C#] public long GetBytes( int i, long dataIndex, byte[] buffer, int bufferIndex, int length ); [C++] public: __int64 GetBytes( int i, __int64 dataIndex, unsigned char buffer __gc[], int bufferIndex, int length ); [JScript] public function GetBytes( i : int, dataIndex : long, buffer : Byte[], bufferIndex : int, length : int ) : long;
3-518
Comentarios GetBytes devuelve el nmero de bytes disponibles en el campo. En la mayora de casos esta es la longitud exacta del campo. Sin embargo, el nmero devuelto puede ser menor que la longitud verdadera del campo si GetBytes ya se ha utilizado para obtener bytes del campo. Este caso puede darse, por ejemplo, si IfxDataReader est leyendo un BLOB en un almacenamiento intermedio. Para obtener ms informacin, consulte el valor SequentialAccess de System.Data.CommandBehavior en la documentacin del SDK de Microsoft(R) .NET Framework. Si especifica un almacenamiento intermedio que es un valor nulo, GetBytes devuelve la longitud del campo en bytes. No se realizan conversiones. El tipo de los datos que se deben recuperar debe ser uno de los siguientes: v IfxType.Blob La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetChar: Obtiene el valor de la columna especificada como un carcter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetChar( _ ByVal i As Integer _ ) As Char [C#] public char GetChar( int i ); [C++] public: __wchar_t GetChar( int i );
3-519
[JScript] public function GetChar( i : int ) : Char;

Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetChars:
3-520
Lee una corriente de caracteres desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio determinado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetChars( _ ByVal i As Integer, _ ByVal dataIndex As Long, _ ByVal buffer() As Char, _ ByVal bufferIndex As Integer, _ ByVal length As Integer _ ) As Long [C#] public long GetChars( int i, long dataIndex, char[] buffer, int bufferIndex, int length ); [C++] public: __int64 GetChars( int i, __int64 dataIndex, __wchar_t buffer __gc[], int bufferIndex, int length ); [JScript] public function GetChars( i : int, dataIndex : long, buffer : Char[], bufferIndex : int, length : int ) : long;
dataIndex El ndice de la fila donde debe empezar la operacin de lectura. buffer El almacenamiento intermedio en el que se deben copiar los datos. bufferIndex El ndice donde buffer debe empezar la operacin de grabacin. length El nmero de caracteres que se va a leer. Valor de retorno El nmero real de caracteres ledos.
3-521
Excepciones
Comentarios GetChars devuelve el nmero de caracteres disponibles en el campo. En la mayora de casos esta es la longitud exacta del campo. Sin embargo, el nmero devuelto puede ser inferior a la longitud verdadera del campo si GetChars ya se ha utilizado para obtener caracteres del campo. Este caso puede darse, por ejemplo, si IfxDataReader est leyendo un CLOB en un almacenamiento intermedio. Para obtener ms informacin, consulte el valor SequentialAccess de System.Data.CommandBehavior en la documentacin del SDK de Microsoft(R) .NET Framework. Si pasa un almacenamiento intermedio que es un valor nulo, GetChars devuelve la longitud del campo en caracteres. No se realizan conversiones. Los datos que se van a recuperar deben ser uno de los siguientes tipos: v IfxType.Char v IfxType.VarChar v IfxType.LongVarChar v IfxType.Clob La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetIfxBinary: Crea una instancia de un objeto IfxBinary a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-522
Sintaxis
Visual Basic] Public Function GetIfxBinary( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxBinary [C#] public IBM.Data.IfxTypes.IfxBinary GetIfxBinary (int i) [C++] public: IBM.Data.IfxTypes.IfxBinary GetIfxBinary( int i ); [JScript] public function GetIfxBinary( i : int ) : IBM.Data.IfxTypes.IfxBinary;
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetIfxBlob: Crea una instancia de un objeto IfxBlob a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix
3-523

Visual Basic] Public Function GetIfxBlob( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxBlob [C#] public IBM.Data.IfxTypes.IfxBlob GetIfxBlob (int i) [C++] public: IBM.Data.IfxTypes.IfxBlob GetIfxBlob( int i ); [JScript] public function GetIfxBlob( i : int ) : IBM.Data.IfxTypes.IfxBlob;
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-524
Mtodo IfxRecord.GetIfxClob: Crea una instancia de un objeto IfxClob a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura.
3-525
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetIfxDate: Crea una instancia de un objeto IfxDate a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Excepciones
3-526
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetIfxDecimal: Crea una instancia de un objeto IfxDecimal a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-527
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetIfxDouble: Crea una instancia de un objeto IfxDouble a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Objeto IfxDouble que representa el valor de columna. Comentarios No se realizan conversiones.
3-528
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetIfxInt16: Crea una instancia de un objeto IfxInt16 a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-529
Excepciones
3-530
Excepciones
Visual Basic] Public Function GetIfxInt64( _ ByVal i As Integer _
3-531
) As IBM.Data.IfxTypes.IfxInt64 [C#] public IBM.Data.IfxTypes.IfxInt64 GetIfxInt64 (int i) [C++] public: IBM.Data.IfxTypes.IfxInt64 GetIfxInt64( int i ); [JScript] public function GetIfxInt64( i : int ) : IBM.Data.IfxTypes.IfxInt64;
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetIfxReal370: Crea una instancia de un objeto IfxReal370 a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix
3-532

Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-533
Mtodo IfxRecord.GetIfxReal: Crea una instancia de un objeto IfxReal a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Objeto IfxReal que representa el valor de columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura.
3-534
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetIfxRowId: Crea una instancia de un objeto IfxRowId a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxRowId( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxRowId [C#] public IBM.Data.IfxTypes.IfxRowId GetIfxRowId (int i) [C++] public: IBM.Data.IfxTypes.IfxRowId GetIfxRowId( int i ); [JScript] public function GetIfxRowId( i : int ) : IBM.Data.IfxTypes.IfxRowId;
3-535
Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetIfxString: Crea una instancia de un objeto IfxString a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Excepciones
3-536
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetIfxTime: Crea una instancia de un objeto IfxTime a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-537
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetIfxTimeStamp: Crea una instancia de un objeto IfxTimeStamp a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Objeto IfxTimeStamp que representa el valor de la columna. Comentarios No se realizan conversiones.
3-538
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetDataTypeName: Obtiene el nombre del tipo de datos fuente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetDataTypeName( _ ByVal i As Integer _ ) As String [C#] public string GetDataTypeName( int i ); [C++] public: String* GetDataTypeName( int i
3-539
); [JScript] public function GetDataTypeName( i : int ) : String;

Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetDate: Obtiene el valor de la columna especificada como un objeto DateTime. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-540

Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetDateTime: Obtiene el valor de la columna especificada como un objeto DateTime. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-541

Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetDecimal: Obtiene el valor de la columna especificada como un decimal. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetDecimal( _ ByVal i As Integer _ ) As Decimal [C#] public decimal GetDecimal( int i ); [C++]
3-542
public: Decimal GetDecimal( int i ); [JScript] public function GetDecimal( i : int ) : Decimal;

Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetDouble: Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin doble. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-543
Sintaxis
Visual Basic] Public Function GetDouble( _ ByVal i As Integer _ ) As Double [C#] public double GetDouble( int i ); [C++] public: double GetDouble( int i ); [JScript] public function GetDouble( i : int ) : double;
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetFieldType:
3-544
Obtiene el Type que es el tipo de datos del objeto. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis

Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetFloat: Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin simple. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-545
Sintaxis
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetGuid:
3-546
No est soportado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetGuid( _ ByVal i As Integer _ ) As Guid [C#] public Guid GetGuid( int i ); [C++] public: Guid GetGuid( int i ); [JScript] public function GetGuid( i : int ) : Guid;

Comentarios Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetInt16: Obtiene el valor de la columna especificada como un entero con signo de 16 bits.
3-547

Visual Basic] Public Function GetInt16( _ ByVal i As Integer _ ) As Short [C#] public short GetInt16( int i ); [C++] public: short GetInt16( int i ); [JScript] public function GetInt16( i : int ) : Int16;
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-548
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetInt32: Obtiene el valor de la columna especificada como un entero con signo de 32 bits. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetInt32( _ ByVal i As Integer _ ) As Integer [C#] public int GetInt32( int i ); [C++] public: int GetInt32( int i ); [JScript] public function GetInt32( i : int ) : int;
3-549
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetInt64: Obtiene el valor de la columna especificada como un entero con signo de 64 bits. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser de tipo DB2Type.BigInt.
3-550
Tipo de datos Ifx BigInt Tipo de datos Informix INT8, SERIAL8
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetName: Obtiene el nombre de la columna especificada. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Una serie que es el nombre de la columna especificada. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-551
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetOrdinal: Obtiene el ordinal de columna, dado el nombre de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno El ordinal de columna basado en cero. Comentarios GetOrdinal realiza en primer lugar una bsqueda sensible a maysculas y minsculas. Si falla, se realiza una segunda bsqueda no sensible a maysculas y minsculas. GetOrdinal no es sensible al ancho kana. Puesto que las bsquedas basadas en ordinal son ms eficaces que las bsquedas con nombre, no es eficaz llamar a GetOrdinal dentro de un bucle. En su lugar, llame a GetOrdinal una vez y, a continuacin, asigne los resultados a una variable de entero para utilizarla dentro del bucle. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-552
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetString: Obtiene el valor de la columna especificada como una serie de caracteres. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetString( _ ByVal i As Integer _ ) As String [C#] public string GetString( int i ); [C++] public: String* GetString( int i ); [JScript] public function GetString( i : int ) : String;

Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser uno de los siguientes tipos: v IfxType.Xml v IfxType.Char v IfxType.VarChar v IfxType.LongVarChar v IfxType.Clob v IfxType.Graphic v IfxType.VarGraphic
3-553
v IfxType.LongVarGraphic v IfxType.DbClob La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetTime: Obtiene el valor de la columna especificada como un objeto TimeSpan. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-554
Excepciones
Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetTimeSpan: Obtiene el valor de la columna especificada como un objeto TimeSpan. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-555
Excepciones
Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetValue: Obtiene el valor de la columna en el ordinal especificado en su formato nativo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-556
Valor de retorno El valor de la columna en su formato nativo. Comentarios Este mtodo devuelve DBNull para columnas de base de datos nula. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetValue: Obtiene el valor de la columna en el ordinal especificado en su formato nativo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno El valor de la columna en su formato nativo. Comentarios Este mtodo devuelve DBNull para columnas de base de datos nula. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura.
3-557
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetValues: Obtiene todas las columnas de atributos en la fila actual. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Parmetros values Una matriz de tipo Object en la que se deben copiar las columnas de atributos. Valor de retorno El nmero de instancias de Object en la matriz. Comentarios Para la mayora de aplicaciones, el mtodo GetValues proporciona un medio eficaz de recuperar todas las columnas, en lugar de recuperar cada columna individualmente. Puede pasar una matriz Object que contenga menos columnas que el nmero de columnas contenidas en la fila resultante. Slo se copia en la matriz la cantidad de datos que contiene la matriz Object. Tambin se puede pasar una matriz Object cuya longitud sea superior al nmero de columnas contenidas en la fila resultante. Este mtodo devuelve DBNull para columnas de base de datos nula. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura.
3-558
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.GetValues: Obtiene todas las columnas de atributos en la fila actual. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Parmetros values Una matriz de tipo Object en la que se deben copiar las columnas de atributos. Valor de retorno El nmero de instancias de Object en la matriz. Comentarios Para la mayora de aplicaciones, el mtodo GetValues proporciona un medio eficaz de recuperar todas las columnas, en lugar de recuperar cada columna individualmente. Puede pasar una matriz Object que contenga menos columnas que el nmero de columnas contenidas en la fila resultante. Slo se copia en la matriz la cantidad de datos que contiene la matriz Object. Tambin se puede pasar una matriz Object cuya longitud sea superior al nmero de columnas contenidas en la fila resultante. Este mtodo devuelve DBNull para columnas de base de datos nula. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura.
3-559
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxRecord.IsDBNull: Obtiene un valor que indica si la columna contiene valores no existentes o si faltan. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno true si el valor de columna especificado es equivalente a DBNull; de lo contrario, false. Comentarios Para evitar que se emita un error, invoque este mtodo para comprobar si hay valores de columna nulos antes de llamar a los mtodos Get tipificados Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxRecord
Las propiedades de la clase IfxRecord se listan a continuacin.
3-560
Propiedades pblicas
Consulta Miembros de IfxRecord en la pgina 3-510 Representa un registro de slo lectura. Las tablas siguientes listan los miembros expuestos por la clase IfxRecord. Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxRecord.FieldCount: Obtiene el nmero de columnas de la fila actual. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Comentarios Despus de ejecutar una consulta que no devuelve filas, FieldCount devuelve 0. Consulta
3-561
Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxRecord.this: Obtiene el valor de una columna en su formato nativo. Lista de sobrecargas
Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Miembros de IfxRecord en la pgina 3-510 Representa un registro de slo lectura. Las tablas siguientes listan los miembros expuestos por la clase IfxRecord. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxRecord.this (Int32): Obtiene el valor de la columna especificada en su formato nativo dado el ordinal de columna. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Miembros de IfxRecord en la pgina 3-510 Representa un registro de slo lectura. Las tablas siguientes listan los miembros expuestos por la clase IfxRecord. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxRecord.this Obtiene el valor de una columna en su formato nativo. Propiedad IfxRecord.this (String):
3-562
Obtiene el valor de la columna especificada en su formato nativo dado el nombre de columna. Consulta Clase IfxRecord en la pgina 3-509 Representa una nica fila de datos de solo lectura. Miembros de IfxRecord en la pgina 3-510 Representa un registro de slo lectura. Las tablas siguientes listan los miembros expuestos por la clase IfxRecord. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxRecord.this en la pgina 3-562 Obtiene el valor de una columna en su formato nativo.
Clase IfxResultSet
Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.MarshalByRefObject IBM.Data.Informix.IfxResultSet
Sintaxis
Visual Basic] Public Class IfxResultSet [C#] public class IfxResultSet [C++] public class IfxResultSet [JScript] public class IfxResultSet
Comentarios
La clase IfxResultSet permite desplegar corrientes desplazables y actualizables de filas de dato de las aplicaciones. Esto proporciona una alternativa flexible a la utilizacin de un IfxDataReader para leer datos de un servidor de datos. Lo que es ms importante, esto proporciona una alternativa de alto rendimiento a la utilizacin de un DataSet con un IfxDataAdapter para la vinculacin de controles de la aplicacin al servidor de datos. La creacin de una instancia de IfxResultSet es similar a la creacin de un IfxDataAdapter: de una instancia de IfxCommand conectada, el mtodo IfxCommand.ExecuteResultSet devolver un IfxResultSet. Puede establecer varias
3-563
opciones en los mtodos IfxCommand.ExecuteResultSet para determinar las capacidades de un IfxResultSet.
Ejemplo
[C#] El ejemplo siguiente demuestra cmo leer datos de un IfxResultSet desplazable que es sensible a inserciones, actualizaciones y supresiones de otras aplicaciones.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted); if (salesRS.Scrollable) { if (salesRS.ReadLast()) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } } return salesData; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxResultSet Representa un cursor desplazable. Las tablas siguientes listan los miembros expuestos por la clase IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Miembros de IfxResultSet
Representa un cursor desplazable. Las tablas siguientes listan los miembros expuestos por la clase IfxResultSet.
3-564
Propiedades pblicas
CursorType Depth FieldCount HasRows IsClosed IsDeleted RecordsAffected Obtiene un valor que indica si la fila se ha suprimido. Obtiene un valor que indica el nmero de registros afectados por una operacin de supresin, insercin o actualizacin. Obtiene un valor que indica si el cursor es desplazable. Obtiene un valor que indica si el cursor es sensible a las actualizaciones realizadas por la aplicacin y otros cursores. Obtiene un valor que indica si el cursor saltar las filas suprimidas durante la captacin. Sobrecargado. Obtiene el valor de una columna en su formato nativo. Obtiene un valor que indica si el conjunto de resultados se puede actualizar. Tipo de cursor representado por el objeto IfxResultSet. Igual que: Obtiene un valor que indica la profundidad de anidacin para la fila actual. Obtiene el nmero de columnas de la fila actual. Igual que Obtiene un valor que indica si el IfxResultSet contiene una o ms filas. Indica si IfxResultSet est cerrado.
Scrollable Sensitive
SkipDeleted
this Updatable
Mtodos pblicos
Cierra el objeto IfxResultSet. Close Crea un objeto IfxUpdatableRecord. CreateRecord Suprime la fila actual. Delete Cierra la instancia de IfxResultSet. Dispose GetBoolean GetByte GetBytes Obtiene el valor de la columna especificada como un Booleano. Obtiene el valor de la columna especificada como un byte. Lee una corriente de bytes desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio dado.
3-565
GetChar GetChars
Obtiene el valor de la columna especificada como un carcter. Lee una corriente de caracteres desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio dado. Obtiene el nombre del tipo de datos fuente.
GetDataTypeName GetDate GetDateTime GetIfxDate GetIfxDecimal GetIfxDouble GetIfxInt16 GetIfxInt32 GetIfxInt64 GetIfxReal GetIfxReal370 GetIfxString GetIfxTime GetIfxTimeStamp Obtiene el valor de la columna especificada como un objeto DateTime. Obtiene el valor de la columna especificada como un objeto DateTime. Crea una instancia de un objeto IfxDate a partir de los datos de columna. Crea una instancia de un objeto IfxDecimal a partir de los datos de columna. Crea una instancia de un objeto IfxDouble a partir de los datos de columna. Crea una instancia de un objeto IfxInt16 a partir de los datos de columna. Crea una instancia de un objeto IfxInt32 a partir de los datos de columna. Crea una instancia de un objeto IfxInt64 a partir de los datos de columna. Crea una instancia de un objeto IfxReal a partir de los datos de columna. Crea una instancia de un objeto IfxReal370 a partir de los datos de columna. Crea una instancia de un objeto IfxString a partir de los datos de columna. Crea una instancia de un objeto IfxTime a partir de los datos de columna. Crea una instancia de un objeto IfxTimeStamp a partir de los datos de columna. Obtiene el valor de la columna especificada como un decimal. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin doble. Obtiene el Type que es el tipo de datos del objeto. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin simple. No est soportado. GetGuid
3-566
GetInt16 GetInt32 GetInt64 GetName GetOrdinal GetSchemaTable
Obtiene el valor de la columna especificada como un entero con signo de 16 bits. Obtiene el valor de la columna especificada como un entero con signo de 32 bits. Obtiene el valor de la columna especificada como un entero con signo de 64 bits. Obtiene el nombre de la columna especificada. Obtiene el ordinal de columna, dado el nombre de la columna. Devuelve una DataTable que describe los metadatos de columna de la clase IfxResultSet. Obtiene el valor de la columna especificada como una serie de caracteres. Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna en el ordinal especificado en su formato nativo. Obtiene todas las columnas de atributos en la fila actual. Inserta una fila nueva en la tabla.
GetString GetTime GetTimeSpan GetValue GetValues Insert IsDBNull IsSetAsDefault
Obtiene un valor que indica si la columna contiene valores no existentes o si faltan. Determina si la ltima modificacin del valor de la posicin ordinal de la columna especificada ha sido realizada por la funcin SetDefault. Avanza el IfxResultSet hasta el resultado siguiente, al leer los resultados de sentencias de SQL de proceso por lotes. Avanza el IfxResultSet al nuevo registro.
NextResult
Read ReadAbsolute Mueve el IfxResultSet al registro indicado por la posicin especificada, si el cursor es desplazable. Mueve IfxResultSet al primer registro, si el cursor es desplazable. Mueve el IfxResultSet al ltimo registro, si el cursor es desplazable. Mueve el IfxResultSet al registro anterior, si el cursor es desplazable.
ReadFirst ReadLast ReadPrevious
3-567
ReadRelative
Mueve IfxResultSet hasta el registro que se encuentra despus de un nmero de posiciones especificado, si el cursor es desplazable. No est soportado.
SetBoolean No est soportado. SetByte Sobrescriba la columna con un nuevo valor. SetBytes Sobrescriba la columna con un nuevo valor. SetChar Sobrescriba la columna con un nuevo valor. SetChars Sobrescriba la columna con un nuevo valor. SetDate Sobrescriba la columna con un nuevo valor. SetDateTime Sobrescriba la columna con un nuevo valor. SetIfxBinary Sobrescriba la columna con un nuevo valor. SetIfxDate Sobrescriba la columna con un nuevo valor. SetIfxDecimal Sobrescriba la columna con un nuevo valor. SetIfxDouble Sobrescriba la columna con un valor nuevo. SetIfxInt16 Sobrescriba la columna con un valor nuevo. SetIfxInt32 Sobrescriba la columna con un valor nuevo. SetIfxInt64 Sobrescriba la columna con un valor nuevo. SetIfxReal Sobrescriba la columna con un valor nuevo. SetIfxReal370 Sobrescriba la columna con un valor nuevo. SetIfxString Sobrescriba la columna con un valor nuevo. SetIfxTime Sobrescriba la columna con un nuevo valor. SetIfxTimeStamp Sobrescriba la columna con un nuevo valor. SetDecimal Sobrescriba la columna con un nuevo valor. SetDefault
3-568
Sobrescriba la columna con un nuevo valor. SetDouble Sobrescriba la columna con un nuevo valor. SetFloat No est soportado. SetGuid Sobrescriba la columna con un nuevo valor. SetInt16 Sobrescriba la columna con un nuevo valor. SetInt32 Sobrescriba la columna con un nuevo valor. SetInt64 Sobrescriba la columna con un nuevo valor. SetNull Sobrescriba la columna con un nuevo valor. SetString Sobrescriba la columna con un nuevo valor. SetTime Sobrescriba la columna con un nuevo valor. SetTimeSpan Sobrescriba la columna con un nuevo valor. SetValue SetValues Update Sobrescriba las columnas con nuevos valores. Enve las actualizaciones pendientes para el registro actual a la fila subyacente del servidor de la base de datos.
Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxResultSet
Los mtodos de la clase IfxResultSet se listan a continuacin.
Mtodos pblicos
Cierra el objeto IfxResultSet. Close Crea un objeto IfxUpdatableRecord. CreateRecord
3-569
Suprime la fila actual. Delete Cierra la instancia de IfxResultSet. Dispose GetBoolean GetByte GetBytes Obtiene el valor de la columna especificada como un Booleano. Obtiene el valor de la columna especificada como un byte. Lee una corriente de bytes desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio dado. Obtiene el valor de la columna especificada como un carcter. Lee una corriente de caracteres desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio dado. Obtiene el nombre del tipo de datos fuente. GetDataTypeName GetDate GetDateTime GetIfxDate GetIfxDecimal GetIfxDouble GetIfxInt16 GetIfxInt32 GetIfxInt64 GetIfxReal GetIfxReal370 GetIfxString GetIfxTime Obtiene el valor de la columna especificada como un objeto DateTime. Obtiene el valor de la columna especificada como un objeto DateTime. Crea una instancia de un objeto IfxDate a partir de los datos de columna. Crea una instancia de un objeto IfxDecimal a partir de los datos de columna. Crea una instancia de un objeto IfxDouble a partir de los datos de columna. Crea una instancia de un objeto IfxInt16 a partir de los datos de columna. Crea una instancia de un objeto IfxInt32 a partir de los datos de columna. Crea una instancia de un objeto IfxInt64 a partir de los datos de columna. Crea una instancia de un objeto IfxReal a partir de los datos de columna. Crea una instancia de un objeto IfxReal370 a partir de los datos de columna. Crea una instancia de un objeto IfxString a partir de los datos de columna. Crea una instancia de un objeto IfxTime a partir de los datos de columna.
GetChar GetChars
3-570
GetIfxTimeStamp
Crea una instancia de un objeto IfxTimeStamp a partir de los datos de columna. Obtiene el valor de la columna especificada como un decimal. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin doble. Obtiene el Type que es el tipo de datos del objeto. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin simple. No est soportado.
GetGuid GetInt16 GetInt32 GetInt64 GetName GetOrdinal GetSchemaTable Obtiene el valor de la columna especificada como un entero con signo de 16 bits. Obtiene el valor de la columna especificada como un entero con signo de 32 bits. Obtiene el valor de la columna especificada como un entero con signo de 64 bits. Obtiene el nombre de la columna especificada. Obtiene el ordinal de columna, dado el nombre de la columna. Devuelve una DataTable que describe los metadatos de columna de la clase IfxResultSet. Obtiene el valor de la columna especificada como una serie de caracteres. Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna en el ordinal especificado en su formato nativo. Obtiene todas las columnas de atributos en la fila actual. Inserta una fila nueva en la tabla. Insert IsDBNull IsSetAsDefault Obtiene un valor que indica si la columna contiene valores no existentes o si faltan. Determina si la ltima modificacin del valor de la posicin ordinal de la columna especificada ha sido realizada por la funcin SetDefault.
GetString GetTime GetTimeSpan GetValue GetValues
3-571
NextResult
Avanza el IfxResultSet hasta el resultado siguiente, al leer los resultados de sentencias de SQL de proceso por lotes. Avanza el IfxResultSet al nuevo registro.
Read ReadAbsolute Mueve el IfxResultSet al registro indicado por la posicin especificada, si el cursor es desplazable. Mueve IfxResultSet al primer registro, si el cursor es desplazable. Mueve el IfxResultSet al ltimo registro, si el cursor es desplazable. Mueve el IfxResultSet al registro anterior, si el cursor es desplazable. Mueve IfxResultSet hasta el registro que se encuentra despus de un nmero de posiciones especificado, si el cursor es desplazable. No est soportado. SetBoolean No est soportado. SetByte Sobrescriba la columna con un nuevo valor. SetBytes Sobrescriba la columna con un nuevo valor. SetChar Sobrescriba la columna con un nuevo valor. SetChars Sobrescriba la columna con un nuevo valor. SetDate Sobrescriba la columna con un nuevo valor. SetDateTime Sobrescriba la columna con un nuevo valor. SetIfxBinary Sobrescriba la columna con un nuevo valor. SetIfxDate Sobrescriba la columna con un nuevo valor. SetIfxDecimal Sobrescriba la columna con un nuevo valor. SetIfxDouble Sobrescriba la columna con un valor nuevo. SetIfxInt16 Sobrescriba la columna con un valor nuevo. SetIfxInt32 Sobrescriba la columna con un valor nuevo. SetIfxInt64
ReadFirst ReadLast ReadPrevious ReadRelative
3-572
Sobrescriba la columna con un valor nuevo. SetIfxReal Sobrescriba la columna con un valor nuevo. SetIfxReal370 Sobrescriba la columna con un valor nuevo. SetIfxString Sobrescriba la columna con un valor nuevo. SetIfxTime Sobrescriba la columna con un nuevo valor. SetIfxTimeStamp Sobrescriba la columna con un nuevo valor. SetDecimal Sobrescriba la columna con un nuevo valor. SetDefault Sobrescriba la columna con un nuevo valor. SetDouble Sobrescriba la columna con un nuevo valor. SetFloat No est soportado. SetGuid Sobrescriba la columna con un nuevo valor. SetInt16 Sobrescriba la columna con un nuevo valor. SetInt32 Sobrescriba la columna con un nuevo valor. SetInt64 Sobrescriba la columna con un nuevo valor. SetNull Sobrescriba la columna con un nuevo valor. SetString Sobrescriba la columna con un nuevo valor. SetTime Sobrescriba la columna con un nuevo valor. SetTimeSpan Sobrescriba la columna con un nuevo valor. SetValue SetValues Update Sobrescriba las columnas con nuevos valores. Enve las actualizaciones pendientes para el registro actual a la fila subyacente del servidor de la base de datos.
Consulta Miembros de IfxResultSet en la pgina 3-564 Representa un cursor desplazable. Las tablas siguientes listan los miembros expuestos por la clase IfxResultSet.
3-573
Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.Close: Cierra el objeto IfxResultSet. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub Close() [C#] public void Close(); [C++] public: void Close(); [JScript] public function Close();
Comentarios Debe llamar explcitamente al mtodo Close cuando termine de utilizar IfxDataReader o IfxResultSet para poder utilizar el IfxCommand asociado para cualquier otra finalidad. Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection, un IfxCommand y un IfxDataReader. El ejemplo lee los datos y los escribe en la consola. Finalmente, el ejemplo cierra el IfxDataReader y luego la IfxConnection.
Visual Basic] Public Sub ReadMyData(myConnString As String) Dim mySelectQuery As String = "SELECT ID, NAME FROM STAFF" Dim myConnection As New IfxConnection(myConnString) Dim myCommand As New IfxCommand(mySelectQuery, myConnection) myConnection.Open() Dim myReader As IfxDataReader myReader = myCommand.ExecuteReader() Always call Read before accessing data. While myReader.Read() Console.WriteLine(myReader.GetInt16(0).ToString() + ", " _ + myReader.GetString(1)) End While always call Close when done reading. myReader.Close() Close the connection when done with it. myConnection.Close() End Sub [C#]
3-574
public void ReadMyData(string myConnString) { string mySelectQuery = "SELECT ID, NAME FROM STAFF"; IfxConnection myConnection = new IfxConnection(myConnString); IfxCommand myCommand = new IfxCommand(mySelectQuery,myConnection); myConnection.Open(); IfxDataReader myReader; myReader = myCommand.ExecuteReader(); // Always call Read before accessing data. while (myReader.Read()) { Console.WriteLine(myReader.GetInt16(0) + ", " + myReader.GetString(1)); } // always call Close when done reading. myReader.Close(); // Close the connection when done with it. myConnection.Close(); }
Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.CreateRecord: Crea una instancia de IfxUpdatableRecord que se utilizar para la creacin de una nueva fila en IfxResultSet. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function CreateRecord As IfxUpdatableRecord [C#] public IfxUpdatableRecord CreateRecord () [C++] public: IfxUpdatableRecord CreateRecord () [JScript] public function CreateRecord () : IfxUpdatableRecord
Valor de retorno instancia de IfxUpdatableRecord. Excepciones

Tipo de excepcin InvalidOperationException Condicin Es necesario un cursor actualizable.
3-575
Comentarios Se puede crear y manipular mltiples instancias de IfxUpdatableRecord simultneamente. Ejemplo [C#] El ejemplo siguiente demuestra cmo insertar una nueva fila en una instancia de IfxResultSet, siempre que el servidor d soporte a los cursores actualizables.
[C#] public static void insertSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted | IfxResultSetOptions.Updatable); if (salesRS.Updatable) { IfxUpdatableRecord updatableSale = salesRS.CreateRecord(); updatableSale.SetIfxDate(0, new IfxDate(DateTime.Now)); updatableSale.SetIfxString(1, new IfxString("Erik")); updatableSale.SetIfxString(2, new IfxString( "Ontario-South")); updatableSale.SetIfxInt32(3, new IfxInt32(2)); salesRS.Insert(updatableSale); } return; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.Delete: Suprime la fila actual a la que apunta IfxResultSet. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-576
Sintaxis
Visual Basic] Public Sub Delete [C#] public void Delete () [C++] public: void Delete () [JScript] public function Delete ()
Excepciones
Tipo de excepcin InvalidOperationException InvalidOperationException Condicin Es necesario un cursor actualizable. No existen datos para la fila/columna. El cursor IfxResulSet no est colocado en un registro. Se ha intentado una operacin de supresin de una fila que se ha suprimido.
InvalidOperationException
Comentarios Despus de la supresin, el cursor permanece en la posicin de la fila suprimida actual. Todas las funciones Get y Set emitirn una excepcin hasta que el cursor se traslade fuera de la fila suprimida. Ejemplo [C#] El ejemplo siguiente demuestra cmo suprimir una fila de una instancia de IfxResultSet, siempre que el servidor d soporte a cursores actualizables.
[C#] public static void deleteSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxCursorType.Keyset); if (salesRS.ReadLast()) { if (salesRS.Updatable) { salesRS.Delete(); } } return; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de
3-577
filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.Dispose: Cierra la instancia de IfxResultSet. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetBoolean: Obtiene el valor de la columna especificada como un Booleano. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetBoolean( _ ByVal i As Integer _ ) As Boolean
3-578
[C#] public bool GetBoolean( int i ); [C++] public: bool GetBoolean( int i ); [JScript] public function GetBoolean( i : int ) : Boolean;

Comentarios Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetByte: Obtiene el valor de la columna especificada como un byte. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetByte( _ ByVal i As Integer _ ) As Byte [C#]
3-579
public byte GetByte( int i ); [C++] public: unsigned char GetByte( int i ); [JScript] public function GetByte( i : int ) : Byte;

Comentarios Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetBytes: Lee una corriente de bytes desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio determinado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetBytes( _ ByVal i As Integer, _ ByVal dataIndex As Long, _
3-580
ByVal buffer() As Byte, _ ByVal bufferIndex As Integer, _ ByVal length As Integer _ ) As Long [C#] public long GetBytes( int i, long dataIndex, byte[] buffer, int bufferIndex, int length ); [C++] public: __int64 GetBytes( int i, __int64 dataIndex, unsigned char buffer __gc[], int bufferIndex, int length ); [JScript] public function GetBytes( i : int, dataIndex : long, buffer : Byte[], bufferIndex : int, length : int ) : long;
Comentarios GetBytes devuelve el nmero de bytes disponibles en el campo. En la mayora de casos esta es la longitud exacta del campo. Sin embargo, el nmero devuelto puede ser menor que la longitud verdadera del campo si GetBytes ya se ha utilizado para obtener bytes del campo. Este caso puede darse, por ejemplo, si IfxDataReader est leyendo un BLOB en un almacenamiento intermedio. Para obtener ms informacin, consulte el valor SequentialAccess de System.Data.CommandBehavior en la documentacin del SDK de Microsoft(R) .NET Framework.
3-581
Si especifica un almacenamiento intermedio que es un valor nulo, GetBytes devuelve la longitud del campo en bytes. No se realizan conversiones. El tipo de los datos que se deben recuperar debe ser uno de los siguientes: v IfxType.Blob La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetChar: Obtiene el valor de la columna especificada como un carcter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno El valor de la columna especificada como un carcter.
3-582
Excepciones
Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser uno de los siguientes tipos: v IfxType.Char v v v IfxType.VarChar IfxType.LongVarChar IfxType.Clob
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetChars: Lee una corriente de caracteres desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio determinado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-583
Sintaxis
Comentarios GetChars devuelve el nmero de caracteres disponibles en el campo. En la mayora de casos esta es la longitud exacta del campo. Sin embargo, el nmero devuelto puede ser inferior a la longitud verdadera del campo si GetChars ya se ha
3-584
utilizado para obtener caracteres del campo. Este caso puede darse, por ejemplo, si IfxDataReader est leyendo un CLOB en un almacenamiento intermedio. Para obtener ms informacin, consulte el valor SequentialAccess de System.Data.CommandBehavior en la documentacin del SDK de Microsoft(R) .NET Framework. Si pasa un almacenamiento intermedio que es un valor nulo, GetChars devuelve la longitud del campo en caracteres. No se realizan conversiones. Los datos que se van a recuperar deben ser uno de los siguientes tipos: v IfxType.Char v IfxType.VarChar v IfxType.LongVarChar v IfxType.Clob La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxBinary: Crea una instancia de un objeto IfxBinary a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxBinary( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxBinary [C#] public IBM.Data.IfxTypes.IfxBinary GetIfxBinary (int i) [C++] public: IBM.Data.IfxTypes.IfxBinary GetIfxBinary(
3-585
int i ); [JScript] public function GetIfxBinary( i : int ) : IBM.Data.IfxTypes.IfxBinary;
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxBlob: Crea una instancia de un objeto IfxBlob a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxBlob( _ ByVal i As Integer _
3-586
) As IBM.Data.IfxTypes.IfxBlob [C#] public IBM.Data.IfxTypes.IfxBlob GetIfxBlob (int i) [C++] public: IBM.Data.IfxTypes.IfxBlob GetIfxBlob( int i ); [JScript] public function GetIfxBlob( i : int ) : IBM.Data.IfxTypes.IfxBlob;
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxClob: Crea una instancia de un objeto IfxClob a partir de los datos de columna.
3-587

Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas.
3-588
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxDate: Crea una instancia de un objeto IfxDate a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Excepciones
3-589
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxDecimal: Crea una instancia de un objeto IfxDecimal a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-590
Tipo de datos Ifx IfxDecimal
Tipo de datos Informix MONEY
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxDouble: Crea una instancia de un objeto IfxDouble a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-591
Valor de retorno Objeto IfxDouble que representa el valor de columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxInt16: Crea una instancia de un objeto IfxInt16 a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-592
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxInt32: Crea una instancia de un objeto IfxInt32 a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-593
Sintaxis
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxInt64:
3-594
Crea una instancia de un objeto IfxInt64 a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Excepciones
3-595
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxReal370: Crea una instancia de un objeto IfxReal370 a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Excepciones
3-596
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxReal: Crea una instancia de un objeto IfxReal a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-597
Tipo de datos Ifx IfxReal
Tipo de datos Informix REAL, SMALLFLOAT
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxRowId: Crea una instancia de un objeto IfxRowId a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-598
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxString: Crea una instancia de un objeto IfxString a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-599
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxTime: Crea una instancia de un objeto IfxTime a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxTime( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxTime [C#] public IBM.Data.IfxTypes.IfxTime GetIfxTime (int i)
3-600
[C++] public: IBM.Data.IfxTypes.IfxTime GetIfxTime( int i ); [JScript] public function GetIfxTime( i : int ) : IBM.Data.IfxTypes.IfxTime;
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Metodo IfxResultSet.GetIfxTimeStamp: Crea una instancia de un objeto IfxTimeStamp a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix
3-601

3-602
Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetIfxValue: Crea una instancia de Object a partir de datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Objeto (object) que representa el valor de la columna en su formato nativo. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-603
Mtodo IfxResultSet.GetIfxValues: Obtiene todos los valores de las columnas correspondientes a la fila actual. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Parmetros values Matriz de Object en la que se copiarn los valores de las columnas correspondientes a la fila actual. Valor de retorno Nmero de instancias de Object de la matriz. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetDataTypeName: Obtiene el nombre del tipo de datos fuente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-604
Sintaxis

Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetDate: Obtiene el valor de la columna especificada como un objeto DateTime. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetDate( _ ByVal i As Integer _ ) As DateTime [C#] public DateTime GetDate( int i
3-605
); [C++] public: DateTime GetDate( int i ); [JScript] public function GetDate( i : int ) : DateTime;

Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetDateTime: Obtiene el valor de la columna especificada como un objeto DateTime. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-606
Sintaxis

Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-607
Mtodo IfxResultSet.GetDecimal: Obtiene el valor de la columna especificada como un decimal. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis

Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta
3-608
Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetDouble: Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin doble. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser de tipo DB2Type.Double.
3-609
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetFieldType: Obtiene el Type que es el tipo de datos del objeto. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno El Type que es el tipo de datos del objeto.
3-610
Excepciones
Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetFloat: Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin simple. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-611
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetGuid: No est soportado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-612

Comentarios Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetInt16: Obtiene el valor de la columna especificada como un entero con signo de 16 bits. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-613
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetInt32: Obtiene el valor de la columna especificada como un entero con signo de 32 bits. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetInt32( _ ByVal i As Integer _ ) As Integer [C#] public int GetInt32(
3-614
int i ); [C++] public: int GetInt32( int i ); [JScript] public function GetInt32( i : int ) : int;
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetInt64: Obtiene el valor de la columna especificada como un entero con signo de 64 bits. Espacio de nombres: IBM.Data.Informix
3-615

Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-616
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetName: Obtiene el nombre de la columna especificada. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Una serie que es el nombre de la columna especificada. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetOrdinal: Obtiene el ordinal de columna, dado el nombre de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-617
Sintaxis
Valor de retorno El ordinal de columna basado en cero. Comentarios GetOrdinal realiza en primer lugar una bsqueda sensible a maysculas y minsculas. Si falla, se realiza una segunda bsqueda no sensible a maysculas y minsculas. GetOrdinal no es sensible al ancho kana. Puesto que las bsquedas basadas en ordinal son ms eficaces que las bsquedas con nombre, no es eficaz llamar a GetOrdinal dentro de un bucle. En su lugar, llame a GetOrdinal una vez y, a continuacin, asigne los resultados a una variable de entero para utilizarla dentro del bucle. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetSchemaTable: Devuelve una DataTable que describe los metadatos de columna de la clase IfxResultSet. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-618
Sintaxis
Visual Basic] Public Function GetSchemaTable() As DataTable [C#] public DataTable GetSchemaTable(); [C++] public: DataTable* GetSchemaTable(); [JScript] public function GetSchemaTable() : DataTable;
Valor de retorno Una DataTable que describe los metadatos de columna. Excepciones
Tipo de excepcin InvalidOperationException Condicin IfxDataReader est cerrado.
Comentarios El mtodo GetSchemaTable devuelve metadatos sobre cada columna en el orden siguiente:
DataReader ColumnName Descripcin El nombre de la columna; podra no ser exclusivo. Si no se puede determinar el nombre de la columna, se devuelve un valor nulo. Este nombre siempre refleja la nomenclatura ms reciente de la columna en la vista o texto de mandato actual. El ordinal de la columna. Es cero para la columna de marcadores de la fila, si es que la hay. Otras columnas se numeran empezando por 1. Esta columna no puede contener un valor nulo. La longitud mxima posible de un valor en la columna. Para columnas que utilizan un tipo de datos de longitud fija, es el tamao del tipo de datos. Si DbType es un tipo de datos numrico, es la mxima precisin de la columna. La precisin depende de la definicin de la columna. Si DbType no es un tipo de datos numrico, es un valor nulo. Si DbType es Decimal, el nmero de dgitos a la derecha de la coma decimal. De lo contrario, es un valor nulo. Se correlaciona con el tipo en tiempo de ejecucin de lenguaje comn de DbType. Enumeracin de IfxType. true si la columna contiene un BLOB (Binary Large ObjectB) que contiene datos muy grandes.
ColumnOrdinal
ColumnSize
NumericPrecision
NumericScale
DataType ProviderType IsLong
3-619
DataReader AllowDBNull
Descripcin true si el consumidor puede establecer la columna en un valor nulo o si el controlador no puede determinar si el consumidor puede establecer la columna en un valor nulo. De lo contrario, false. Una columna puede contener valores nulos, incluso si no se puede establecer en un valor nulo. true si la columna se puede modificar; de lo contrario false. Establecido si la columna contiene un identificador de filas persistente en el que no se puede grabar, y no tiene valor con significado excepto para identificar la fila. true: Dos filas de la tabla base (la tabla devuelta en BaseTableName) no pueden tener el mismo valor en esta columna. Se garantiza que IsUnique ser true si la columna constituye una clave en si misma o si hay una restriccin de tipo UNIQUE que slo se aplica a esta columna. false: La columna puede contener valores duplicados en la tabla base. El valor por omisin para esta columna es false. true: Se trata de una columna del conjunto de columnas del conjunto de filas que, combinadas, identifican exclusivamente la fila. El conjunto de columnas con IsKey establecido en true debe identificar exclusivamente una fila del conjunto de filas. No hay ningn requisito para que este conjunto de columnas sea un conjunto mnimo de columnas. Este conjunto de columnas puede ser generado desde una clave primaria de tabla base, una restriccin exclusiva o un ndice exclusivo. false: La columna no es necesaria para identificar de forma exclusiva la fila. true si la columna asigna valores a las nuevas filas en incrementos fijos; de lo contrario false. El valor por omisin para esta columna es false. El nombre del esquema en la base de datos que contiene la columna. NULL si el nombre de esquema base no se puede determinar. El valor por omisin para esta columna es un valor nulo. El nombre del catlogo en la base de datos que contiene la columna. NULL si el nombre de catlogo base no se puede determinar. El valor por omisin para esta columna es un valor nulo.
IsReadOnly IsRowVersion
IsUnique
IsKey
IsAutoIncrement
BaseSchemaName
BaseCatalogName
3-620
DataReader BaseTableName
Descripcin El nombre de la tabla o vista en la base de datos que contiene la columna. Un valor nulo si el nombre de la tabla base no se puede determinar. El valor por omisin de esta columna es un valor nulo. El nombre de la columna en la base de datos. Podra ser diferente del nombre de columna devuelto en la columna ColumnName si se ha utilizado un alias. Un valor nulo si el nombre de columna base no se puede determinar o si la columna de conjunto de filas deriva, pero no es idntica, a una columna en la base de datos. El valor por omisin para esta columna es un valor nulo.
BaseColumnName
Se devolver una fila para cada columna en el conjunto de resultados. IfxCommandBuilder necesita la identificacin correcta de las claves primarias de la tabla para poder funcionar correctamente. Si no se devuelve BaseTableName para cada columna en los resultados de la consulte, IBM Data Server Provider for .NET intentar analizar la sentencia de SQL para encontrar los nombres de tabla implicados en la consulta. Esto funciona con sentencias UPDATE, INSERT, DELETE y con sentencias SELECT simples, pero no con procedimientos almacenados ni con sentencias SELECT basadas en uniones. En los casos en los que falta parte o toda la informacin de esquema en esta tabla, IfxCommandBuilder no funcionar correctamente, ya que no tiene suficiente informacin para generar automticamente las sentencias INSERT, UPDATE o DELETE correctas. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetString: Obtiene el valor de la columna especificada como una serie de caracteres. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetString( _ ByVal i As Integer _ ) As String
3-621
[C#] public string GetString( int i ); [C++] public: String* GetString( int i ); [JScript] public function GetString( i : int ) : String;

Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser uno de los siguientes tipos: v v v v v v v v v IfxType.Xml IfxType.Char IfxType.VarChar IfxType.LongVarChar IfxType.Clob IfxType.Graphic IfxType.VarGraphic IfxType.LongVarGraphic IfxType.DbClob
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta
3-622
Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetTime: Obtiene el valor de la columna especificada como un objeto TimeSpan. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Excepciones
3-623
Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetTimeSpan: Obtiene el valor de la columna especificada como un objeto TimeSpan. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Excepciones
3-624
Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetValue: Obtiene el valor de la columna en el ordinal especificado en su formato nativo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno El valor de la columna en su formato nativo. Comentarios Este mtodo devuelve DBNull para columnas de base de datos nula. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-625
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.GetValues: Obtiene todas las columnas de atributos en la fila actual. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Parmetros values Una matriz de tipo Object en la que se deben copiar las columnas de atributos. Valor de retorno El nmero de instancias de Object en la matriz. Comentarios Para la mayora de aplicaciones, el mtodo GetValues proporciona un medio eficaz de recuperar todas las columnas, en lugar de recuperar cada columna individualmente. Puede pasar una matriz Object que contenga menos columnas que el nmero de columnas contenidas en la fila resultante. Slo se copia en la matriz la cantidad de datos que contiene la matriz Object. Tambin se puede pasar una matriz Object cuya longitud sea superior al nmero de columnas contenidas en la fila resultante. Este mtodo devuelve DBNull para columnas de base de datos nula. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas.
3-626
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.Insert: Inserta una nueva fila en el conjunto de resultados y su tabla correspondiente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub Insert (updatableRecord As IfxUpdatableRecord) [C#] public void Insert (IfxUpdatableRecord updatableRecord) [C++] public: void Insert (IfxUpdatableRecord* updatableRecord) [JScript] public function Insert (updatableRecord: IfxUpdatableRecord)
Parmetros updatableRecord instancia de IfxUpdatableRecord, que representa una nueva fila que se insertar en el conjunto de resultados. Comentarios Una instancia de IfxUpdatableRecord solo puede ser insertada por la instancia de IfxResultSet que la ha creado. La posicin del cursor de la instancia de IfxResultSet no cambia cuando se inserta una nueva fila. Ejemplo [C#] El ejemplo siguiente demuestra cmo insertar una nueva fila en una instancia de IfxResultSet, siempre que el servidor d soporte a los cursores actualizables.
[C#] public static void insertSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted | IfxResultSetOptions.Updatable); if (salesRS.Updatable) { IfxUpdatableRecord updatableSale = salesRS.CreateRecord(); updatableSale.SetIfxDate(0, new IfxDate(DateTime.Now));
3-627
updatableSale.SetIfxString(1, new IfxString("Erik")); updatableSale.SetIfxString(2, new IfxString( "Ontario-South")); updatableSale.SetIfxInt32(3, new IfxInt32(2)); salesRS.Insert(updatableSale); } return; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.IsDBNull: Obtiene un valor que indica si la columna contiene valores no existentes o si faltan. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno true si el valor de columna especificado es equivalente a DBNull; de lo contrario, false.
3-628
Comentarios Para evitar que se emita un error, invoque este mtodo para comprobar si hay valores de columna nulos antes de llamar a los mtodos Get tipificados Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.IsSetAsDefault: Determina si la ltima modificacin del valor de la columna especificada ha sido realizada por la funcin SetDefault. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function IsSetAsDefault (Integer i) As Boolean [C#] public bool IsSetAsDefault (int i) [C++] public: virtual bool IsSetAsDefault (int i) [JScript] public function IsSetAsDefault (i: int) : Boolean
Valor de retorno true si la ltima modificacin del valor de la columna especificada ha sido realizada por la funcin SetDefault; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-629
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.NextResult: Avanza el IfxResultSet hasta el resultado siguiente, al leer los resultados de sentencias de SQL de proceso por lotes. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function NextResult() As Boolean [C#] public bool NextResult(); [C++] public: bool NextResult(); [JScript] public function NextResult() : Boolean;
Valor de retorno true si hay ms conjuntos de resultados; de lo contrario, false. Comentarios Utilizado para procesar mltiples resultados, que se pueden generar ejecutando sentencias de SQL de proceso por lotes o un procedimiento almacenados de mltiples conjuntos de resultados. Por omisin, IfxDataReader se sita en el primer resultado. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.ReadAbsolute: Mueve el IfxResultSet al registro indicado por la posicin especificada, si el cursor es desplazable. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-630
Sintaxis
Visual Basic] Public Function ReadAbsolute (Integer position) As Boolean [C#] public bool ReadAbsolute (long position) [C++] public: bool ReadAbsolute (long position) [JScript] public function ReadAbsolute (position: Integer) : Boolean
Parmetros position Posicin de la fila relativa al principio del conjunto de resultados. Valor de retorno true si la posicin que se acaba de asumir tiene un registro (independientemente de si se ha suprimido); de lo contrario, false. Ejemplo [C#] El ejemplo siguiente demuestra cmo determinar si la instancia de IfxResultSet es desplazable y luego cmo leer una fila determinada en base a su posicin en el conjunto de resultados.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted); if (salesRS.Scrollable) { if (salesRS.ReadAbsolute(3)) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } } return salesData; }
3-631
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.ReadFirst: Mueve IfxResultSet al primer registro, si el cursor es desplazable. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function ReadFirst As Boolean [C#] public bool ReadFirst () [C++] public: bool ReadFirst () [JScript] public function ReadFirst () : Boolean
Valor de retorno true si la posicin que se acaba de asumir tiene un registro (independientemente de si se ha suprimido); de lo contrario, false. Comentarios Para cursores no desplazables, el mtodo ReadFirst devolver true y mover el primer registro si el cursor no ha ledo an un registro del conjunto de resultados. Si el cursor est en la primera fila del conjunto de resultados, ReadFirst devolver true y permanecer en la primera fila. Si el cursor est en cualquier otro fila del conjunto de resultados, ReadFirst emitir una excepcin. La posicin por omisin de IfxResultSet es anterior al primer registro. Por lo tanto, debe llamar a Read, ReadFirst, ReadLast o ReadAbsolute antes que a los datos. Ejemplo [C#] El ejemplo siguiente demuestra cmo determinar si la instancia de IfxResultSet es desplazable y, a continuacin, cmo leer la primera fila del conjunto de resultados.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted); if (salesRS.Scrollable)
3-632
{ if (salesRS.ReadFirst()) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } } return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.ReadLast: Mueve el IfxResultSet al ltimo registro, si el cursor es desplazable. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function ReadLast As Boolean [C#] public bool ReadLast () [C++] public: bool ReadLast () [JScript] public function ReadLast () : Boolean
Valor de retorno true si la posicin que se acaba de asumir tiene un registro (independientemente de si se ha suprimido); de lo contrario, false. Comentarios La posicin por omisin de IfxResultSet es anterior al primer registro. Por lo tanto, debe llamar a Read, ReadFirst, ReadLast o ReadAbsolute antes que a los datos.
3-633
Ejemplo [C#] El ejemplo siguiente demuestra cmo determinar si la instancia de IfxResultSet es desplazable y luego cmo leer la ltima fila del conjunto de resultados.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted); if (salesRS.Scrollable) { if (salesRS.ReadLast()) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } } return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.Read: Avanza el IfxResultSet al nuevo registro. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function Read As Boolean [C#] public bool Read () [C++]
3-634
public: bool Read () [JScript] public function Read () : Boolean
Valor de retorno true si la posicin que se acaba de asumir tiene un registro (independientemente de si se ha suprimido); de lo contrario, false. Comentarios La posicin por omisin de IfxResultSet es anterior al primer registro. Por lo tanto, debe llamar a Read, ReadFirst, ReadLast o ReadAbsolute antes que a los datos. Ejemplo [C#] El ejemplo siguiente demuestra cmo leer la fila siguiente del conjunto de resultados.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted); if (salesRS.Scrollable) { if (salesRS.Read()) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } } return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.ReadPrevious:
3-635
Mueve el IfxResultSet al registro anterior, si el cursor es desplazable. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function Read As Boolean [C#] public bool Read () [C++] public: bool Read () [JScript] public function Read () : Boolean
Valor de retorno true si la posicin que se acaba de asumir tiene un registro (independientemente de si se ha suprimido); de lo contrario, false. Comentarios El cursor debe estar colocado en el conjunto de resultados; de lo contrario la ejecucin de este mtodo emitir una excepcin. Ejemplo [C#] El ejemplo siguiente demuestra cmo leer la penltima fila del conjunto de resultados.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted); if (salesRS.Scrollable) { if (salesRS.ReadLast()) { salesRS.ReadPrevious(); salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } } return salesData; }
3-636
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.ReadRelative: Mueve IfxResultSet hasta el registro que se encuentra despus de un nmero de posiciones especificado, si el cursor es desplazable. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function ReadRelative (Integer position) As Boolean [C#] public bool ReadRelative (long position) [C++] public: bool ReadRelative (long position) [JScript] public function ReadRelative (position: Integer) : Boolean
Parmetros position Posicin de la fila relativa a la posicin del cursor actual en el conjunto de resultados. Valor de retorno true si la posicin que se acaba de asumir tiene un registro (independientemente de si se ha suprimido); de lo contrario, false. Comentarios El cursor debe estar colocado en el conjunto de resultados; de lo contrario la ejecucin de este mtodo emitir una excepcin. La fila actual se renueva si el desplazamiento es cero. Un desplazamiento negativo mover el cursor hacia el principio del conjunto de resultados. Un desplazamiento positivo mover el cursor hacia el final del conjunto de resultados.
3-637
Ejemplo [C#] El ejemplo siguiente demuestra cmo determinar si la instancia de IfxResultSet es desplazable y luego cmo leer una fila determinada en base a su posicin relativa a la posicin actual del cursor.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted); if (salesRS.Scrollable) { if (salesRS.ReadLast()) { salesRS.ReadAbsolute(-2); salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } } return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetBoolean: No est soportado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetBoolean ( _ i As Integer, _ value As Boolean _
3-638
) [C#] public void SetBoolean ( int i, bool value ) [C++] public: virtual void SetBoolean ( int i, bool value ) [JScript] public function SetBoolean ( i : int, value : boolean )
Parmetros i value El ordinal de columna basado en cero. Valor que se insertar en la columna especificada.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetByte: No est soportado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetByte ( _ i As Integer, _ value As Byte _ ) [C#] public void SetByte ( int i, byte value ) [C++] public:
3-639
virtual void SetByte ( int i, byte value ) [JScript] public function SetByte ( i : int, value : byte )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetBytes: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetBytes ( _ i As Integer, _ buffer() As Byte () _ ) [C#] public void SetBytes ( int i, byte[] buffer ) [C++] public: virtual void SetBytes ( int i, unsigned char buffer __gc[] ) [JScript]
3-640
public function SetBytes ( i : int, buffer : Byte[] )
buffer Valor que se insertar en la columna especificada. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetChar: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetChar ( _ i As Integer, _ value As Char _ ) [C#] public void SetChar ( int i, char value ) [C++] public: virtual void SetChar ( int i, wchar_t value ) [JScript] public function SetChar ( i : int, value : char )

3-641
value
Valor que se insertar en la columna especificada.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetChars: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetChars ( _ i As Integer, _ buffer() As Char() _ ) [C#] public void SetChars ( int i, char[] buffer ) [C++] public: virtual void SetChars ( int i, unsigned char buffer __gc[] ) [JScript] public function SetChars ( i : int, buffer : char[] )
buffer Valor que se insertar en la columna especificada. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta
3-642
Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetIfxBinary: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxBinary ( _ i As Integer, _ value As IfxBinary _ ) [C#] public void SetIfxBinary ( int i, IfxBinary value ) [C++] public: virtual void SetIfxBinary ( int i, IfxBinary value ) [JScript] public function SetIfxBinary ( i : int, value : IfxBinary )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-643
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetIfxDate: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxDate ( _ i As Integer, _ value As IfxDate _ ) [C#] public void SetIfxDate ( int i, IfxDate value ) [C++] public: virtual void SetIfxDate ( int i, IfxDate value ) [JScript] public function SetIfxDate ( i : int, value : IfxDate )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetIfxDecimal: Sobrescriba la columna con un valor nuevo.
3-644

Visual Basic] Public Sub SetIfxDecimal ( _ i As Integer, _ value As IfxDecimal _ ) [C#] public void SetIfxDecimal ( int i, IfxDecimal value ) [C++] public: virtual void SetIfxDecimal ( int i, IfxDecimal value ) [JScript] public function SetIfxDecimal ( i : int, value : IfxDecimal )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetIfxDouble: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-645
Sintaxis
Visual Basic] Public Sub SetIfxDouble ( _ i As Integer, _ value As IfxDouble _ ) [C#] public void SetIfxDouble ( int i, IfxDouble value ) [C++] public: virtual void SetIfxDouble ( int i, IfxDouble value ) [JScript] public function SetIfxDouble ( i : int, value : IfxDouble )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetIfxInt16: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxInt16 ( _ i As Integer, _ value As IfxInt16 _ ) [C#] public void SetIfxInt16 (
3-646
int i, IfxInt16 value ) [C++] public: virtual void SetIfxInt16 ( int i, IfxInt16 value ) [JScript] public function SetIfxInt16 ( i : int, value : IfxInt16 )
Visual Basic] Public Sub SetIfxInt32 ( _ i As Integer, _ value As IfxInt32 _ ) [C#] public void SetIfxInt32 ( int i, IfxInt32 value ) [C++] public: virtual void SetIfxInt32 ( int i, IfxInt32 value
3-647
) [JScript] public function SetIfxInt32 ( i : int, value : IfxInt32 )
Visual Basic] Public Sub SetIfxInt64 ( _ i As Integer, _ value As IfxInt64 _ ) [C#] public void SetIfxInt64 ( int i, IfxInt64 value ) [C++] public: virtual void SetIfxInt64 ( int i, IfxInt64 value ) [JScript] public function SetIfxInt64 ( i : int, value : IfxInt64 )
3-648
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetIfxReal370: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxReal370 ( _ i As Integer, _ value As IfxReal370 _ ) [C#] public void SetIfxReal370 ( int i, IfxReal370 value ) [C++] public: virtual void SetIfxReal370 ( int i, IfxReal370 value ) [JScript] public function SetIfxReal370 ( i : int, value : IfxReal370 )
3-649
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetIfxReal: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxReal ( _ i As Integer, _ value As IfxReal _ ) [C#] public void SetIfxReal ( int i, IfxReal value ) [C++] public: virtual void SetIfxReal ( int i, IfxReal value ) [JScript] public function SetIfxReal ( i : int, value : IfxReal )
3-650
filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetIfxString: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxString ( _ i As Integer, _ value As IfxString _ ) [C#] public void SetIfxString ( int i, IfxString value ) [C++] public: virtual void SetIfxString ( int i, IfxString value ) [JScript] public function SetIfxString ( i : int, value : IfxString )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-651
Mtodo IfxResultSet.SetIfxTime: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxTime ( _ i As Integer, _ value As IfxTime _ ) [C#] public void SetIfxTime ( int i, IfxTime value ) [C++] public: virtual void SetIfxTime ( int i, IfxTime value ) [JScript] public function SetIfxTime ( i : int, value : IfxTime )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetIfxTimeStamp: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix
3-652

Visual Basic] Public Sub SetIfxTimeStamp ( _ i As Integer, _ value As IfxTimeStamp _ ) [C#] public void SetIfxTimeStamp ( int i, IfxTimeStamp value ) [C++] public: virtual void SetIfxTimeStamp ( int i, IfxTimeStamp value ) [JScript] public function SetIfxTimeStamp ( i : int, value : IfxTimeStamp )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetDate: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetDate ( _ i As Integer, _
3-653
value As DateTime _ ) [C#] public void SetDate ( int i, DateTime value ) [C++] public: virtual void SetDate ( int i, DateTime value ) [JScript] public function SetDate ( i : int, value : DateTime )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetDateTime: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetDateTime ( _ i As Integer, _ value As DateTime _ ) [C#] public void SetDateTime ( int i, DateTime value ) [C++]
3-654
public: virtual void SetDateTime ( int i, DateTime value ) [JScript] public function SetDateTime ( i : int, value : DateTime )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetDecimal: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetDecimal ( _ i As Integer, _ value As Decimal _ ) [C#] public void SetDecimal ( int i, decimal value ) [C++] public: virtual void SetDecimal ( int i, decimal value ) [JScript]
3-655
public function SetDecimal ( i : int, value : decimal )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetDefault: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetDefault ( _ i As Integer _ ) [C#] public void SetDate ( int i ) [C++] public: virtual void SetDate ( int i ) [JScript] public function SetDate ( i : int )
3-656
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetDouble: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetDouble ( _ i As Integer, _ value As Double _ ) [C#] public void SetDouble ( int i, double value ) [C++] public: virtual void SetDouble ( int i, double value ) [JScript] public function SetDouble ( i : int, value : double )
3-657
filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetFloat: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetFloat ( _ i As Integer, _ value As Single _ ) [C#] public void SetFloat ( int i, float value ) [C++] public: virtual void SetFloat ( int i, float value ) [JScript] public function SetFloat ( i : int, value : float )
3-658
Mtodo IfxResultSet.SetGuid: No est soportado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetGuid ( _ i As Integer, _ value As Guid _ ) [C#] public void SetGuid ( int i, Guid value ) [C++] public: virtual void SetGuid ( int i, Guid value ) [JScript] public function SetGuid ( i : int, value : Guid )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetInt16: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix
3-659

Visual Basic] Public Sub SetInt16 ( _ i As Integer, _ value As Short _ ) [C#] public void SetInt16 ( int i, short value ) [C++] public: virtual void SetInt16 ( int i, short value ) [JScript] public function SetInt16 ( i : int, value : short )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetInt32: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetInt32 ( _ i As Integer, _
3-660
value As Integer _ ) [C#] public void SetInt32 ( int i, int value ) [C++] public: virtual void SetInt32 ( int i, int value ) [JScript] public function SetInt32 ( i : int, value : int )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetInt64: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetInt64 ( _ i As Integer, _ value As Long _ ) [C#] public void SetInt64 ( int i, long value ) [C++]
3-661
public: virtual void SetInt64 ( int i, long long value ) [JScript] public function SetInt64 ( i : int, value : long )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetNull: Sobrescriba la columna con un nuevo valor. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetNull ( _ i As Integer _ ) [C#] public void SetNull ( int i ) [C++] public: virtual void SetNull ( int i ) [JScript] public function SetNull ( i : int )
3-662
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetString: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetString ( _ i As Integer, _ value As String _ ) [C#] public void SetString ( int i, string value ) [C++] public: virtual void SetString ( int i, String^ value ) [JScript] public function SetString ( i : int, value : String )
3-663
Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetTime: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetTime ( _ i As Integer, _ value As TimeSpan _ ) [C#] public void SetTime ( int i, TimeSpan value ) [C++] public: virtual void SetTime ( int i, TimeSpan value ) [JScript] public function SetTime ( i : int, value : TimeSpan )
3-664
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetTimeSpan: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetTimeSpan ( _ i As Integer, _ value As TimeSpan _ ) [C#] public void SetTimeSpan ( int i, TimeSpan value ) [C++] public: virtual void SetTimeSpan ( int i, TimeSpan value ) [JScript] public function SetTimeSpan ( i : int, value : TimeSpan )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetValue:
3-665
Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetValue ( _ i As Integer, _ value As Object _ ) [C#] public void SetValue ( int i, Object value ) [C++] public: virtual void SetValue ( int i, Object value ) [JScript] public function SetValue ( i : int, value : Object )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.SetValues: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-666
Sintaxis
Visual Basic] Public Sub SetValues ( _ values As Object() _ ) [C#] public void SetValues ( Object[] valores ) [C++] public: virtual void SetValues ( Object valores __gc[] ) [JScript] public function SetValues ( values : Object[] )
values Valor que se insertar en la columna especificada. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxResultSet.Update: Enve las actualizaciones pendientes para el registro actual a la fila subyacente del servidor de la base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub Update [C#] public void Update () [C++] public: void Update () [JScript] public function Update ()
3-667
Excepciones
Tipo de excepcin InvalidOperationException InvalidOperationException Condicin Es necesario un cursor actualizable. No existen datos para la fila/columna. El cursor IfxResulSet no est colocado en un registro. Se est intentando una actualizacin en una fila que se ha suprimido.
InvalidOperationException
Comentarios La aplicacin debe llamar explcitamente al mtodo IfxResultSet.Update al actualizar los valores de columna de un registro o los cambios a los valores de columna se perdern cuando el cursor se mueva a una fila distinta. Ejemplo [C#] El ejemplo siguiente demuestra cmo actualizar una fila de una nstancia IfxResultSet, siempre que el servidor d soporte a cursores actualizables.
[C#] public static void updateSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted | IfxResultSetOptions.Updatable); if (salesRS.ReadLast()) { if (salesRS.Updatable) { salesRS.SetIfxDate(0, new IfxDate(DateTime.Now)); salesRS.SetIfxString(1, new IfxString("Erik")); salesRS.SetIfxString(2, new IfxString("Ontario-South")); salesRS.SetIfxInt32(3, new IfxInt32(2)); salesRS.Update(); } } return; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-668
Propiedades de IfxResultSet
Las propiedades de la clase IfxResultSet se listan a continuacin.
Propiedades pblicas
CursorType Depth FieldCount HasRows IsClosed IsDeleted RecordsAffected Obtiene un valor que indica si la fila se ha suprimido. Obtiene un valor que indica el nmero de registros afectados por una operacin de supresin, insercin o actualizacin. Obtiene un valor que indica si el cursor es desplazable. Obtiene un valor que indica si el cursor es sensible a las actualizaciones realizadas por la aplicacin y otros cursores. Obtiene un valor que indica si el cursor saltar las filas suprimidas durante la captacin. Sobrecargado. Obtiene el valor de una columna en su formato nativo. Obtiene un valor que indica si el conjunto de resultados se puede actualizar. Tipo de cursor representado por el objeto IfxResultSet. Igual que: Obtiene un valor que indica la profundidad de anidacin para la fila actual. Obtiene el nmero de columnas de la fila actual. Igual que Obtiene un valor que indica si el IfxResultSet contiene una o ms filas. Indica si IfxResultSet est cerrado.
Scrollable Sensitive
SkipDeleted
this Updatable
Consulta Miembros de IfxResultSet en la pgina 3-564 Representa un cursor desplazable. Las tablas siguientes listan los miembros expuestos por la clase IfxResultSet. Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.CacheData:
3-669
Indica si los datos almacenados en la posicin de cursor actual de la instancia de IfxResultSet se van a almacenar en la antememoria. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property CacheData As Boolean [C#] public bool CacheData {get; set;} [C++] public: __property bool get_CacheData(); public: __property void set_CacheData(bool); [JScript] public function get CacheData() : Boolean; public function set CacheData(Boolean);
Valor de la propiedad true si la instancia del objeto IfxResultSet debe ponerse en la antememoria; de no ser as, false. El valor por omisin es false. Comentarios Esto permite llamar a IfxResultSet.GetBytes() seguido de una llamada a IfxResultSet.GetString(). Esta propiedad debe fijarse antes de la primera llamada de uno de los dos mtodos get IfxResultSet de este objeto o los datos no se pondrn en antememoria. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Miembros de IfxResultSet en la pgina 3-564 Representa un cursor desplazable. Las tablas siguientes listan los miembros expuestos por la clase IfxResultSet. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxResultSet.CursorType: Tipo de cursor representado por el objeto IfxResultSet. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property CursorType As IfxCursorType [C#] public IfxCursorType CursorType {get}
3-670
[C++] public: __property IfxCursorType* get_CursorType(); [JScript] public function get CursorType() : IfxCursorType;
Valor de la propiedad Valor de enumeracin IfxCursorType. Comentarios Dependiendo del servidor de datos al que est conectada la aplicacin, el tipo de cursor utilizado por la instancia de IfxResultSet puede ser distinto de lo que la aplicacin asign a la misma en el mtodo IfxCommand.ExecuteResultSet. Utilice esta propiedad para verificar el tipo de cursor que se utiliza. Ejemplo [C#] El ejemplo siguiente demuestra cmo determinar qu tipo de cursor utiliza la instancia de IfxResultSet.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted); MessageBox.Show(salesRS.CursorType.ToString()); if (salesRS.ReadLast()) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.Depth:
3-671
Igual que: Obtiene un valor que indica la profundidad de anidacin para la fila actual. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Depth As Integer [C#] public int Depth {get;} [C++] public: __property int get_Depth(); [JScript] public function get Depth() : int;
Valor de la propiedad La profundidad de anidacin para la fila actual. Comentarios La tabla ms exterior tiene una profundidad de cero. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.FieldCount: Obtiene el nmero de columnas de la fila actual. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-672
Comentarios Despus de ejecutar una consulta que no devuelve filas, FieldCount devuelve 0. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.HasRows: Igual que Obtiene un valor que indica si el IfxResultSet contiene una o ms filas. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property HasRows As Boolean [C#] public bool HasRows {get;} [C++] public: __property bool get_HasRows(); [JScript] public function get HasRows() : Boolean;
Valor de la propiedad true si IfxDataReader contiene una o ms filas; de lo contrario, false. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-673
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.IsClosed: Indica si IfxResultSet est cerrado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property IsClosed As Boolean [C#] public bool IsClosed {get;} [C++] public: __property bool get_IsClosed(); [JScript] public function get IsClosed() : Boolean;
Valor de la propiedad true si IfxDataReader est cerrado; de lo contrairo, false. Comentarios IsClosed y RecordsAffected son las nicas propiedades que puede invocar despus de cerrar IfxDataReader. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.IsDeleted: Obtiene un valor que indica si la fila se ha suprimido. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property IsDeleted As Boolean [C#] public bool IsDeleted {get;} [C++]
3-674
public: __property bool get_IsDeleted(); [JScript] public function get IsDeleted() : Boolean;
Ejemplo [C#] El ejemplo siguiente demuestra cmo suprimir una fila de una instancia de IfxResultSet, siempre que el servidor d soporte a cursores actualizables.
[C#] public static void deleteSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxCursorType.Keyset); if (salesRS.ReadLast()) { if (salesRS.Updatable) { salesRS.Delete(); MessageBox.Show(salesRS.IsDeleted.ToString()); } } return; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.RecordsAffected: Obtiene un valor que indica el nmero de registros afectados por una operacin de supresin, insercin o actualizacin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property RecordsAffected As Integer [C#] public int RecordsAffected {get;} [C++]
3-675
public: __property int get_RecordsAffected(); [JScript] public function get RecordsAffected() : int;
Valor de la propiedad El nmero de filas cambiadas, insertadas o suprimidas. -1 para sentencias SELECT; 0 si no hay filas afectadas o si la sentencia ha fallado. Comentarios La propiedad RecordsAffected no se establece hasta que se han ledo todas lasfilas y se cierra IfxDataReader. El valor de esta propiedad es acumulativo. Por ejemplo, si se insertan dos registros en modalidad de proceso por lotes, el valor de RecordsAffected ser 2. IsClosed y RecordsAffected son las nicas propiedades que puede invocar despus de cerrar IfxDataReader. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.Scrollable: Obtiene un valor que indica si la instancia de IfxResultSet es desplazable. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Scrollable As Boolean [C#] public bool Scrollable {get;} [C++] public: __property bool get_Scrollable(); [JScript] public function get Scrollable() : Boolean;
Valor de la propiedad true si IfxResultSet es desplazable; de lo contrario, false. Comentarios Dependiendo del servidor de datos al que est conectada la aplicacin, los atributos de la instancia de IfxResultSet pueden ser distintos de lo que la
3-676
aplicacin asign a los mismos en el mtodo IfxCommand.ExecuteResultSet. Utilice esta aplicacin para verificar que esta instancia de IfxResultSet es desplazable. Ejemplo [C#] El ejemplo siguiente demuestra cmo determinar si la instancia de IfxResultSet es desplazable y cmo leer datos de la misma.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted); if (salesRS.Scrollable) { if (salesRS.ReadAbsolute(3)) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } } return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.Sensitive: Obtiene un valor que indica si el cursor es sensible a las actualizaciones realizadas por la aplicacin y otros cursores. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-677
Sintaxis
Visual Basic] Public Property Sensitive As Boolean [C#] public bool Sensitive {get;} [C++] public: __property bool get_Sensitive(); [JScript] public function get Sensitive() : Boolean;
Valor de la propiedad true si IfxResultSet es sensible a las actualizaciones; de lo contrario, false. Comentarios Dependiendo del servidor de datos al que est conectada la aplicacin, los atributos de la instancia de IfxResultSet pueden ser distintos de lo que la aplicacin asig a los mismos en el mtodo IfxCommand.ExecuteResultSet. Utilice esta propiedad para verificar que esta instancia de IfxResultSet es sensible a actualizaciones. Los cursores de conjuntos de teclas y dinmicos son siempre sensibles. Ejemplo [C#] El ejemplo siguiente demuestra cmo determinar si la instancia de IfxResultSet es sensible a actualizaciones de otros cursores y lee datos de los mismos, si es as.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted); if (salesRS.Sensitive) { if (salesRS.ReadLast()) { salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } } return salesData; }
3-678
filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.SkipDeleted: Obtiene un valor que indica si la instancia de IfxResultSet omitir las filas suprimidas durante la captacin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property SkipDeleted As Boolean [C#] public bool SkipDeleted {get;} [C++] public: __property bool get_SkipDeleted(); [JScript] public function get SkipDeleted() : Boolean;
Valor de la propiedad true si IfxResultSet omite las filas suprimidas; de lo contrario, false. Comentarios Dependiendo del servidor de datos al que est conectada la aplicacin, los atributos de la instancia de IfxResultSet pueden ser distintos de lo que la aplicacin asign a los mismos en el mtodo IfxCommand.ExecuteResultSet. Utilice esta propiedad para verificar que esta instancia de IfxResultSet omite las filas suprimidas. Ejemplo [C#] El ejemplo siguiente demuestra cmo determinar si la instancia de IfxResultSet omite las filas suprimidas y lee datos de la misma, si es as.
[C#] public static string getSalesData(IfxConnection conn) { string salesQuery = "SELECT * FROM SALES"; string salesData = ""; IfxCommand cmd = new IfxCommand(salesQuery, conn); IfxResultSet salesRS = cmd.ExecuteResultSet( IfxResultSetOptions.Scrollable | IfxResultSetOptions.Sensitive | IfxResultSetOptions.SkipDeleted); if (salesRS.SkipDeleted) { if (salesRS.ReadAbsolute(3)) {
3-679
salesData = salesRS.GetIfxDate(0).ToString(); salesData += ", " + salesRS.GetIfxString(1).ToString(); salesData += ", " + salesRS.GetIfxString(2).ToString(); salesData += ", " + salesRS.GetIfxInt32(3).ToString(); } } return salesData; }
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.this: Obtiene el valor de una columna en su formato nativo. Lista de sobrecargas
Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Miembros de IfxResultSet en la pgina 3-564 Representa un cursor desplazable. Las tablas siguientes listan los miembros expuestos por la clase IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.this (Int32):
3-680
Obtiene el valor de la columna especificada en su formato nativo dado el ordinal de columna. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Miembros de IfxResultSet en la pgina 3-564 Representa un cursor desplazable. Las tablas siguientes listan los miembros expuestos por la clase IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.this en la pgina 3-680 Obtiene el valor de una columna en su formato nativo. Propiedad IfxResultSetDataReader.this (String): Obtiene el valor de la columna especificada en su formato nativo dado el nombre de columna. Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Miembros de IfxResultSet en la pgina 3-564 Representa un cursor desplazable. Las tablas siguientes listan los miembros expuestos por la clase IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxResultSet.this en la pgina 3-680 Obtiene el valor de una columna en su formato nativo. Propiedad IfxResultSet.Updatable: Obtiene un valor que indica si la instancia de IfxResultSet se puede actualizar. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Updatable As Boolean [C#] public bool Updatable {get;} [C++]
3-681
public: __property bool get_Updatable(); [JScript] public function get Updatable() : Boolean;
Valor de la propiedad true si IfxResultSet se puede actualizar; de lo contrario, false. Comentarios Dependiendo del servidor de datos al que est conectada la aplicacin, los atributos de la instancia de IfxResultSet pueden ser distintos de los valores que la aplicacin asign para los mismos en el mtodo IfxCommand.ExecuteResultSet. Utilice esta propiedad para verificar que esta instancia de IfxResultSet es actualizable. Ejemplo [C#] El ejemplo siguiente demuestra cmo insertar una nueva fila en una instancia de IfxResultSet, siempre que el servidor d soporte a los cursores actualizables.
3-682
Enumeracin IfxResultSetOptions
Opciones a utilizar con IfxResultSet. Estas opciones son distintivos de bits que le permiten combinarlos en mscaras de bits. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] <Serializable> Public Enum IfxResultSetOptions [C#] [Serializable] public enum IfxResultSetOptions [C++] [Serializable] __value public enum IfxResultSetOptions [JScript] public Serializable enum IfxResultSetOptions
Miembros
Nombre de miembro None Scrollable Updatable Valor de bit 0 1 4 Descripcin Ninguna opcin. En este caso, el IfxResultSet que se crear utilizar el cursor slo de avance. El IfxResultSet que se crear ser desplazable. El IfxResultSet que se crear utilizar un cursor que se podr actualizar.
Nota:
Comentarios
Al crear una instancia de IfxResultSet con el mtodo IfxCommand.ExecuteResultSet, puede utilizar la enumeracin IfxResultSetOptions o la enumeracin IfxCursorType para definir las capacidades de la instancia de IfxResultSet. La tabla anterior muestra los valores IfxResultSet.CursorType que corresponden a cada combinacin aceptable de valores IfxResultSetOptions. Si la aplicacin requiere un IfxResultSet que utilice un cursor Dynamic, debe ejecutar el valor de la enumeracin IfxCommand.ExecuteResultSet method using the IfxCursorType.Dynamic. A continuacin se muestran los detalles de las modalidades de two IfxResultSet.CursorType soportadas por la clase IfxResultSet: ForwardOnly Este tipo de cursor es unidireccional y es el tipo de cursor que requiere la cantidad menor de proceso de rendimiento. Un IfxResultSet creado con este tipo de cursor es funcionalmente equivalente a IfxDataReader. Static Es un cursor de solo lectura. Una vez que se ha creado, no se pueden aadir ni eliminar filas, ni se pueden cambiar los valores de las filas. El
3-683
cursor no resulta afectado por otras aplicaciones que accedan a los mismos datos. El nivel de aislamiento utilizado para crear el cursor determina cmo estn bloqueadas las filas del cursor, si lo estn.
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxResultSet en la pgina 3-563 Proporciona desplazamiento multidireccional en una corriente vinculable de filas de datos de una base de datos. Adems, las instancias de IfxResultSet tambin pueden insertar, actualizar y suprimir filas. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxRowUpdatedEventArgs
Proporciona datos para el suceso RowUpdated. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.EventArgs System.Data.Common.RowUpdatedEventArgs IBM.Data.Informix.IfxRowUpdatedEventArgs
Sintaxis
Visual Basic] NotInheritable Public Class IfxRowUpdatedEventArgs Inherits RowUpdatedEventArgs [C#] public sealed class IfxRowUpdatedEventArgs : RowUpdatedEventArgs [C++] public __gc __sealed class IfxRowUpdatedEventArgs : public RowUpdatedEventArgs [JScript] public class IfxRowUpdatedEventArgs extends RowUpdatedEventArgs
Comentarios
El suceso IfxDataAdapter.RowUpdated se emite cuando finaliza una actualizacin para una fila. Cuando se utiliza el mtodo Update, se producen dos sucesos para cada fila de datos actualizada:IfxDataAdapter.RowUpdating and RowUpdated. El orden de ejecucin para una Update es el siguiente: 1. Los valores de DataRow se mueven a los valores de parmetro. 2. Se emite el suceso IfxDataAdapter.RowUpdating.
3-684
3. Se ejecuta el mandato. 4. Si UpdateRowSource se establece en FirstReturnedRecord, el primer resultado devuelto se coloca en la DataRow. 5. Si hay parmetros de salida, se colocan en DataRow. 6. Se emite el suceso IfxDataAdapter.RowUpdated. 7. Se llama a AcceptChanges.
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxRowUpdatedEventArgs Visin general de IfxRowUpdatedEventArgs Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbEvent.cs DbEvent.vb
Miembros de IfxRowUpdatedEventArgs
Visin general de IfxRowUpdatedEventArgs
IfxRowUpdatedEventArgs Inicializa una instancia nueva de la clase IfxRowUpdatedEventArgs.
Propiedades pblicas
Command IfxErrors Obtiene el IfxCommand que se ejecuta cuando se llama a Update. Si se ha emitido alguna instancia de IfxException en el lote de mandatos, esta propiedad har referencia a una instancia de IfxErrorCollection. Obtiene los errores que gener IBM Data Server Provider for .NET cuando se ejecut el Command. Obtiene el nmero de filas cambiadas, insertadas o suprimidas por la ejecucin de la sentencia de SQL.
Errors (heredada de RowUpdatedEventArgs) RecordsAffected (heredada de RowUpdatedEventArgs)
3-685
Row (heredada de RowUpdatedEventArgs) RowCount (heredada de RowUpdatedEventArgs) StatementType (heredada de RowUpdatedEventArgs) Status (heredada de RowUpdatedEventArgs) TableMapping (heredada de RowUpdatedEventArgs)
Obtiene la DataRow enviada mediante una Update. Nmero de filas procesadas en el lote de mandatos enviados al servidor de bases de datos. Obtiene el tipo de sentencia de SQL ejecutada. Obtiene el UpdateStatus del Command.
Obtiene la DataTableMapping enviada mediante una Update.
Mtodos pblicos
Mtodos protegidos
Consulta Clase IfxRowUpdatedEventArgs en la pgina 3-684 Proporciona datos para el suceso RowUpdated. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-686
Constructor de IfxRowUpdatedEventArgs
Inicializa una instancia nueva de la clase IfxRowUpdatedEventArgs. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] Public Sub New( _ ByVal row As DataRow, _ ByVal command As IDbCommand, _ ByVal statementType As StatementType, _ ByVal tableMapping As DataTableMapping _ ) [C#] public IfxRowUpdatedEventArgs( DataRow row, IDbCommand command, StatementType statementType, DataTableMapping tableMapping ); [C++] public: IfxRowUpdatedEventArgs( DataRow* row, IDbCommand* command, StatementType statementType, DataTableMapping* tableMapping ); [JScript] public function IfxRowUpdatedEventArgs( row : DataRow, command : IDbCommand, statementType : StatementType, tableMapping : DataTableMapping );
Parmetros
row DataRow que se enva mediante una operacin de actualizacin. command IfxCommand que se ejecuta cuando se llama a Update. statementType Uno de los valores de System.Data.StatementType que especifica el tipo de consulta ejecutada. tableMapping System.Data.Common.DataTableMapping que se enva mediante Update. Consulta Clase IfxRowUpdatedEventArgs en la pgina 3-684 Proporciona datos para el suceso RowUpdated. Miembros de IfxRowUpdatedEventArgs en la pgina 3-685 Visin general de IfxRowUpdatedEventArgs Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-687
Propiedades de IfxRowUpdatedEventArgs
Las propiedades de la clase IfxRowUpdatedEventArgs se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxRowUpdatedEventArgs, consulte el tema Miembros de IfxRowUpdatedEventArgs.
Propiedades pblicas
Command IfxErrors Obtiene el IfxCommand que se ejecuta cuando se llama a Update. Si se ha emitido alguna instancia de IfxException en el lote de mandatos, esta propiedad har referencia a una instancia de IfxErrorCollection. Obtiene los errores que gener IBM Data Server Provider for .NET cuando se ejecut el Command. Obtiene el nmero de filas cambiadas, insertadas o suprimidas por la ejecucin de la sentencia de SQL. Obtiene la DataRow enviada mediante una Update. Nmero de filas procesadas en el lote de mandatos enviados al servidor de bases de datos. Obtiene el tipo de sentencia de SQL ejecutada. Obtiene el UpdateStatus del Command. Status (heredada de RowUpdatedEventArgs) TableMapping (heredada de RowUpdatedEventArgs) Obtiene la DataTableMapping enviada mediante una Update.
Errors (heredada de RowUpdatedEventArgs) RecordsAffected (heredada de RowUpdatedEventArgs) Row (heredada de RowUpdatedEventArgs) RowCount (heredada de RowUpdatedEventArgs) StatementType (heredada de RowUpdatedEventArgs)
Consulta Clase IfxRowUpdatedEventArgs en la pgina 3-684 Proporciona datos para el suceso RowUpdated. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbEvent.cs DbEvent.vb Propiedad IfxRowUpdatedEventArgs.Command: Obtiene el IfxCommand que se ejecuta cuando se llama a Update.
3-688

Visual Basic] Public ReadOnly Property Command As IfxCommand [C#] public new IfxCommand Command {get;} [C++] public: __property IfxCommand * get_Command(); [JScript] public function get Command() : IfxCommand ;
Valor de la propiedad IfxCommand que se ejecuta cuando se llama a Update. Consulta Clase IfxRowUpdatedEventArgs en la pgina 3-684 Proporciona datos para el suceso RowUpdated. Miembros de IfxRowUpdatedEventArgs en la pgina 3-685 Visin general de IfxRowUpdatedEventArgs Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxRowUpdatedEventArgs.IfxErrors: Si se ha emitido alguna instancia de IfxException en el lote de mandatos, esta propiedad har referencia a una coleccin de objetos IfxError. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property IfxErrors As IfxErrorCollection [C#] public IfxErrorCollection IfxErrors {get;} [C++] public: __property IfxErrorCollection get_IfxErrors(); [JScript] public function get IfxErrors() : IfxErrorCollection;
Valor de la propiedad Si se ha emitido alguna instancia de IfxException en el lote de mandatos, esta propiedad har referencia a un objeto IfxErrorCollection. Si no se ha emitido ninguna instancia de IfxException, esta propiedad sernula.
3-689
Informacin de versin Versin de .NET Framework Soportado en: 2.0 y 3.0 Consulta Clase IfxRowUpdatedEventArgs en la pgina 3-684 Proporciona datos para el suceso RowUpdated. Miembros de IfxRowUpdatedEventArgs en la pgina 3-685 Visin general de IfxRowUpdatedEventArgs Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Delegado de IfxRowUpdatedEventHandler
Representa el mtodo que manejar el suceso RowUpdated de un IfxDataAdapter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] <Serializable> Public Delegate Sub IfxRowUpdatedEventHandler( _ ByVal sender As Object, _ ByVal e As IfxRowUpdatedEventArgs _ ) [C#] [Serializable] public delegate void IfxRowUpdatedEventHandler( object sender, IfxRowUpdatedEventArgs e ); [C++] [Serializable] public __gc __delegate void IfxRowUpdatedEventHandler( Object* sender, IfxRowUpdatedEventArgs* e );
Comentarios
No es necesario que el manejador realice ninguna accin, y se debe evitar que el cdigo genere excepciones o permita que las excepciones se propaguen hacia el mtodo de llamada. Cualquier excepcin que alcance al llamador se pasa por alto. Cuando se crea un delegado de IfxRowUpdatedEventArgs, se identifica el mtodo que manejar el suceso. Para asociar el suceso con el manejador de sucesos, aada una instancia del delegado al suceso. Se llama al manejador de sucesos siempre que se produce el suceso, a menos que se elimine el delegado. Para obtener ms informacin sobre delegados de manejador de sucesos, consulte el apartado Sucesos y delegados en la documentacin del SDK de .NET Framework. Consulta
3-690
Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbEvent.cs DbEvent.vb
Clase IfxRowUpdatingEventArgs
Proporciona datos para el suceso RowUpdating. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.EventArgs System.Data.Common.RowUpdatingEventArgs IBM.Data.Informix.IfxRowUpdatingEventArgs
Sintaxis
Visual Basic] NotInheritable Public Class IfxRowUpdatingEventArgs Inherits RowUpdatingEventArgs [C#] public sealed class IfxRowUpdatingEventArgs : RowUpdatingEventArgs [C++] public __gc __sealed class IfxRowUpdatingEventArgs : public RowUpdatingEventArgs [JScript] public class IfxRowUpdatingEventArgs extends RowUpdatingEventArgs
Comentarios
El RowUpdating se emite antes de la actualizacin para una fila. Al utilizar el mtodo Update, existen dos sucesos que se producen para cada fila de datos actualizada: RowUpdating y RowUpdated. El orden de ejecucin para una operacin de actualizacin es el siguiente: 1. Los valores de DataRow se mueven a los valores de parmetro. 2. Se emite el suceso RowUpdating. 3. Se ejecuta el mandato. 4. Si UpdateRowSource se establece en FirstReturnedRecord, el primer resultado devuelto se coloca en la DataRow. 5. Si hay parmetros de salida, se colocan en DataRow. 6. Se emite el suceso RowUpdated. 7. Se llama a AcceptChanges.
3-691
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxRowUpdatingEventArgs Visin general de IfxRowUpdatingEventArgs Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbEvent.cs DbEvent.vb
Miembros de IfxRowUpdatingEventArgs
Visin general de IfxRowUpdatingEventArgs
IfxRowUpdatingEventArgs Inicializa una nueva instancia de la clase IfxRowUpdatingEventArgs.
Propiedades pblicas
Command Errors (heredada de RowUpdatingEventArgs) Row (heredada de RowUpdatingEventArgs) StatementType (heredada de RowUpdatingEventArgs) Status (heredada de RowUpdatingEventArgs) TableMapping (heredada de RowUpdatingEventArgs) Obtiene la DataTableMapping que se va a enviar mediante la Update. Obtiene o establece IfxCommand que debe ejecutarse cuando se llama a Update. Obtiene los errores generados por IBM Data Server Provider for .NET cuando se ejecuta Command. Obtiene la DataRow que se va a enviar mediante una Update. Obtiene el tipo de sentencia de SQL que se va a ejecutar. Obtiene el UpdateStatus del Command.
3-692
Mtodos pblicos
Mtodos protegidos
Consulta Clase IfxRowUpdatingEventArgs en la pgina 3-691 Proporciona datos para el suceso RowUpdating. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Constructor de IfxRowUpdatingEventArgs
Inicializa una nueva instancia de la clase IfxRowUpdatingEventArgs. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] Public Sub New( _ ByVal row As DataRow, _ ByVal command As IDbCommand, _ ByVal statementType As StatementType, _ ByVal tableMapping As DataTableMapping _ ) [C#]
3-693
public IfxRowUpdatingEventArgs( DataRow row, IDbCommand command, StatementType statementType, DataTableMapping tableMapping ); [C++] public: IfxRowUpdatingEventArgs( DataRow* row, IDbCommand* command, StatementType statementType, DataTableMapping* tableMapping ); [JScript] public function IfxRowUpdatingEventArgs( row : DataRow, command : IDbCommand, statementType : StatementType, tableMapping : DataTableMapping );
Parmetros
row DataRow que se debe actualizar. command El IfxCommand que debe ejecutarse durante la operacin de actualizacin. statementType Uno de los valores de System.Data.StatementType que especifica el tipo de consulta ejecutada. tableMapping DataTableMapping que se enva mediante Update. Consulta Clase IfxRowUpdatingEventArgs en la pgina 3-691 Proporciona datos para el suceso RowUpdating. Miembros de IfxRowUpdatingEventArgs en la pgina 3-692 Visin general de IfxRowUpdatingEventArgs Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxRowUpdatingEventArgs
Las propiedades de la clase IfxRowUpdatingEventArgs se listan a continuacin. Para ver una lista completa de IfxRowUpdatingEventArgs, consulte el tema Miembros de IfxRowUpdatingEventArgs.
Propiedades pblicas
Command Errors (heredada de RowUpdatingEventArgs) Obtiene o establece IfxCommand que debe ejecutarse cuando se llama a Update. Obtiene los errores generados por IBM Data Server Provider for .NET cuando se ejecuta Command.
3-694
Row (heredada de RowUpdatingEventArgs) StatementType (heredada de RowUpdatingEventArgs) Status (heredada de RowUpdatingEventArgs) TableMapping (heredada de RowUpdatingEventArgs)
Obtiene la DataRow que se va a enviar mediante una Update. Obtiene el tipo de sentencia de SQL que se va a ejecutar. Obtiene el UpdateStatus del Command.
Obtiene la DataTableMapping que se va a enviar mediante la Update.
Consulta Clase IfxRowUpdatingEventArgs en la pgina 3-691 Proporciona datos para el suceso RowUpdating. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbEvent.cs DbEvent.vb Propiedad IfxRowUpdatingEventArgs.Command: Obtiene o establece el IfxCommand que se debe ejecutar al lalamar a Update. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Command As IfxCommand [C#] public new IfxCommand Command {get; set;} [C++] public: __property IfxCommand * get_Command(); public: __property void set_Command(IfxCommand *); [JScript] public function get Command() : IfxCommand ; public function set Command(IfxCommand );
3-695
Valor de la propiedad El IfxCommand que debe ejecutarse cuando se llama a Update. Consulta Clase IfxRowUpdatingEventArgs en la pgina 3-691 Proporciona datos para el suceso RowUpdating. Miembros de IfxRowUpdatingEventArgs en la pgina 3-692 Visin general de IfxRowUpdatingEventArgs Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Delegado de IfxRowUpdatingEventHandler
Representa el mtodo que manejar el suceso RowUpdating de un IfxDataAdapter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] <Serializable> Public Delegate Sub IfxRowUpdatingEventHandler( _ ByVal sender As Object, _ ByVal e As IfxRowUpdatingEventArgs _ ) [C#] [Serializable] public delegate void IfxRowUpdatingEventHandler( object sender, IfxRowUpdatingEventArgs e ); [C++] [Serializable] public __gc __delegate void IfxRowUpdatingEventHandler( Object* sender, IfxRowUpdatingEventArgs* e );
Comentarios
No es necesario que el manejador realice ninguna accin, y se debe evitar que el cdigo genere excepciones o permita que las excepciones se propaguen hacia el mtodo de llamada. Cualquier excepcin que alcance al llamador se pasa por alto. Utilice el manejador para procesar IfxRowUpdatingEventArgs y para especificar cmo se procesan las actualizaciones. Por ejemplo, puede optar por pasar por alto la actualizacin de la fila actual o pasar por alto la actualizacin de todas las filas restantes. Tenga en cuenta que las filas se actualizan en el orden en el que se han recibido de la base de datos. Cuando se crea un delegado de IfxRowUpdatingEventArgs, identifica el mtodo mediante el que se manejar el suceso. Para asociar el suceso con el manejador de sucesos, aada una instancia del delegado al suceso. Se llama al manejador de
3-696
sucesos siempre que se produce el suceso, a menos que se elimine el delegado. Para obtener ms informacin sobre delegados de manejador de sucesos, consulte el apartado Sucesos y delegados en la documentacin del SDK de .NET Framework. Consulta Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Ejemplos DbEvent.cs DbEvent.vb
Clase IfxRowsCopiedEventArgs
Proporciona datos para el suceso IfxRowsCopied. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.EventArgs IBM.Data.Informix.IfxRowsCopiedEventArgs
Sintaxis
Visual Basic] Public Class IfxRowsCopiedEventArgs Inherits EventArgs [C#] public class IfxRowsCopiedEventArgs : EventArgs [C++] public ref class IfxRowsCopiedEventArgs : public EventArgs [JScript] public class IfxRowsCopiedEventArgs extends EventArgs
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxRowsCopiedEventArgs en la pgina 3-698 Proporciona datos para el suceso IfxRowsCopied. Las tablas siguientes listan los miembros expuestos por la clase IfxRowsCopiedEventArgs. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-697
Miembros de IfxRowsCopiedEventArgs
Proporciona datos para el suceso IfxRowsCopied. Las tablas siguientes listan los miembros expuestos por la clase IfxRowsCopiedEventArgs.
Propiedades pblicas
Nombre Abort Descripcin Obtiene o establece un valor booleano que determina si la operacin IfxBulkCopy actual terminar anormalmente o no. Obtiene un valor que indica el nmero de filas copiadas durante la operacin actual de copia en masa.
RowsCopied
Consulta Clase IfxRowsCopiedEventArgs en la pgina 3-697 Proporciona datos para el suceso IfxRowsCopied. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Propiedades de IfxRowsCopiedEventArgs
Las propiedades de la clase IfxRowsCopiedEventArgs se listan a continuacin.
Propiedades pblicas
Nombre Abort Descripcin Obtiene o establece un valor booleano que determina si la operacin IfxBulkCopy actual terminar anormalmente o no. Obtiene un valor que indica el nmero de filas copiadas durante la operacin actual de copia en masa.
RowsCopied
Consulta Miembros de IfxRowsCopiedEventArgs Proporciona datos para el suceso IfxRowsCopied. Las tablas siguientes listan los miembros expuestos por la clase IfxRowsCopiedEventArgs. Clase IfxRowsCopiedEventArgs en la pgina 3-697 Proporciona datos para el suceso IfxRowsCopied. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxRowsCopiedEventArgs.Abort: Obtiene o establece un valor booleano que determina si la operacin IfxBulkCopy actual terminar anormalmente o no.
3-698

Visual Basic] Public Property Abort As Boolean [C#] public bool Abort {get; set;} [C++] public: __property bool get_Abort(); public: __property void set_Abort(bool); [JScript] public function get Abort() : boolean; public function set Abort(boolean);
Valor de la propiedad Si Abort es true, la operacin IfxBulkCopy actual terminar anormalmente. Si este valor es false, la operacin continuar. Comentarios La propiedad Abort puede utilizarse para cancelar una operacin IfxBulkCopy. Para las operaciones de copia masiva efectuadas en bases de datos DB2 para Linux, UNIX o Windows, las filas que se hayan copiado y confirmado no pueden retrotraerse. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRowsCopiedEventArgs en la pgina 3-697 Proporciona datos para el suceso IfxRowsCopied. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxRowsCopiedEventArgs.RowsCopied: Obtiene un valor que indica el nmero de filas copiadas durante la operacin actual de copia en masa. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property RowsCopied As Long [C#] public long RowsCopied { get; }
3-699
[C++] public: __property long get_RowsCopied(); [JScript] public function get RowsCopied() : long;
Valor de la propiedad Entero largo que indica el nmero de filas copiadas. Comentarios Este valor asume un valor nuevo cada vez que se invoca un mtodo IfxBulkCopy.WriteToServer. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxRowsCopiedEventArgs en la pgina 3-697 Proporciona datos para el suceso IfxRowsCopied. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Delegado de IfxRowsCopiedEventHandler
Representa el mtodo que manejar el suceso de RowsCopied de una operacin IfxBulkCopy. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] <Serializable> Public Delegate Sub IfxRowsCopiedEventHandler( _ ByVal sender As Object, _ ByVal e As IfxRowsCopiedEventArgs _ ) [C#] [Serializable] public delegate void IfxRowsCopiedEventHandler( object sender, IfxRowsCopiedEventArgs e ); [C++] [Serializable] public __gc __delegate void IfxRowsCopiedEventHandler( Object* sender, IfxRowsCopiedEventArgs* e );
3-700
Comentarios
No es necesario que el manejador realice ninguna accin, y se debe evitar que el cdigo genere excepciones o permita que las excepciones se propaguen hacia el mtodo de llamada. Cualquier excepcin que alcance al llamador se pasa por alto. Cuando se crea un delegado de IfxRowsCopiedEventArgs, debe identificarse el mtodo que manejar el suceso. Para asociar el suceso con el manejador de sucesos, aada una instancia del delegado al suceso. Se llama al manejador de sucesos siempre que se produce el suceso, a menos que se elimine el delegado. Para obtener ms informacin sobre delegados de manejador de sucesos, consulte el apartado Sucesos y delegados en la documentacin del SDK de .NET Framework. Consulta Clase IfxRowsCopiedEventArgs en la pgina 3-697 Proporciona datos para el suceso IfxRowsCopied. Suceso de IfxBulkCopy.IfxRowsCopied en la pgina 3-27 Se produce cada vez que el nmero de filas copiadas alcanza el valor definido en la propiedad NotifyAfter. Clase IfxBulkCopy en la pgina 3-5 Facilita la copia de filas de una fuente de datos a una tabla de una base de datos. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Clase IfxTransaction
Representa una transaccin de SQL que se debe realizar en una base de datos. Esta clase no se puede heredar. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)

System.Object System.MarshalByRefObject IBM.Data.Informix.IfxTransaction

System.Object System.MarshalByRefObject System.Data.Common.DbTransaction IBM.Data.Informix.IfxTransaction

Visual Basic] NotInheritable Public Class IfxTransaction Inherits MarshalByRefObject Implements IDbTransaction, IDisposable
3-701
[C#] public sealed class IfxTransaction : MarshalByRefObject, IDbTransaction, IDisposable [C++] public __gc __sealed class IfxTransaction : public MarshalByRefObject, IDbTransaction, IDisposable [JScript] public class IfxTransaction extends MarshalByRefObject implements IDbTransaction, IDisposable

Visual Basic] NotInheritable Public Class IfxTransaction Inherits DbTransaction Implements IDbTransaction, IDisposable [C#] public sealed class IfxTransaction : DbTransaction, IDbTransaction, IDisposable [C++] public __gc __sealed class IfxTransaction : public DbTransaction, IDbTransaction, IDisposable [JScript] public class IfxTransaction extends DbTransaction implements IDbTransaction, IDisposable
Comentarios
La aplicacin crea un objeto IfxTransaction al llamar a BeginTransaction en el objeto IfxConnection. Todas las operaciones subsiguientes asociadas con la transaccin (por ejemplo, confirmar o terminr anormalmente la transaccin) se realizan en el objeto IfxTransaction.
Ejemplo
[Visual Basic, C#] El ejemplo siguiente crea una IfxConnection y una IfxTransaction. Tambin demuestra como utilizar los mtodos IfxConnection.BeginTransaction, IfxTransaction.Commit y IfxTransaction.Rollback.
[Visual Basic] Public Sub RunIfxTransaction(myConnString As String) Dim myConnection As New IfxConnection(myConnString) myConnection.Open() Dim myCommand As New IfxCommand() Dim myTrans As IfxTransaction Start a local transaction myTrans = myConnection.BeginTransaction(IsolationLevel.ReadCommitted) Assign transaction object for a pending local transaction myCommand.Transaction = myTrans Try myCommand.CommandText = "Insert into org( DEPTNUMB, DEPTNAME, MANAGER, DIVISION,LOCATION) VALUES (100, Head Office, 160, Corporate, New York)" myCommand.ExecuteNonQuery() myCommand.CommandText = "Insert into org( DEPTNUMB, DEPTNAME, MANAGER, DIVISION,LOCATION) VALUES (101, New England, 50, Eastern, Boston)" myCommand.ExecuteNonQuery() myTrans.Commit() Console.WriteLine("Both records are written to database.") Catch e As Exception myTrans.Rollback()
3-702
Console.WriteLine(e.ToString()) Console.WriteLine("Neither record was written to database.") Finally myConnection.Close() End Try End Sub [C#] public void RunIfxTransaction(string myConnString) { IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open(); IfxCommand myCommand = new IfxCommand(); IfxTransaction myTrans; // Start a local transaction myTrans = myConnection.BeginTransaction(IsolationLevel.ReadCommitted); // Assign transaction object for a pending local transaction myCommand.Transaction = myTrans; try { myCommand.CommandText = "Insert into org( DEPTNUMB, DEPTNAME, MANAGER, DIVISION,LOCATION) VALUES (100, Head Office, 160, Corporate, New York)"; myCommand.ExecuteNonQuery(); myCommand.CommandText = "Insert into org( DEPTNUMB, DEPTNAME, MANAGER, DIVISION,LOCATION) VALUES (101, New England, 50, Eastern, Boston)"; myCommand.ExecuteNonQuery(); myTrans.Commit(); Console.WriteLine("Both records are written to database."); } catch(Exception e) { myTrans.Rollback(); Console.WriteLine(e.ToString()); Console.WriteLine("Neither record was written to database."); } finally { myConnection.Close(); } }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de transaccin de Ifx en la pgina 3-704 Visin general de IfxTransaction Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-703
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Clase IfxDataAdapter en la pgina 3-255 Representa un conjunto de mandatos de datos y una conexin con una base de datos que se utilizan para rellenar el DataSet y actualizar la base de datos. Clase IfxConnection en la pgina 3-156 Representa una conexin abierta con una base de datos. Ejemplos TbUse.cs TbUse.vb DbUse.cs DbUse.vb
Miembros de transaccin de Ifx

Visin general de IfxTransaction
Propiedades pblicas
DbConnection Connection IsolationLevel Especifica el objeto DbConnection asociado con la transaccin. Especifica la conexin Ifx asociado con la transaccin. Especifica el IsolationLevel para esta transaccin.
Mtodos pblicos
Confirma la transaccin de base de datos. Commit CreateObjRef (heredado de MarshalByRefObject) Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Sobrecargado. Determina si dos instancias de Object son iguales. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia. Obtiene el Type de la instancia actual. GetType (heredado de Object) InitializeLifetimeService (heredado de MarshalByRefObject) Rollback Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Retrotrae una transaccin desde un estado pendiente.
3-704
Devuelve una String que representa el Object actual.
Mtodos protegidos
Dispose Finalize (heredado de Object) Libera los recursos no gestionados utilizados por IfxTransaction. Alterado temporalmente. Permite que un Object intente liberar recursos y realizar otras operaciones de limpieza antes de que el Object sea reclamado para la recopilacin de basura. En C# y Microsoft(R) Visual C++(R), los finalizadores se expresan utilizando sintaxis de destructor. Crea una copia superficial del Object actual. MemberwiseClone (heredado de Object)
Consulta Clase IfxTransaction en la pgina 3-701 Representa una transaccin de SQL que se debe realizar en una base de datos. Esta clase no se puede heredar. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxTransaction
Los mtodos de la clase IfxTransaction se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxTransaction, consulte el tema Miembros de IfxTransaction.
Mtodos pblicos
Confirma la transaccin de base de datos. Commit CreateObjRef (heredado de MarshalByRefObject) Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. Sobrecargado. Determina si dos instancias de Object son iguales. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Recupera el objeto de servicio vitalicio actual que controla la poltica vitalicia para esta instancia.
3-705
Obtiene el Type de la instancia actual. GetType (heredado de Object) InitializeLifetimeService (heredado de MarshalByRefObject) Rollback ToString (heredado de Object) Obtiene un objeto de servicio vitalicio para controlar la poltica vitalicia para esta instancia. Retrotrae una transaccin desde un estado pendiente. Devuelve una String que representa el Object actual.
Mtodos protegidos
Dispose Finalize (heredado de Object) Libera los recursos no gestionados utilizados por IfxTransaction. Alterado temporalmente. Permite que un Object intente liberar recursos y realizar otras operaciones de limpieza antes de que el Object sea reclamado para la recopilacin de basura. En C# y Microsoft(R) Visual C++(R), los finalizadores se expresan utilizando sintaxis de destructor. Crea una copia superficial del Object actual. MemberwiseClone (heredado de Object)
Consulta Clase IfxTransaction en la pgina 3-701 Representa una transaccin de SQL que se debe realizar en una base de datos. Esta clase no se puede heredar. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxTransaction.Commit: Confirma la transaccin de base de datos. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Public Sub Commit() [C#] public void Commit();
3-706
[C++] public: __sealed void Commit(); [JScript] public function Commit();
Excepciones
Tipo de excepcin Exception InvalidOperationException Condicin Se ha producido un error al intentar confirmar la transaccin. La transaccin ya se ha confirmado o retrotrado. -o bienLa conexin se ha interrumpido.
Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection y una IfxTransaction. Tambin demuestra cmo utilizar IfxConnection.BeginTransaction, Commit y IfxTransaction.Rollback methods.
[Visual Basic] Public Sub RunIfxTransaction(myConnString As String) Dim myConnection As New IfxConnection(myConnString) myConnection.Open() Dim myCommand As New IfxCommand() Dim myTrans As IfxTransaction Start a local transaction myTrans = myConnection.BeginTransaction() Assign transaction object for a pending local transaction myCommand.Transaction = myTrans Try myCommand.CommandText = "Insert into org( DEPTNUMB, DEPTNAME, MANAGER, DIVISION,LOCATION) VALUES (100, Head Office, 160, Corporate, New York)" myCommand.ExecuteNonQuery() myCommand.CommandText = "Insert into org( DEPTNUMB, DEPTNAME, MANAGER, DIVISION,LOCATION) VALUES (101, New England, 50, Eastern, Boston)" myCommand.ExecuteNonQuery() myTrans.Commit() Console.WriteLine("Both records are written to database.") Catch e As Exception myTrans.Rollback() Console.WriteLine(e.ToString()) Console.WriteLine("Neither record was written to database.") Finally myConnection.Close() End Try End Sub [C#] public void RunIfxTransaction(string myConnString) { IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open(); IfxCommand myCommand = new IfxCommand();
3-707
IfxTransaction myTrans; // Start a local transaction myTrans = myConnection.BeginTransaction(); // Assign transaction object for a pending local transaction myCommand.Transaction = myTrans; try { myCommand.CommandText = "Insert into org( DEPTNUMB, DEPTNAME, MANAGER, DIVISION,LOCATION) VALUES (100, Head Office, 160, Corporate, New York)"; myCommand.ExecuteNonQuery(); myCommand.CommandText = "Insert into org( DEPTNUMB, DEPTNAME, MANAGER, DIVISION,LOCATION) VALUES (101, New England, 50, Eastern, Boston)"; myCommand.ExecuteNonQuery(); myTrans.Commit(); Console.WriteLine("Both records are written to database."); } catch(Exception e) { myTrans.Rollback(); Console.WriteLine(e.ToString()); Console.WriteLine("Neither record was written to database."); } finally { myConnection.Close(); } }
Consulta Clase IfxTransaction en la pgina 3-701 Representa una transaccin de SQL que se debe realizar en una base de datos. Esta clase no se puede heredar. Miembros de transaccin de Ifx en la pgina 3-704 Visin general de IfxTransaction Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxConnection.BeginTransaction en la pgina 3-171 Inicia una transaccin en la base de datos. Mtodo IfxTransaction.Rollback en la pgina 3-709 Retrotrae una transaccin desde un estado pendiente. Ejemplos TbUse.cs TbUse.vb Mtodo IfxTransaction.Dispose: Libera los recursos no gestionados utilizados por DbTransaction. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-708
Sintaxis
Parmetros disposing true para liberar tanto los recursos gestionados como los no gestionados; false para liberar slo los recursos no gestionados. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxTransaction en la pgina 3-701 Representa una transaccin de SQL que se debe realizar en una base de datos. Esta clase no se puede heredar. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxTransaction.Rollback: Retrotrae una transaccin desde un estado pendiente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] NotOverridable Public Sub Rollback() Implements _ IDbTransaction.Rollback [C#] public void Rollback(); [C++] public: __sealed void Rollback(); [JScript] public function Rollback();
Implementa: IDbTransaction.Rollback
3-709
Excepciones
Tipo de excepcin Exception InvalidOperationException Condicin Se ha producido un error al intentar confirmar la transaccin. La transaccin ya se ha confirmado o retrotrado. -o bienLa conexin se ha interrumpido.
Comentarios La transaccin solo se puede retrotraer desde un estado pendiente (despus de haber llamado a IfxConnection.BeginTransaction, pero antes de llamar a IfxTransaction.Commit). Ejemplo [Visual Basic, C#] El ejemplo siguiente crea una IfxConnection y una IfxTransaction. Tambin demuestra cmo utilizar los mtodos IfxConnection.BeginTransaction, IfxTransaction.Commit y Rollback.
[Visual Basic] Public Sub RunIfxTransaction(myConnString As String) Dim myConnection As New IfxConnection(myConnString) myConnection.Open() Dim myCommand As New IfxCommand() Dim myTrans As IfxTransaction Start a local transaction myTrans = myConnection.BeginTransaction() Assign transaction object for a pending local transaction myCommand.Transaction = myTrans Try myCommand.CommandText = "Insert into org( DEPTNUMB, DEPTNAME, MANAGER, DIVISION,LOCATION) VALUES (100, Head Office, 160, Corporate, New York)" myCommand.ExecuteNonQuery() myCommand.CommandText = "Insert into org( DEPTNUMB, DEPTNAME, MANAGER, DIVISION,LOCATION) VALUES (101, New England, 50, Eastern, Boston)" myCommand.ExecuteNonQuery() myTrans.Commit() Console.WriteLine("Both records are written to database.") Catch e As Exception myTrans.Rollback() Console.WriteLine(e.ToString()) Console.WriteLine("Neither record was written to database.") Finally myConnection.Close() End Try End Sub [C#] public void RunIfxTransaction(string myConnString) { IfxConnection myConnection = new IfxConnection(myConnString); myConnection.Open();
3-710
IfxCommand myCommand = new IfxCommand(); IfxTransaction myTrans; // Start a local transaction myTrans = myConnection.BeginTransaction(); // Assign transaction object for a pending local transaction myCommand.Transaction = myTrans; try { myCommand.CommandText = "Insert into org( DEPTNUMB, DEPTNAME, MANAGER, DIVISION,LOCATION) VALUES (100, Head Office, 160, Corporate, New York)"; myCommand.ExecuteNonQuery(); myCommand.CommandText = "Insert into org( DEPTNUMB, DEPTNAME, MANAGER, DIVISION,LOCATION) VALUES (101, New England, 50, Eastern, Boston)"; myCommand.ExecuteNonQuery(); myTrans.Commit(); Console.WriteLine("Both records are written to database."); } catch(Exception e) { myTrans.Rollback(); Console.WriteLine(e.ToString()); Console.WriteLine("Neither record was written to database."); } finally { myConnection.Close(); } }
Consulta Clase IfxTransaction en la pgina 3-701 Representa una transaccin de SQL que se debe realizar en una base de datos. Esta clase no se puede heredar. Miembros de transaccin de Ifx en la pgina 3-704 Visin general de IfxTransaction Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxTransaction.Commit en la pgina 3-706 Confirma la transaccin de base de datos. Mtodo IfxConnection.BeginTransaction en la pgina 3-171 Inicia una transaccin en la base de datos. Ejemplos TbUse.cs TbUse.vb
Propiedades de IfxTransaction
Las propiedades de la clase IfxTransaction se listan a continuacin. Para obtener una lista completa de los miembros de la clase IfxTransaction, consulte el tema Miembros de IfxTransaction.
3-711
Propiedades pblicas
DbConnection Connection IsolationLevel Especifica el objeto DbConnection asociado con la transaccin. Especifica la conexin Ifx asociado con la transaccin. Especifica el IsolationLevel para esta transaccin.
Consulta Clase IfxTransaction en la pgina 3-701 Representa una transaccin de SQL que se debe realizar en una base de datos. Esta clase no se puede heredar. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxTransaction.Connection: Especifica el objeto IfxConnection asociado con la transaccin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Connection As IfxConnection [C#] public IfxConnection Connection {get;} [C++] public: __property IfxConnection * get_Connection(); [JScript] public function get Connection() : IfxConnection ;
Valor de la propiedad Objeto IfxConnection asociado con la transaccin. Comentarios Una sola aplicacin puede tener varias conexiones de base de datos, cada una con su propia transaccin. Esta propiedad permite al usuario determinar el objeto de conexin asociado con una transaccin determinada. Consulta Clase IfxTransaction en la pgina 3-701 Representa una transaccin de SQL que se debe realizar en una base de datos. Esta clase no se puede heredar.
3-712
Miembros de transaccin de Ifx en la pgina 3-704 Visin general de IfxTransaction Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxTransaction.DbConnection: Especifica el objeto DbConnection asociado con la transaccin. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property DbConnection As DbConnection [C#] public DbConnection DbConnection {get;} [C++] public: __property DbConnection* get_DbConnection(); [JScript] public function get DbConnection() : DbConnection;
Valor de la propiedad El objeto DbConnection asociado con la transaccin. Comentarios Una sola aplicacin puede tener varias conexiones de base de datos, cada una con su propia transaccin. Esta propiedad permite al usuario determinar el objeto de conexin asociado con una transaccin determinada. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxTransaction en la pgina 3-701 Representa una transaccin de SQL que se debe realizar en una base de datos. Esta clase no se puede heredar. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxTransaction.IsolationLevel: Especifica el IsolationLevel para esta transaccin. Espacio de nombres: IBM.Data.Informix
3-713

Visual Basic] Public ReadOnly Property IsolationLevel As IsolationLevel Implements IDbTransaction.IsolationLevel [C#] public IsolationLevel IsolationLevel {get;} [C++] public: __property IsolationLevel get_IsolationLevel(); [JScript] public function get IsolationLevel() : IsolationLevel; _
Implementa: IDbTransaction.IsolationLevel Valor de la propiedad El IsolationLevel para esta transaccin. El valor por omisin es ReadCommitted. Comentarios No se da soporte a transacciones paralelas. Por lo tanto, IsolationLevel se aplica a toda la transaccin. Las correlaciones entre enumeraciones de .NET Isolation y niveles de aislamiento de DB2 son las siguientes:
Enumeracin de .NET Isolation ReadCommitted ReadUncommitted RepeatableRead Serializable Chaos Niveles de aislamiento de DB2 Estabilidad del cursor (valor por omisin) Lectura no confirmada Estabilidad de lectura Lectura repetible no est soportado
Consulta Clase IfxTransaction en la pgina 3-701 Representa una transaccin de SQL que se debe realizar en una base de datos. Esta clase no se puede heredar. Miembros de transaccin de Ifx en la pgina 3-704 Visin general de IfxTransaction Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Enumeracin IfxType
Especifica el tipo de datos de un campo, una propiedad o un IfxParameter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-714
Sintaxis
Visual Basic] <Serializable> Public Enum IfxType [C#] [Serializable] public enum IfxType [C++] [Serializable] __value public enum IfxType [JScript] public Serializable enum IfxType
Comentarios
La tabla siguiente muestra las correlaciones entre los tipos de datos IfxType, los tipos de datos Informix, los , los tipos Microsoft .NET Framework y las clases y estructuras de IfxTypes.
Categora Tipo de datos IfxType Tipo de datos Informix Tipo de datos .NET Clases y estructuras de espacios de nombres de IfxTypes IfxInt16 IfxInt32 IfxInt64 IfxReal, IfxReal370 IfxDouble
Numeric
SmallInt Integer BigInt Real Double
BOOLEAN, SMALLINT INT, INTEGER, SERIAL INT8, SERIAL8 REAL, SMALLFLOAT
Int16 Int32 Int64 Single
DECIMAL (31), Double DOUBLE PRECISION DECIMAL (32), FLOAT MONEY Double Decimal
Float Decimal Numeric Fecha/Hora Date Time Timestamp
IfxDouble IfxDecimal IfxDecimal IfxDate IfxTime IfxTimeStamp
DECIMAL (31), Decimal NUMERIC DATETIME (date precision) DATETIME (time precision) DATETIME (date and time precision) CHAR VARCHAR CLOB, TEXT DateTime TimeSpan DateTime
Datos de carcter Datos LOB
Char VarChar Clob
String String String
IfxString IfxString IfxClob
3-715
No se da soporte a todos los tipos de datos Informix; los siguientes valores de enumeracin IfxType generarn una excepcin si se utilizan en tiempo de ejecucin: v Char1 v Collection v IntervalDayFraction v IntervalMonth v List v Money v MultiSet v Row v Set Para IfxSmartLOBCreateTimeFlags, IfxSmartLOBFileLocation, IfxSmartLOBWhence, IfxSmartLOBLockMode y IfxSmartLOBOpenMode, los mtodos y propiedades que tomen o devuelvan estas enumeraciones no generarn ninguna excepcin implementada.
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0
Miembros
BigInt Binary Blob Char Clob Date Decimal Double Float Integer Numeric Real Real370 SmallInt Un entero de 64 bytes. Representa el tipo de datosINT8, SERIAL8 Informix. Una matriz de bytes. Representa los tipos de datos CHAR, VARCHAR y LVARCHAR Informix. Una matriz de bytes. Representa el tipo de datos BLOB y BYTE Informix. Un nico carcter. Representa el tipo de datos CHAR Informix. Una serie larga de caracteres. Representa el tipo de datos CLOB y TEXT Informix. Una serie que representa una fecha. Representa el tipo de datos DATETIME (date precision) Informix. Un valor decimal. Representa el tipo de datos MONEY Informix. Un valor de coma flotante de precisin doble. Representa el tipo de datos DECIMAL (31), DOUBLE PRECISION Informix. Un valor de coma flotante de precisin simple. Representa el tipo de datos DECIMAL (32), FLOATInformix. Un entero de 32 bytes. Representa el tipo de datosINT, INTEGER y SERIAL Informix. Un valor decimal. Representa el tipo de datosDECIMAL (31), NUMERIC Informix. Un nmero de coma flotante. Representa el tipo de datosREAL, SMALLFLOAT Informix. Un nmero de coma flotante. Representa el tipo de datosREAL, SMALLFLOAT Informix. Un entero de 16 bytes. Representa el tipo de datosBOOLEAN, SMALLINT Informix.
3-716
Time Timestamp VarChar
Una serie que representa la hora del da. Representa el tipo de datos DATETIME (time precision) Informix. Una serie que representa una indicacin horaria. Representa el tipo de datos DATETIME (date and time precision) Informix. Una serie de caracteres. Representa el tipo de datos VARCHAR Informix.
Consulta Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Clase IfxUpdatableRecord
Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.MarshalByRefObject IBM.Data.Informix.IfxUpdatableRecord
Sintaxis
Visual Basic] Public Class IfxUpdatableRecord [C#] public class IfxUpdatableRecord [C++] public class IfxUpdatableRecord [JScript] public class IfxUpdatableRecord
Comentarios
El mtodo IfxResultSet.CreateRecord crea una instancia de IfxUpdatableRecord con el fin de crear una fila nueva en el conjunto de resultados. Una vez la aplicacin haya rellenado el IfxUpdatableRecord utilizando sus mtodos Set, emplee el mtodo IfxResultSet.Insert con la instancia IfxUpdatableRecord como un parmetro para insertar la fila nueva. Una instancia de IfxUpdatableRecord solo puede ser insertada por la instancia de IfxResultSet que la ha creado.
3-717
Ejemplo
[C#] El ejemplo siguiente demuestra cmo insertar una nueva fila en una instancia de IfxResultSet, siempre que el servidor d soporte a los cursores actualizables.
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxUpdatableRecord Representa un registro nuevo a crear. Las tablas siguientes listan los miembros expuestos por la clase IfxUpdatableRecord. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Miembros de IfxUpdatableRecord
Representa un registro nuevo a crear. Las tablas siguientes listan los miembros expuestos por la clase IfxUpdatableRecord.
Propiedades pblicas
FieldCount Obtiene el nmero de columnas de la fila actual.
3-718
this
Sobrecargado. Obtiene el valor de una columna en su formato nativo.
Mtodos pblicos
Cierra la instancia de IfxUpdatableRecord. Dispose GetBoolean GetByte GetBytes Obtiene el valor de la columna especificada como un Booleano. Obtiene el valor de la columna especificada como un byte. Lee una corriente de bytes desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio dado. Obtiene el valor de la columna especificada como un carcter. Lee una corriente de caracteres desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio dado. Obtiene el nombre del tipo de datos fuente. GetDataTypeName GetDate GetDateTime GetIfxBinary GetIfxDate GetIfxDecimal GetIfxDouble GetIfxInt16 GetIfxInt32 GetIfxInt64 GetIfxReal GetIfxReal370 Obtiene el valor de la columna especificada como un objeto DateTime. Obtiene el valor de la columna especificada como un objeto DateTime. Crea una instancia de un objeto IfxBinary a partir de los datos de columna. Crea una instancia de un objeto IfxDate a partir de los datos de columna. Crea una instancia de un objeto IfxDecimal a partir de los datos de columna. Crea una instancia de un objeto IfxDouble a partir de los datos de columna. Crea una instancia de un objeto IfxInt16 a partir de los datos de columna. Crea una instancia de un objeto IfxInt32 a partir de los datos de columna. Crea una instancia de un objeto IfxInt64 a partir de los datos de columna. Crea una instancia de un objeto IfxReal a partir de los datos de columna. Crea una instancia de un objeto IfxReal370 a partir de los datos de columna.
GetChar GetChars
3-719
GetIfxRowId GetIfxString GetIfxTime GetIfxTimeStamp
Crea una instancia de un objeto IfxRowId a partir de los datos de columna. Crea una instancia de un objeto IfxString a partir de los datos de columna. Crea una instancia de un objeto IfxTime a partir de los datos de columna. Crea una instancia de un objeto IfxTimeStamp a partir de los datos de columna. Obtiene el valor de la columna especificada como un decimal. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin doble. Obtiene el Type que es el tipo de datos del objeto. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin simple. No est soportado.
GetGuid GetInt16 GetInt32 GetInt64 GetName GetOrdinal GetString GetTime GetTimeSpan GetValue GetValues IsDBNull IsSetAsDefault Obtiene el valor de la columna especificada como un entero con signo de 16 bits. Obtiene el valor de la columna especificada como un entero con signo de 32 bits. Obtiene el valor de la columna especificada como un entero con signo de 64 bits. Obtiene el nombre de la columna especificada. Obtiene el ordinal de columna, dado el nombre de la columna. Obtiene el valor de la columna especificada como una serie de caracteres. Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna en el ordinal especificado en su formato nativo. Obtiene todas las columnas de atributos en la fila actual. Obtiene un valor que indica si la columna contiene valores no existentes o si faltan. Determina si la ltima modificacin del valor de la posicin ordinal de la columna especificada ha sido realizada por la funcin SetDefault.
3-720
No est soportado. SetBoolean No est soportado. SetByte Sobrescriba la columna con un valor nuevo. SetBytes Sobrescriba la columna con un valor nuevo. SetChar Sobrescriba la columna con un valor nuevo. SetChars Sobrescriba la columna con un valor nuevo. SetDate Sobrescriba la columna con un valor nuevo. SetDateTime Sobrescriba la columna con un valor nuevo. SetIfxBinary Sobrescriba la columna con un valor nuevo. SetIfxDate Sobrescriba la columna con un valor nuevo. SetIfxDecimal Sobrescriba la columna con un valor nuevo. SetIfxDouble Sobrescriba la columna con un valor nuevo. SetIfxInt16 Sobrescriba la columna con un valor nuevo. SetIfxInt32 Sobrescriba la columna con un valor nuevo. SetIfxInt64 Sobrescriba la columna con un valor nuevo. SetIfxReal Sobrescriba la columna con un valor nuevo. SetIfxReal370 Sobrescriba la columna con un valor nuevo. SetIfxString Sobrescriba la columna con un valor nuevo. SetIfxTime Sobrescriba la columna con un valor nuevo. SetIfxTimeStamp Sobrescriba la columna con un valor nuevo. SetDecimal Sobrescriba la columna con un valor nuevo. SetDefault Sobrescriba la columna con un valor nuevo. SetDouble Sobrescriba la columna con un valor nuevo. SetFloat
3-721
No est soportado. SetGuid Sobrescriba la columna con un valor nuevo. SetInt16 Sobrescriba la columna con un valor nuevo. SetInt32 Sobrescriba la columna con un valor nuevo. SetInt64 Sobrescriba la columna con un valor nuevo. SetNull Sobrescriba la columna con un valor nuevo. SetString Sobrescriba la columna con un valor nuevo. SetTime Sobrescriba la columna con un valor nuevo. SetTimeSpan Sobrescriba la columna con un valor nuevo. SetValue Sobrescriba la columna con un valor nuevo. SetValues
Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Mtodos de IfxUpdatableRecord
Los mtodos de la clase IfxUpdatableRecord se listan a continuacin.
Mtodos pblicos
Cierra la instancia de IfxUpdatableRecord. Dispose GetBoolean GetByte GetBytes Obtiene el valor de la columna especificada como un Booleano. Obtiene el valor de la columna especificada como un byte. Lee una corriente de bytes desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio dado. Obtiene el valor de la columna especificada como un carcter.
GetChar
3-722
GetChars
Lee una corriente de caracteres desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio dado. Obtiene el nombre del tipo de datos fuente.
GetDataTypeName GetDate GetDateTime GetIfxBinary GetIfxDate GetIfxDecimal GetIfxDouble GetIfxInt16 GetIfxInt32 GetIfxInt64 GetIfxReal GetIfxReal370 GetIfxRowId GetIfxString GetIfxTime GetIfxTimeStamp Obtiene el valor de la columna especificada como un objeto DateTime. Obtiene el valor de la columna especificada como un objeto DateTime. Crea una instancia de un objeto IfxBinary a partir de los datos de columna. Crea una instancia de un objeto IfxDate a partir de los datos de columna. Crea una instancia de un objeto IfxDecimal a partir de los datos de columna. Crea una instancia de un objeto IfxDouble a partir de los datos de columna. Crea una instancia de un objeto IfxInt16 a partir de los datos de columna. Crea una instancia de un objeto IfxInt32 a partir de los datos de columna. Crea una instancia de un objeto IfxInt64 a partir de los datos de columna. Crea una instancia de un objeto IfxReal a partir de los datos de columna. Crea una instancia de un objeto IfxReal370 a partir de los datos de columna. Crea una instancia de un objeto IfxRowId a partir de los datos de columna. Crea una instancia de un objeto IfxString a partir de los datos de columna. Crea una instancia de un objeto IfxTime a partir de los datos de columna. Crea una instancia de un objeto IfxTimeStamp a partir de los datos de columna. Obtiene el valor de la columna especificada como un decimal. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin doble. Obtiene el Type que es el tipo de datos del objeto. Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin simple.
3-723
No est soportado. GetGuid GetInt16 GetInt32 GetInt64 GetName GetOrdinal GetString GetTime GetTimeSpan GetValue GetValues IsDBNull IsSetAsDefault Obtiene el valor de la columna especificada como un entero con signo de 16 bits. Obtiene el valor de la columna especificada como un entero con signo de 32 bits. Obtiene el valor de la columna especificada como un entero con signo de 64 bits. Obtiene el nombre de la columna especificada. Obtiene el ordinal de columna, dado el nombre de la columna. Obtiene el valor de la columna especificada como una serie de caracteres. Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna especificada como un objeto TimeSpan. Obtiene el valor de la columna en el ordinal especificado en su formato nativo. Obtiene todas las columnas de atributos en la fila actual. Obtiene un valor que indica si la columna contiene valores no existentes o si faltan. Determina si la ltima modificacin del valor de la posicin ordinal de la columna especificada ha sido realizada por la funcin SetDefault. No est soportado. SetBoolean No est soportado. SetByte Sobrescriba la columna con un valor nuevo. SetBytes Sobrescriba la columna con un valor nuevo. SetChar Sobrescriba la columna con un valor nuevo. SetChars Sobrescriba la columna con un valor nuevo. SetDate Sobrescriba la columna con un valor nuevo. SetDateTime Sobrescriba la columna con un valor nuevo. SetIfxBinary Sobrescriba la columna con un valor nuevo. SetIfxDate
3-724
Sobrescriba la columna con un valor nuevo. SetIfxDecimal Sobrescriba la columna con un valor nuevo. SetIfxDouble Sobrescriba la columna con un valor nuevo. SetIfxInt16 Sobrescriba la columna con un valor nuevo. SetIfxInt32 Sobrescriba la columna con un valor nuevo. SetIfxInt64 Sobrescriba la columna con un valor nuevo. SetIfxReal Sobrescriba la columna con un valor nuevo. SetIfxReal370 Sobrescriba la columna con un valor nuevo. SetIfxString Sobrescriba la columna con un valor nuevo. SetIfxTime Sobrescriba la columna con un valor nuevo. SetIfxTimeStamp Sobrescriba la columna con un valor nuevo. SetDecimal Sobrescriba la columna con un valor nuevo. SetDefault Sobrescriba la columna con un valor nuevo. SetDouble Sobrescriba la columna con un valor nuevo. SetFloat No est soportado. SetGuid Sobrescriba la columna con un valor nuevo. SetInt16 Sobrescriba la columna con un valor nuevo. SetInt32 Sobrescriba la columna con un valor nuevo. SetInt64 Sobrescriba la columna con un valor nuevo. SetNull Sobrescriba la columna con un valor nuevo. SetString Sobrescriba la columna con un valor nuevo. SetTime Sobrescriba la columna con un valor nuevo. SetTimeSpan Sobrescriba la columna con un valor nuevo. SetValue
3-725
Sobrescriba la columna con un valor nuevo. SetValues
Consulta Miembros de IfxUpdatableRecord en la pgina 3-718 Representa un registro nuevo a crear. Las tablas siguientes listan los miembros expuestos por la clase IfxUpdatableRecord. Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.Dispose: Cierra la instancia de IfxUpdatableRecord. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetBoolean: Obtiene el valor de la columna especificada como un Booleano. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-726
Sintaxis

Comentarios Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetByte: Obtiene el valor de la columna especificada como un byte. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-727
Sintaxis

Comentarios Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetBytes: Lee una corriente de bytes desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio determinado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-728
Sintaxis
Visual Basic] Public Function GetBytes( _ ByVal i As Integer, _ ByVal dataIndex As Long, _ ByVal buffer() As Byte, _ ByVal bufferIndex As Integer, _ ByVal length As Integer _ ) As Long [C#] public long GetBytes( int i, long dataIndex, byte[] buffer, int bufferIndex, int length ); [C++] public: __int64 GetBytes( int i, __int64 dataIndex, unsigned char buffer __gc[], int bufferIndex, int length ); [JScript] public function GetBytes( i : int, dataIndex : long, buffer : Byte[], bufferIndex : int, length : int ) : long;
Comentarios GetBytes devuelve el nmero de bytes disponibles en el campo. En la mayora de casos esta es la longitud exacta del campo. Sin embargo, el nmero devuelto puede ser menor que la longitud verdadera del campo si GetBytes ya se ha utilizado para
3-729
obtener bytes del campo. Este caso puede darse, por ejemplo, si IfxDataReader est leyendo un BLOB en un almacenamiento intermedio. Para obtener ms informacin, consulte el valor SequentialAccess de System.Data.CommandBehavior en la documentacin del SDK de Microsoft(R) .NET Framework. Si especifica un almacenamiento intermedio que es un valor nulo, GetBytes devuelve la longitud del campo en bytes. No se realizan conversiones. El tipo de los datos que se deben recuperar debe ser uno de los siguientes: v IfxType.Blob La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetChar: Obtiene el valor de la columna especificada como un carcter. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-730

Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetChars: Lee una corriente de caracteres desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio determinado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-731
Sintaxis
Comentarios GetChars devuelve el nmero de caracteres disponibles en el campo. En la mayora de casos esta es la longitud exacta del campo. Sin embargo, el nmero devuelto puede ser inferior a la longitud verdadera del campo si GetChars ya se ha
3-732
utilizado para obtener caracteres del campo. Este caso puede darse, por ejemplo, si IfxDataReader est leyendo un CLOB en un almacenamiento intermedio. Para obtener ms informacin, consulte el valor SequentialAccess de System.Data.CommandBehavior en la documentacin del SDK de Microsoft(R) .NET Framework. Si pasa un almacenamiento intermedio que es un valor nulo, GetChars devuelve la longitud del campo en caracteres. No se realizan conversiones. Los datos que se van a recuperar deben ser uno de los siguientes tipos: v IfxType.Char v IfxType.VarChar v IfxType.LongVarChar v IfxType.Clob La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxBinary: Crea una instancia de un objeto IfxBinary a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxBinary( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxBinary [C#] public IBM.Data.IfxTypes.IfxBinary GetIfxBinary (int i) [C++] public: IBM.Data.IfxTypes.IfxBinary GetIfxBinary( int i );
3-733
[JScript] public function GetIfxBinary( i : int ) : IBM.Data.IfxTypes.IfxBinary;
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxBlob: Crea una instancia de un objeto IfxBlob a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxBlob( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxBlob [C#] public IBM.Data.IfxTypes.IfxBlob GetIfxBlob (int i) [C++] public: IBM.Data.IfxTypes.IfxBlob GetIfxBlob(
3-734
int i ); [JScript] public function GetIfxBlob( i : int ) : IBM.Data.IfxTypes.IfxBlob;
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxClob: Crea una instancia de un objeto IfxClob a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-735
Sintaxis
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxDate: Crea una instancia de un objeto IfxDate a partir de los datos de columna.
3-736

Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-737
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxDecimal: Crea una instancia de un objeto IfxDecimal a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Excepciones
3-738
Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxDouble: Crea una instancia de un objeto IfxDouble a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Objeto IfxDouble que representa el valor de columna. Comentarios No se realizan conversiones. La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Excepciones
3-739
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxInt16: Crea una instancia de un objeto IfxInt16 a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-740
Tipo de datos Ifx IfxInt16
Tipo de datos Informix BOOLEAN, SMALLINT
Excepciones
Valor de retorno Objeto IfxInt32 que representa el valor de columna.
3-741
Excepciones
3-742
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxReal370: Crea una instancia de un objeto IfxReal370 a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetIfxReal370( _ ByVal i As Integer _ ) As IBM.Data.IfxTypes.IfxReal370 [C#] public IBM.Data.IfxTypes.IfxReal370 GetIfxReal370 (int i) [C++] public: IBM.Data.IfxTypes.IfxReal370 GetIfxReal370(
3-743
int i ); [JScript] public function GetIfxReal370( i : int ) : IBM.Data.IfxTypes.IfxReal370;
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxReal: Crea una instancia de un objeto IfxReal a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-744
Sintaxis
Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxRowId: Crea una instancia de un objeto IfxRowId a partir de los datos de columna.
3-745

Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxString:
3-746
Crea una instancia de un objeto IfxString a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Excepciones
3-747
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxTime: Crea una instancia de un objeto IfxTime a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Excepciones
3-748
Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxTimeStamp: Crea una instancia de un objeto IfxTimeStamp a partir de los datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
El tipo de datos Informix DATETIME tiene el formato interno como AAAA-MM-DD HH:MM:SS.nnnnn, el tipo de datos IfxType, TIMESTAMP, tiene un formato de AAAA-MM-DD-HH.MM.SS.nnnnnn. Esta diferencia en formato en la parte fraccional requiere un pequeo ajuste para que coincidan los formato. Al leer de la base de datos, se aadir un cero como dgito menos significativo para que
3-749
coincida con los seis dgitos fraccionales. De forma similar, cuando se escriba en la base de datos, se truncar el dgito menos significativo en la fraccin para que coincida con el formato de tipo Informix DATETIME. Excepciones
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxValue: Crea una instancia de Object a partir de datos de columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Objeto (object) que representa el valor de la columna en su formato nativo.
3-750
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetIfxValues: Obtiene todos los valores de las columnas correspondientes a la fila actual. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Parmetros values Matriz de Object en la que se copiarn los valores de las columnas correspondientes a la fila actual. Valor de retorno Nmero de instancias de Object de la matriz. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-751
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetDataTypeName: Obtiene el nombre del tipo de datos fuente. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis

Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetDate: Obtiene el valor de la columna especificada como un objeto DateTime. Espacio de nombres: IBM.Data.Informix
3-752


Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetDateTime: Obtiene el valor de la columna especificada como un objeto DateTime.
3-753


Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-754
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetDecimal: Obtiene el valor de la columna especificada como un decimal. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis

3-755
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetDouble: Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin doble. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-756
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetFieldType: Obtiene el Type que es el tipo de datos del objeto. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-757

Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetFloat: Obtiene el valor de la columna especificada como un nmero de coma flotante de precisin simple. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno El valor de la columna especificada como un nmero de coma flotante de precisin simple.
3-758
Excepciones
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetGuid: No est soportado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-759

Comentarios Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetInt16: Obtiene el valor de la columna especificada como un entero con signo de 16 bits. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-760
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetInt32: Obtiene el valor de la columna especificada como un entero con signo de 32 bits. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetInt32( _ ByVal i As Integer _ ) As Integer [C#] public int GetInt32( int i ); [C++] public: int GetInt32( int i );
3-761
[JScript] public function GetInt32( i : int ) : int;
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetInt64: Obtiene el valor de la columna especificada como un entero con signo de 64 bits. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetInt64( _ ByVal i As Integer _
3-762
) As Long [C#] public long GetInt64( int i ); [C++] public: __int64 GetInt64( int i ); [JScript] public function GetInt64( i : int ) : long;
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetName: Obtiene el nombre de la columna especificada. Espacio de nombres: IBM.Data.Informix
3-763

Valor de retorno Una serie que es el nombre de la columna especificada. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetOrdinal: Obtiene el ordinal de columna, dado el nombre de la columna. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetOrdinal( _ ByVal value As String _ ) As Integer [C#] public int GetOrdinal( string value ); [C++] public: int GetOrdinal( String* value );
3-764
[JScript] public function GetOrdinal( value : String ) : int;
Valor de retorno El ordinal de columna basado en cero. Comentarios GetOrdinal realiza en primer lugar una bsqueda sensible a maysculas y minsculas. Si falla, se realiza una segunda bsqueda no sensible a maysculas y minsculas. GetOrdinal no es sensible al ancho kana. Puesto que las bsquedas basadas en ordinal son ms eficaces que las bsquedas con nombre, no es eficaz llamar a GetOrdinal dentro de un bucle. En su lugar, llame a GetOrdinal una vez y, a continuacin, asigne los resultados a una variable de entero para utilizarla dentro del bucle. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetString: Obtiene el valor de la columna especificada como una serie de caracteres. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetString( _ ByVal i As Integer _ ) As String [C#] public string GetString( int i ); [C++] public: String* GetString( int i );
3-765
[JScript] public function GetString( i : int ) : String;

Comentarios No se realizan conversiones. Los datos que se van a recuperar deben ser uno de los siguientes tipos: v IfxType.Xml v IfxType.Char v IfxType.VarChar v IfxType.LongVarChar v IfxType.Clob v IfxType.Graphic v IfxType.VarGraphic v IfxType.LongVarGraphic v IfxType.DbClob La tabla siguiente describe la correlacin entre el tipo de datos de objeto de retorno y el tipo de datos de servidor de datos.
Invoque IsDBNull para comprobar si existen valores nulos antes de llamar a este mtodo. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-766
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetTime: Obtiene el valor de la columna especificada como un objeto TimeSpan. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Excepciones
Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-767
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetTimeSpan: Obtiene el valor de la columna especificada como un objeto TimeSpan. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Excepciones
Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-768
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetValue: Obtiene el valor de la columna en el ordinal especificado en su formato nativo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno El valor de la columna en su formato nativo. Comentarios Este mtodo devuelve DBNull para columnas de base de datos nula. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.GetValues: Obtiene todas las columnas de atributos en la fila actual. Espacio de nombres: IBM.Data.Informix
3-769

Parmetros values Una matriz de tipo Object en la que se deben copiar las columnas de atributos. Valor de retorno El nmero de instancias de Object en la matriz. Comentarios Para la mayora de aplicaciones, el mtodo GetValues proporciona un medio eficaz de recuperar todas las columnas, en lugar de recuperar cada columna individualmente. Puede pasar una matriz Object que contenga menos columnas que el nmero de columnas contenidas en la fila resultante. Slo se copia en la matriz la cantidad de datos que contiene la matriz Object. Tambin se puede pasar una matriz Object cuya longitud sea superior al nmero de columnas contenidas en la fila resultante. Este mtodo devuelve DBNull para columnas de base de datos nula. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.IsDBNull: Obtiene un valor que indica si la columna contiene valores no existentes o si faltan. Espacio de nombres: IBM.Data.Informix
3-770

Valor de retorno true si el valor de columna especificado es equivalente a DBNull; de lo contrario, false. Comentarios Para evitar que se emita un error, invoque este mtodo para comprobar si hay valores de columna nulos antes de llamar a los mtodos Get tipificados Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.IsSetAsDefault: Determina si la ltima modificacin del valor de la posicin ordinal de la columna especificada ha sido realizada por la funcin SetDefault. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function IsSetAsDefault (Integer i) As Boolean [C#] public bool IsSetAsDefault (int i) [C++]
3-771
public: virtual bool IsSetAsDefault (int i) [JScript] public function IsSetAsDefault (i: int) : Boolean
Valor de retorno true si la ltima modificacin del valor de la columna especificada ha sido realizada por la funcin SetDefault; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetBoolean: No est soportado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetBoolean ( _ i As Integer, _ value As Boolean _ ) [C#] public void SetBoolean ( int i, bool value ) [C++] public: virtual void SetBoolean ( int i, bool value ) [JScript] public function SetBoolean ( i : int, value : boolean )
3-772
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetByte: No est soportado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetByte ( _ i As Integer, _ value As Byte _ ) [C#] public void SetByte ( int i, byte value ) [C++] public: virtual void SetByte ( int i, byte value ) [JScript] public function SetByte ( i : int, value : byte )
3-773
Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetBytes: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetBytes ( _ i As Integer, _ buffer() As Byte () _ ) [C#] public void SetBytes ( int i, byte[] buffer ) [C++] public: virtual void SetBytes ( int i, unsigned char buffer __gc[] ) [JScript] public function SetBytes ( i : int, buffer : Byte[] )
buffer Valor que se insertar en la columna especificada. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-774
Mtodo IfxUpdatableRecord.SetChar: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetChar ( _ i As Integer, _ value As Char _ ) [C#] public void SetChar ( int i, char value ) [C++] public: virtual void SetChar ( int i, wchar_t value ) [JScript] public function SetChar ( i : int, value : char )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetChars: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-775
Sintaxis
Visual Basic] Public Sub SetChars ( _ i As Integer, _ buffer() As Char() _ ) [C#] public void SetChars ( int i, char[] buffer ) [C++] public: virtual void SetChars ( int i, unsigned char buffer __gc[] ) [JScript] public function SetChars ( i : int, buffer : char[] )
buffer Valor que se insertar en la columna especificada. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetIfxBinary: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxBinary ( _ i As Integer, _ value As IfxBinary _ ) [C#] public void SetIfxBinary ( int i, IfxBinary value
3-776
) [C++] public: virtual void SetIfxBinary ( int i, IfxBinary value ) [JScript] public function SetIfxBinary ( i : int, value : IfxBinary )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetIfxDate: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxDate ( _ i As Integer, _ value As IfxDate _ ) [C#] public void SetIfxDate ( int i, IfxDate value ) [C++] public: virtual void SetIfxDate ( int i, IfxDate value ) [JScript]
3-777
public function SetIfxDate ( i : int, value : IfxDate )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetIfxDecimal: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxDecimal ( _ i As Integer, _ value As IfxDecimal _ ) [C#] public void SetIfxDecimal ( int i, IfxDecimal value ) [C++] public: virtual void SetIfxDecimal ( int i, IfxDecimal value ) [JScript] public function SetIfxDecimal ( i : int, value : IfxDecimal )
3-778
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetIfxDouble: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxDouble ( _ i As Integer, _ value As IfxDouble _ ) [C#] public void SetIfxDouble ( int i, IfxDouble value ) [C++] public: virtual void SetIfxDouble ( int i, IfxDouble value ) [JScript] public function SetIfxDouble ( i : int, value : IfxDouble )
3-779
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetIfxInt16: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetIfxInt32: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix
3-780

Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetIfxInt64: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxInt64 ( _ i As Integer, _ value As IfxInt64 _ ) [C#]
3-781
public void SetIfxInt64 ( int i, IfxInt64 value ) [C++] public: virtual void SetIfxInt64 ( int i, IfxInt64 value ) [JScript] public function SetIfxInt64 ( i : int, value : IfxInt64 )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetIfxReal370: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxReal370 ( _ i As Integer, _ value As IfxReal370 _ ) [C#] public void SetIfxReal370 ( int i, IfxReal370 value ) [C++] public: virtual void SetIfxReal370 ( int i, IfxReal370 value ) [JScript]
3-782
public function SetIfxReal370 ( i : int, value : IfxReal370 )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetIfxReal: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxReal ( _ i As Integer, _ value As IfxReal _ ) [C#] public void SetIfxReal ( int i, IfxReal value ) [C++] public: virtual void SetIfxReal ( int i, IfxReal value ) [JScript] public function SetIfxReal ( i : int, value : IfxReal )
3-783
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetIfxString: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxString ( _ i As Integer, _ value As IfxString _ ) [C#] public void SetIfxString ( int i, IfxString value ) [C++] public: virtual void SetIfxString ( int i, IfxString value ) [JScript] public function SetIfxString ( i : int, value : IfxString )
3-784
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetIfxTime: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetIfxTime ( _ i As Integer, _ value As IfxTime _ ) [C#] public void SetIfxTime ( int i, IfxTime value ) [C++] public: virtual void SetIfxTime ( int i, IfxTime value ) [JScript] public function SetIfxTime ( i : int, value : IfxTime )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetIfxTimeStamp: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix
3-785

Visual Basic] Public Sub SetIfxTimeStamp ( _ i As Integer, _ value As IfxTimeStamp _ ) [C#] public void SetIfxTimeStamp ( int i, IfxTimeStamp value ) [C++] public: virtual void SetIfxTimeStamp ( int i, IfxTimeStamp value ) [JScript] public function SetIfxTimeStamp ( i : int, value : IfxTimeStamp )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetDate: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetDate ( _ i As Integer, _ value As DateTime _ ) [C#]
3-786
public void SetDate ( int i, DateTime value ) [C++] public: virtual void SetDate ( int i, DateTime value ) [JScript] public function SetDate ( i : int, value : DateTime )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetDateTime: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetDateTime ( _ i As Integer, _ value As DateTime _ ) [C#] public void SetDateTime ( int i, DateTime value ) [C++] public: virtual void SetDateTime ( int i, DateTime value ) [JScript]
3-787
public function SetDateTime ( i : int, value : DateTime )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetDecimal: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetDecimal ( _ i As Integer, _ value As Decimal _ ) [C#] public void SetDecimal ( int i, decimal value ) [C++] public: virtual void SetDecimal ( int i, decimal value ) [JScript] public function SetDecimal ( i : int, value : decimal )
3-788
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetDefault: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetDefault ( _ i As Integer _ ) [C#] public void SetDate ( int i ) [C++] public: virtual void SetDate ( int i ) [JScript] public function SetDate ( i : int )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetDouble:
3-789
Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetDouble ( _ i As Integer, _ value As Double _ ) [C#] public void SetDouble ( int i, double value ) [C++] public: virtual void SetDouble ( int i, double value ) [JScript] public function SetDouble ( i : int, value : double )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetFloat: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-790
Sintaxis
Visual Basic] Public Sub SetFloat ( _ i As Integer, _ value As Single _ ) [C#] public void SetFloat ( int i, float value ) [C++] public: virtual void SetFloat ( int i, float value ) [JScript] public function SetFloat ( i : int, value : float )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetGuid: No est soportado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetGuid ( _ i As Integer, _ value As Guid _ ) [C#] public void SetGuid ( int i, Guid value
3-791
) [C++] public: virtual void SetGuid ( int i, Guid value ) [JScript] public function SetGuid ( i : int, value : Guid )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetInt16: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetInt16 ( _ i As Integer, _ value As Short _ ) [C#] public void SetInt16 ( int i, short value ) [C++] public: virtual void SetInt16 ( int i, short value ) [JScript]
3-792
public function SetInt16 ( i : int, value : short )
Visual Basic] Public Sub SetInt32 ( _ i As Integer, _ value As Integer _ ) [C#] public void SetInt32 ( int i, int value ) [C++] public: virtual void SetInt32 ( int i, int value ) [JScript] public function SetInt32 ( i : int, value : int )
3-793
Visual Basic] Public Sub SetInt64 ( _ i As Integer, _ value As Long _ ) [C#] public void SetInt64 ( int i, long value ) [C++] public: virtual void SetInt64 ( int i, long long value ) [JScript] public function SetInt64 ( i : int, value : long )
3-794
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetNull: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetNull ( _ i As Integer _ ) [C#] public void SetNull ( int i ) [C++] public: virtual void SetNull ( int i ) [JScript] public function SetNull ( i : int )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetString: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-795
Sintaxis
Visual Basic] Public Sub SetString ( _ i As Integer, _ value As String _ ) [C#] public void SetString ( int i, string value ) [C++] public: virtual void SetString ( int i, String^ value ) [JScript] public function SetString ( i : int, value : String )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetTime: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetTime ( _ i As Integer, _ value As TimeSpan _ ) [C#] public void SetTime ( int i, TimeSpan value
3-796
) [C++] public: virtual void SetTime ( int i, TimeSpan value ) [JScript] public function SetTime ( i : int, value : TimeSpan )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetTimeSpan: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetTimeSpan ( _ i As Integer, _ value As TimeSpan _ ) [C#] public void SetTimeSpan ( int i, TimeSpan value ) [C++] public: virtual void SetTimeSpan ( int i, TimeSpan value ) [JScript]
3-797
public function SetTimeSpan ( i : int, value : TimeSpan )
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetValue: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetValue ( _ i As Integer, _ value As Object _ ) [C#] public void SetValue ( int i, Object value ) [C++] public: virtual void SetValue ( int i, Object value ) [JScript] public function SetValue ( i : int, value : Object )
3-798
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Mtodo IfxUpdatableRecord.SetValues: Sobrescriba la columna con un valor nuevo. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub SetValues ( _ values As Object() _ ) [C#] public void SetValues ( Object[] valores ) [C++] public: virtual void SetValues ( Object valores __gc[] ) [JScript] public function SetValues ( values : Object[] )
values Valor que se insertar en la columna especificada. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-799
Propiedades de IfxUpdatableRecord
Las propiedades de la clase IfxUpdatableRecord se listan a continuacin.
Propiedades pblicas
Consulta Miembros de IfxUpdatableRecord en la pgina 3-718 Representa un registro nuevo a crear. Las tablas siguientes listan los miembros expuestos por la clase IfxUpdatableRecord. Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxUpdatableRecord.FieldCount: Obtiene el nmero de columnas de la fila actual. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-800
Comentarios Despus de ejecutar una consulta que no devuelve filas, FieldCount devuelve 0. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxUpdatableRecord.this: Obtiene el valor de una columna en su formato nativo. Lista de sobrecargas
Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Miembros de IfxUpdatableRecord en la pgina 3-718 Representa un registro nuevo a crear. Las tablas siguientes listan los miembros expuestos por la clase IfxUpdatableRecord. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxUpdatableRecord.this: Obtiene el valor de la columna especificada en su formato nativo dado el ordinal de columna. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Miembros de IfxUpdatableRecord en la pgina 3-718 Representa un registro nuevo a crear. Las tablas siguientes listan los miembros expuestos por la clase IfxUpdatableRecord. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider
3-801
para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Propiedad IfxUpdatableRecord.this (String): Obtiene el valor de la columna especificada en su formato nativo dado el nombre de columna. Consulta Clase IfxUpdatableRecord en la pgina 3-717 Representa una fila nueva que se crear en una instancia de IfxResultSet. Miembros de IfxUpdatableRecord en la pgina 3-718 Representa un registro nuevo a crear. Las tablas siguientes listan los miembros expuestos por la clase IfxUpdatableRecord. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
Espacio de nombres IBM.Data.IfxTypes

El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Comentarios
La tabla siguiente muestra las correlaciones entre los tipos de datos IfxType, los tipos de datos , los tipos de datos Informix, los tipos Microsoft .NET Framework y las clases y estructuras de IfxTypes.
Categora Clases y estructuras de IfxTypes IfxInt16 IfxInt32 IfxInt64 IfxReal, IfxReal370 IfxDouble Tipo de datos IfxType SmallInt Integer BigInt Real Double Tipo de datos Informix BOOLEAN, SMALLINT INTEGER, INT, SERIAL INT8, SERIAL8 REAL, SMALLFLOAT Tipo de datos .NET Int16 Int32 Int64 Single
Numeric
DECIMAL (31), Double DOUBLE PRECISION DECIMAL (32), FLOAT MONEY Double Decimal
IfxDouble IfxDecimal IfxDecimal
Float Decimal Numeric
DECIMAL (31), Decimal NUMERIC
3-802
Categora
Clases y estructuras de IfxTypes IfxDate IfxTime IfxTimeStamp
Tipo de datos IfxType Date Time Timestamp
Tipo de datos Informix DATETIME (date precision) DATETIME (time precision) DATETIME (time and date precision) CHAR VARCHAR LVARCHAR CLOB, TEXT
Tipo de datos .NET DateTime TimeSpan DateTime
Fecha/Hora
Datos de carcter
IfxString IfxString IfxString
Char VarChar LongVarChar Clob
String String String String
Datos LOB
IfxClob
Consulta Enumeracin IfxType en la pgina 3-714 Especifica el tipo de datos de un campo, una propiedad o un IfxParameter. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento. Captulo 3, IBM Data Server Provider for .NET, en la pgina 3-1 IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece un acceso seguro y de alto rendimiento a los servidores de datos IBM.
Estructura IfxBinary
Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Public [C#] public [C++] public Basic] Structure IfxBinary struct IfxBinary value class IfxBinary
Ejemplo
[C#] El ejemplo siguiente demuestra cmo recuperar un solo valor de columna de serie de caracteres FOR BIT DATA de una tabla.
[C#] public static string getParam(IfxConnection conn) { string mySelectQuery = "SELECT BINARYCOL FROM TESTTBL";
3-803
IfxCommand myCommand = new IfxCommand(mySelectQuery, conn); IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxBinary selectValue = reader.GetIfxBinary(0); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxBinary Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxBinary. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxBinary
Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxBinary.
Campos pblicos
Valor de Null para IfxBinary. Null
IfxBinary Inicializa una nueva estructura IfxBinary, con la matriz de bytes especificada.
Propiedades pblicas
IsNull Value Obtiene un valor que indica si el valor almacenado en el objeto IfxBinary es nulo. Obtiene el valor almacenado en la estructura IfxBinary.
3-804
Mtodos pblicos
ToString op_explicit op_implicit Devuelve una serie de caracteres que representa la estructura IfxBinary. Convierte la estructura IfxBinary proporcionada en una matriz de bytes. Convierte la matriz de bytes proporcionada en IfxBinary.
Consulta Estructura IfxBinary en la pgina 3-803 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Campos de IfxBinary
Los campos de la clase IfxBinary se listan a continuacin.
Campos pblicos
Valor de Null para IfxBinary. Null
Consulta Miembros de IfxBinary en la pgina 3-804 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxBinary. Estructura IfxBinary en la pgina 3-803 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxBinary.Null: Valor de Null para IfxBinary. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-805
Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxBinary [C#] public static readonly IfxBinary Null [C++] public: static initonly IfxBinary Null [JScript] public static final var Null () : IfxBinary
Comentarios El valor de esta constante es NULL. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxBinary en la pgina 3-803 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Constructor de IfxBinary
Inicializa un nuevo objeto IfxBinary, con la matriz de bytes especificada. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] Public Sub New(value as Byte()) [C#] public IfxBinary(byte[] value); [C++] public: IfxBinary(unsigned char value __gc[] ); [JScript] public function IfxBinary(value : byte[]);
Parmetros
value Matriz de bytes para llenar la instancia de IfxBinary.
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxBinary en la pgina 3-803 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA,
3-806
VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxBinary
Los mtodos de la estructura IfxBinary se listan a continuacin.
Mtodos pblicos
ToString op_explicit op_implicit Devuelve una serie de caracteres que representa la estructura IfxBinary. Convierte la estructura IfxBinary proporcionada en una matriz de bytes. Convierte la matriz de bytes proporcionada en IfxBinary.
Consulta Miembros de IfxBinary en la pgina 3-804 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxBinary. Estructura IfxBinary en la pgina 3-803 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxBinary.op_explicit: Convierte la estructura IfxBinary proporcionada en una matriz de bytes. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Narrowing Operator CType (origen As IfxBinary) As Byte() [C#] public static explicit operator byte[] (IfxBinary origen) [C++] public: static explicit operator array<unsigned char>^ ( IfxBinary origen )
Parmetros source Estructura IfxBinary que se convertir en una matriz de bytes.
3-807
Valor de retorno Valor de matriz de bytes convertida a partir de una instancia de IfxBinary. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxBinary en la pgina 3-803 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxBinary.op_implicit: Convierte la matriz de bytes proporcionada en IfxBinary. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Widening Operator CType (origen As Byte()) As IfxBinary [C#] public static implicit operator IfxBinary (byte[] origen) [C++] public: static implicit operator IfxBinary (unsigned char origen __gc[] )
Parmetros source Matriz de bytes que se convertir en IfxBinary. Valor de retorno Estructura IfxBinary con el valor de origen. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxBinary en la pgina 3-803 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxBinary.ToString:
3-808
Devuelve una serie de caracteres que representa la estructura IfxBinary. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function ToString As String [C#] public override string ToString () [C++] public: virtual String^ ToString () override [JScript] public override function ToString () : String
Valor de retorno Cadena de caracteres compuesta de valores hexadecimales para cada byte del valor de la estructura IfxBinary. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxBinary en la pgina 3-803 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Propiedades de IfxBinary
Las propiedades de la estructura IfxBinary se listan a continuacin.
Propiedades pblicas
IsNull Value Obtiene un valor que indica si el valor almacenado en el objeto IfxBinary es nulo. Obtiene el valor almacenado en la estructura IfxBinary.
Consulta Miembros de IfxBinary en la pgina 3-804 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxBinary. Estructura IfxBinary en la pgina 3-803 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET.
3-809
Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxBinary.IsNull: Obtiene un valor que indica si el valor almacenado en la estructura IfxBinary es nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property IsNull As Boolean [C#] public bool IsNull {get;} [C++] public: __property bool get_IsNull(); [JScript] public final function get IsNull() : boolean
Valor de la propiedad true si Value es nulo; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxBinary en la pgina 3-803 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxBinary.Value: Obtiene el valor almacenado en la objeto IfxBinary. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Value As Byte() [C#] public byte[] Value {get;}
3-810
[C++] public: __property unsigned char value __gc[] get_Value(); [JScript] public function get Value() : byte[];
Valor de la propiedad Matriz de bytes que representa la instancia de IfxBinary. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxBinary en la pgina 3-803 Representa los tipos de datos BINARY, VARBINARY, CHAR FOR BIT DATA, VARCHAR FOR BIT DATA y LONG VARCHAR FOR BIT DATA DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Clase IfxClob
Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Public [C#] public [C++] public Basic] Structure IfxClob struct IfxClob value class IfxClob
Ejemplo
[C#] El ejemplo siguiente demuestra cmo recuperar un nico valor de columna CLOB de una tabla.
[C#] public static string getParam(IfxConnection conn) { string mySelectQuery = "SELECT * FROM EMP_RESUME"; IfxCommand myCommand = new IfxCommand(mySelectQuery, conn); IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxClob selectValue = reader.GetIfxClob(2); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
3-811
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxClob Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxClob. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxClob
Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxClob.
Campos pblicos
Valor de Null para IfxClob. Null
IfxClob Inicializa un nuevo objeto IfxClob con la serie especificada.
Propiedades pblicas
CacheData Indica si los datos almacenados en la posicin de cursor actual de la instancia de IfxClob se est almacenando en la antememoria. Obtiene un valor que indica si el valor almacenado en el objeto IfxClob es nulo. Obtiene el valor almacenado en el objeto IfxClob.
IsNull Value
Mtodos pblicos
GetChars Lee una corriente de caracteres desde el desplazamiento de columna especificado en el almacenamiento intermedio como una matriz, empezando por el desplazamiento del almacenamiento intermedio indicado. Devuelve una serie de caracteres que representa la estructura IfxClob.
ToString
3-812
Consulta Clase IfxClob en la pgina 3-811 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Campos de IfxClob
Los campos de la estructura IfxClob se listan a continuacin.
Campos pblicos
Valor de Null para IfxClob. Null
Consulta Miembros de IfxClob en la pgina 3-812 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxClob. Clase IfxClob en la pgina 3-811 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxClob.Null: Valor de Null para IfxClob. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxClob [C#] public static readonly IfxClob Null [C++] public: static initonly IfxClob Null [JScript] public static final var Null () : IfxClob
Comentarios El valor de esta constante es NULL. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0
3-813
Consulta Clase IfxClob en la pgina 3-811 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Constructor de IfxClob
Inicializa una estructura IfxClob nueva con la serie especificada. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] Public Sub New(value as String) [C#] public IfxClob(string value); [C++] public: IfxClob(string value); [JScript] public function IfxClob(value : string);
Parmetros
value Serie de caracteres que representa la instancia de IfxClob.
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxClob en la pgina 3-811 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxClob
Los mtodos de la estructura IfxClob se listan a continuacin.
Mtodos pblicos
GetChars Lee una corriente de caracteres desde el desplazamiento de columna especificado en el almacenamiento intermedio como una matriz, empezando por el desplazamiento del almacenamiento intermedio indicado. Devuelve una serie de caracteres que representa la estructura IfxClob.
ToString
Consulta
3-814
Miembros de IfxClob en la pgina 3-812 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxClob. Clase IfxClob en la pgina 3-811 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxClob.GetChars: Lee una corriente de caracteres desde el desplazamiento de columna especificada en el almacenamiento intermedio como una matriz, empezando en el desplazamiento de almacenamiento intermedio determinado. Espacio de nombres: IBM.Data.Informix Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Function GetChars( _ ByVal dataIndex As Long, _ ByVal buffer() As Char, _ ByVal bufferIndex As Integer, _ ByVal length As Integer _ ) As Long [C#] public long GetChars( long dataIndex, char[] buffer, int bufferIndex, int length ); [C++] public: __int64 GetChars( __int64 dataIndex, __wchar_t buffer __gc[], int bufferIndex, int length ); [JScript] public function GetChars( dataIndex : long, buffer : Char[], bufferIndex : int, length : int ) : long;
Parmetros dataIndex El ndice de la fila donde debe empezar la operacin de lectura. buffer El almacenamiento intermedio en el que se deben copiar los datos. bufferIndex El ndice donde buffer debe empezar la operacin de grabacin. length El nmero de caracteres que se va a leer.
3-815
Valor de retorno El nmero real de caracteres ledos. Excepciones

Tipo de excepcin IfxException InvalidOperationException Condicin Conversin no vlida. No hay ms datos a devolver.
Comentarios GetChars devuelve el nmero de caracteres disponibles en el campo. En la mayora de casos esta es la longitud exacta del campo. Sin embargo, el nmero devuelto puede ser inferior a la longitud verdadera del campo si GetChars ya se ha utilizado para obtener caracteres del campo. Este caso puede darse, por ejemplo, si IfxClob est leyendo un CLOB en un almacenamiento intermedio. Para obtener ms informacin, consulte el valor SequentialAccess de System.Data.CommandBehavior en la documentacin del SDK de Microsoft(R) .NET Framework. Si pasa un almacenamiento intermedio que es un valor nulo, GetChars devuelve la longitud del campo en caracteres. Si la propiedad CacheData es false, las aplicaciones solo pueden recuperar todo el conjunto de datos de una instancia de IfxClob una vez. Los intentos adicionales de recuperar datos darn como resultado una InvalidOperationException. Las implicaciones especficas de esto son las siguientes: v Este mtodo slo se puede utilizar para recuperar todo el conjunto de daos de una instancia de IfxClob una vez. v Si utiliza este mtodo para recuperar datos de una instancia de IfxClob, no puede utilizar la propiedad Value o el mtodo ToString para hacer lo mismo. v Si ya ha utilizado la propiedad Value o el mtodo ToString para recuperar datos de una instancia de IfxClob, no puede utilizar este mtodo para hacer lo mismo. Si la propiedad CacheData es true, se pueden leer los datos de la estructura DB2Clob utilizando cualquiera de los mtodos de acceso. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxClob en la pgina 3-811 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Miembros de IfxClob en la pgina 3-812 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxClob. Espacio de nombres IBM.Data.Informix en la pgina 3-1 El espacio de nombres IBM.Data.Informix es el .NET Framework Data Provider para los servidores de datos IBM. IBM Data Server Provider for .NET ampla el soporte a la interfaz ADO.NET y ofrece acceso a los datos seguro y de alto rendimiento.
3-816
Mtodo IfxClob.ToString: Devuelve una serie de caracteres que representa la estructura IfxClob. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Serie de caracteres que representa el valor de la estructura IfxClob. Excepciones
Tipo de excepcin InvalidOperationException Condicin No hay ms datos a devolver.
Comentarios Si la propiedad CacheData es false, las aplicaciones solo pueden recuperar todo el conjunto de datos de una instancia de IfxClob una vez. Los intentos adicionales de recuperar datos darn como resultado una InvalidOperationException. Las implicaciones especficas de esto son las siguientes: v Este mtodo slo se puede utilizar para recuperar datos de una instancia de IfxClob una vez. v Si utiliza este mtodo para recuperar datos de una instancia de IfxClob, no puede utilizar la propiedad Value o el mtodo GetChars para hacer lo mismo. v Si ya ha utilizado la propiedad Value o el mtodo GetChars para recuperar datos de una instancia de IfxClob, no puede utilizar este mtodo para hacer lo mismo. Si la propiedad CacheData es true, se pueden leer los datos de la estructura DB2Clob utilizando cualquiera de los mtodos de acceso. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxClob en la pgina 3-811 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-817
Propiedades de IfxClob
Las propiedades de la estructura IfxClob se listan a continuacin.
Propiedades pblicas
CacheData Indica si los datos almacenados en la posicin de cursor actual de la instancia de IfxClob se est almacenando en la antememoria. Obtiene un valor que indica si el valor almacenado en el objeto IfxClob es nulo. Obtiene el valor almacenado en el objeto IfxClob.
IsNull Value
Consulta Miembros de IfxClob en la pgina 3-812 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxClob. Clase IfxClob en la pgina 3-811 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxClob.CacheData: Indica si los datos almacenados en la posicin de cursor actual de la instancia de IfxClob se est almacenando en la antememoria. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property CacheData As Boolean [C#] public bool CacheData {get;} [C++] public: __property bool get_CacheData(); [JScript] public function get CacheData() : Boolean;
Valor de la propiedad true si la instancia de la estructura IfxClob se est almacenando en la antememoria; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta
3-818
Clase IfxClob en la pgina 3-811 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Miembros de IfxClob en la pgina 3-812 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxClob. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxClob.IsNull: Obtiene un valor que indica si el valor almacenado en la estructura IfxClob es nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de la propiedad true si Value es nulo; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxClob en la pgina 3-811 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxClob.Value: Obtiene el valor almacenado en la estructura IfxClob. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-819
Sintaxis
Visual Basic] Public ReadOnly Property Value As String [C#] public string Value {get;} [C++] public: __property string get_Value(); [JScript] public function get Value() : string;
Valor de la propiedad Serie de caracteres que representa la instancia de IfxClob. Excepciones

Tipo de excepcin InvalidOperationException Condicin No hay ms datos a devolver.
Comentarios Si la propiedad CacheData es false, las aplicaciones solo pueden recuperar todo el conjunto de datos de una instancia de IfxClob una vez. Los intentos adicionales de recuperar datos darn como resultado una InvalidOperationException. Las implicaciones especficas de esto son las siguientes: v La propiedad solo se puede utilizar para recuperar datos de una instancia de IfxClob una vez. v Si utiliza esta propiedad para recuperar datos de una instancia de IfxClob, no puede utilizar los mtodos ToString o GetChars para hacer lo mismo. v Si ya ha utilizado los mtodos ToString o GetChars para recuperar datos de una instancia de IfxClob, no puede utilizar esta propiedad para hacer lo mismo. Si la propiedad CacheData es true, se pueden leer los datos de la estructura DB2Clob utilizando cualquiera de los mtodos de acceso. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Clase IfxClob en la pgina 3-811 Representa el tipo de datos CLOB de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Estructura IfxDate
Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-820
System.Object IBM.Data.Informix.IfxDate
Sintaxis
Visual Public [C#] public [C++] public Basic] Structure IfxDate struct IfxDate value class IfxDate
Ejemplo
[C#] El ejemplo siguiente demuestra cmo recuperar un solo valor de columna DATE de una tabla.
[C#] public static string getParam(IfxConnection conn) { string mySelectQuery = "SELECT * FROM EMPLOYEE"; IfxCommand myCommand = new IfxCommand(mySelectQuery, conn); IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxTime selectValue = reader.GetIfxTime(6); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxDate Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxDate. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxDate
Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxDate.
3-821
Campos pblicos
MaxValue MinValue Valor de Null para IfxDate. Null Valor mximo de IfxDate: Diciembre 31, 9999. Valor mnimo de IfxDate: Enero 1, 0001.
IfxDate Inicializa un nuevo objeto IfxDate con el valor DateTime especificado.
Propiedades pblicas
IsNull Value Obtiene un valor que indica si el valor almacenado en el objeto IfxDate es nulo. Obtiene el valor almacenado en el objeto IfxDate en la forma de un objeto DateTime.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres proporcionada en IfxDate. Devuelve una serie de caracteres que representa la estructura IfxDate. Convierte la estructura IfxDate proporcionada en un valor DateTime. Convierte el valor DateTime proporcionado en IfxDate.
Consulta Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Campos de IfxDate
Los campos de la estructura IfxDate se listan a continuacin.
Campos pblicos
MaxValue MinValue Valor mximo de IfxDate: Diciembre 31, 9999. Valor mnimo de IfxDate: Enero 1, 0001.
3-822
Valor de Null para IfxDate. Null
Consulta Miembros de IfxDate en la pgina 3-821 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxDate. Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxDate.MaxValue: Valor mximo de IfxDate: Diciembre 31, 9999. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MaxValue As IfxDate [C#] public static readonly IfxDate MaxValue [C++] public: static initonly IfxDate MaxValue [JScript] public static final var MaxValue () : IfxDate
Comentarios El valor de esta constante es Diciembre 31, 9999. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxDate.MinValue: Valor mnimo de IfxDate: Enero 1, 0001.
3-823

Visual Basic] Public Shared ReadOnly MinValue As IfxDate [C#] public static readonly IfxDate MinValue [C++] public: static initonly IfxDate MinValue [JScript] public static final var MinValue () : IfxDate
Comentarios El valor de esta constante es: Enero 1, 0001. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxDate.Null: Valor de Null para IfxDate. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxDate [C#] public static readonly IfxDate Null [C++] public: static initonly IfxDate Null [JScript] public static final var Null () : IfxDate
Comentarios El valor de esta constante es NULL.
3-824
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Constructor de IfxDate
Inicializa una estructura IfxDate nueva con el valor DateTime specificado. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] Public Sub New(value as DateTime) [C#] public IfxDate(DateTime value); [C++] public: IfxDate(DateTime value); [JScript] public function IfxDate(value : DateTime);
Parmetros
value Un valor DateTime para llenar la instancia de IfxDate.
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxDate
Los mtodos de las estructura IfxDate se listan a continuacin.
Mtodos pblicos
Parse ToString Convierte la Serie de caracteres proporcionada en IfxDate. Devuelve una serie de caracteres que representa la estructura IfxDate.
3-825
op_explicit op_implicit
Convierte la estructura IfxDate proporcionada en un valor DateTime. Convierte el valor DateTime proporcionado en IfxDate.
Consulta Miembros de IfxDate en la pgina 3-821 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxDate. Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxDate.op_explicit: Convierte la estructura IfxDate proporcionada en un valor DateTime. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Narrowing Operator CType (origen As IfxDate) As DateTime [C#] public static explicit operator DateTime (IfxDate origen) [C++] public: static explicit operator DateTime (IfxDate origen)
Parmetros source Estructura IfxDate que se convertir en un valor DateTime. Valor de retorno Un valor DateTime que se convertir en una instancia de IfxDate. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxDate.op_implicit:
3-826
Convierte el valor DateTime proporcionado en IfxDate. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Widening Operator CType (origen As DateTime) As IfxDate [C#] public static implicit operator IfxDate (DateTime origen) [C++] public: static implicit operator IfxDate (DateTime origen)
Parmetros source Un valor DateTime que se convertir en IfxDate. Valor de retorno Estructura IfxDate con el valor de source. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxDate.Parse: Convierte la Serie de caracteres proporcionada en IfxDate. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Function Parse (szDate As String) As IfxDate [C#] public static IfxDate Parse (string szDate) [C++] public: static IfxDate Parse (string szDate) [JScript] public static function Parse (szDate String ) : IfxDate
3-827
Parmetros szDate Valor de Serie de caracteres que se convertir en IfxDate. La representacin de la serie de caracteres de la fecha debe reflejar el formato de fecha que corresponde al cdigo de territorio de la aplicacin de cliente. Valor de retorno Estructura IfxDate con el valor numrico de szDate. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxDate.ToString: Devuelve una serie de caracteres que representa la estructura IfxDate. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Serie de caracteres que representa el valor de la estructura IfxDate. La representacin de la serie de caracteres reflejar el formato de fecha que corresponde al cdigo de territorio de la aplicacin de cliente. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET.
3-828
Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Propiedades de IfxDate
Las propiedades de la estructura IfxDate se listan a continuacin.
Propiedades pblicas
IsNull Value Obtiene un valor que indica si el valor almacenado en el objeto IfxDate es nulo. Obtiene el valor almacenado en el objeto IfxDate en la forma de un objeto DateTime.
Consulta Miembros de IfxDate en la pgina 3-821 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxDate. Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxDate.IsNull: Obtiene un valor que indica si el valor almacenado en el objeto IfxDate es nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de la propiedad true si Value es nulo; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta
3-829
Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxDate.Value: Obtiene el valor almacenado en la estructura IfxDate en la forma de un valor DateTime. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Value As DateTime [C#] public DateTime Value {get;} [C++] public: __property DateTime get_Value(); [JScript] public function get Value() : DateTime;
Valor de la propiedad DateTime que representa la instancia de IfxDate. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDate en la pgina 3-820 Representa el tipo de datos DATE de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Estructura IfxDecimal
Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-830
Sintaxis
Visual Public [C#] public [C++] public Basic] Structure IfxDecimal struct IfxDecimal value class IfxDecimal
Ejemplo
[C#] El ejemplo siguiente demuestra cmo recuperar un solo valor de columna DECIMAL de una tabla.
[C#] public static string getParam(IfxConnection conn) { string mySelectQuery = "SELECT * FROM EMPLOYEE"; IfxCommand myCommand = new IfxCommand(mySelectQuery, conn); IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxDecimal selectValue = reader.GetIfxDecimal(11); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxDecimal Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es 29 dgitos, y el tipo de datos string si la precisin mxima es 31 dgitos. Las tablas siguientes listan los miembros expuestos por la estructura IfxDecimal. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxDecimal
Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es 29 dgitos, y el tipo de datos string si la precisin mxima es 31 dgitos. Las tablas siguientes listan los miembros expuestos por la estructura IfxDecimal.
Campos pblicos
Precisin mxima de IfxDecimal: 31. MaxPrecision
3-831
Escala mxima de IfxDecimal: 31. MaxScale MaxValue Null MinValue Valor mnimo de IfxDecimal: -9.999999999999999999999999999999E+30. Valor mximo de IfxDecimal: 9.999999999999999999999999999999E+30. Valor de Null para IfxDecimal.
IfxDecimal(decimal) Inicializa una estructura IfxDecimal nueva con el valor decimal especificado.
Propiedades pblicas
IsNull Obtiene un valor que indica si el valor almacenado en la estructura IfxDecimal es nulo. Obtiene un valor que indica la precisin del valor de la estructura IfxDecimal. Obtiene un valor que indica la escala del valor de la estructura IfxDecimal. Obtiene el valor almacenado en la estructura IfxDecimal. Obtiene el valor aproximado almacenado en la estructura IfxDecimal.
Precision Scale Value ValueApproximate
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres proporcionada en IfxDecimal. Devuelve una serie de caracteres que representa la estructura IfxDecimal. Convierte la estructura IfxDecimal proporcionada en un decimal. Convierte el decimal proporcionado en IfxDecimal.
Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-832
Campos de IfxDecimal
Los campos de la estructura IfxDecimal se listan a continuacin.
Campos pblicos
Precisin mxima de IfxDecimal: 31. MaxPrecision Escala mxima de IfxDecimal: 31. MaxScale MaxValue Null MinValue Valor mnimo de IfxDecimal: -9.999999999999999999999999999999E+30. Valor mximo de IfxDecimal: 9.999999999999999999999999999999E+30. Valor de Null para IfxDecimal.
Consulta Miembros de IfxDecimal en la pgina 3-831 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es 29 dgitos, y el tipo de datos string si la precisin mxima es 31 dgitos. Las tablas siguientes listan los miembros expuestos por la estructura IfxDecimal. Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxDecimal.MaxPrecision: Precisin mxima de IfxDecimal: 31. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MaxPrecision As int [C#] public static readonly int MaxPrecision [C++] public: static initonly int MaxPrecision [JScript] public static final var MaxPrecision () : int
Comentarios El valor de esta constante es 31.
3-833
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxDecimal.MaxScale: Escala mxima de IfxDecimal: 31. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MaxScale As int [C#] public static readonly int MaxScale [C++] public: static initonly int MaxScale [JScript] public static final var MaxScale () : int
Comentarios El valor de esta constante es 31. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxDecimal.MaxValue: Valor mximo de IfxDecimal: 9.999999999999999999999999999999E+30. Espacio de nombres: IBM.Data.InformixTypes
3-834

Visual Basic] Public Shared ReadOnly MaxValue As IfxDecimal [C#] public static readonly IfxDecimal MaxValue [C++] public: static initonly IfxDecimal MaxValue [JScript] public static final var MaxValue () : IfxDecimal
Comentarios El valor de esta constante es 9.999999999999999999999999999999E+30, con 31 cifras significativas. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxDecimal.MinValue: Valor mnimo de IfxDecimal: -9.999999999999999999999999999999E+30. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MinValue As IfxDecimal [C#] public static readonly IfxDecimal MinValue [C++] public: static initonly IfxDecimal MinValue [JScript] public static final var MinValue () : IfxDecimal
Comentarios El valor de esta constante es -9.999999999999999999999999999999E+30, con 31 cifras significativas.
3-835
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxDecimal.Null: Valor de Null para IfxDecimal. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxDecimal [C#] public static readonly IfxDecimal Null [C++] public: static initonly IfxDecimal Null [JScript] public static final var Null () : IfxDecimal
Comentarios El valor de esta constante es NULL. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Constructor de IfxDecimal.IfxDecimal(decimal)
Inicializa una estructura IfxDecimal nueva con el valor decimal especificado. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-836
Sintaxis
Visual Basic] Public Sub New(value as Decimal) [C#] public IfxDecimal(decimal value); [C++] public: IfxDecimal(Decimal value); [JScript] public function IfxDecimal(value : decimal);
Parmetros
value Valor decimal para llenar la instancia de IfxDecimal.
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxDecimal
Los mtodos de la estructura IfxDecimal se listan a continuacin.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres proporcionada en IfxDecimal. Devuelve una serie de caracteres que representa la estructura IfxDecimal. Convierte la estructura IfxDecimal proporcionada en un decimal. Convierte el decimal proporcionado en IfxDecimal.
Consulta Miembros de IfxDecimal en la pgina 3-831 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es 29 dgitos, y el tipo de datos string si la precisin mxima es 31 dgitos. Las tablas siguientes listan los miembros expuestos por la estructura IfxDecimal. Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-837
Mtodo IfxDecimal.op_explicit: Convierte la estructura IfxDecimal en un double. Este mtodo emitir una OverflowException si la precisin del valor DB2Decimal es mayor de lo que puede contener un tipo decimal de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Narrowing Operator CType (source As IfxDecimal) As Decimal [C#] public static explicit operator decimal (IfxDecimal source) [C++] public: static explicit operator Decimal (IfxDecimal source)
Parmetros source Estructura IfxDecimal que se convertir en un decimal. Valor de retorno Valor decimal que se convertir a partir de una instancia de IfxDecimal. Excepciones
Tipo de excepcin IfxNullValueException IfxTruncateException OverflowException Condicin El valor IfxDecimal.Null no se puede asignar a un decimal. Las cifras significativas se pierden al asignar el valor IfxDecimal a un decimal. El valor que se est asignado a un decimal es demasiado grande.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxDecimal.op_implicit: Convierte el decimal proporcionado en IfxDecimal.
3-838

Visual Basic] Public Shared Widening Operator CType (origen As Decimal) As IfxDecimal [C#] public static implicit operator IfxDecimal (decimal origen) [C++] public: static implicit operator IfxDecimal (Decimal origen)
Parmetros source Valor decimal que se convertir a IfxDecimal. Valor de retorno Estructura IfxDecimal con el valor de origen. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxDecimal.Parse: Convierte la Serie de caracteres proporcionada en IfxDecimal. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Function Parse (szDecimal As String) As IfxDecimal [C#] public static IfxDecimal Parse (string szDecimal) [C++] public: static IfxDecimal Parse (string szDecimal) [JScript] public static function Parse (szDecimal String ) : IfxDecimal
3-839
Parmetros szDecimal Valor de Serie de caracteres que se convertir en IfxDecimal. Valor de retorno Estructura IfxDecimal con el valor numrico de szDecimal. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxDecimal.ToString: Devuelve una serie de caracteres que representa la estructura IfxDecimal. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Serie que representa el valor de la estructura IfxDecimal. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-840
Propiedades de IfxDecimal
Las propiedades de la estructura IfxDecimal se listan a continuacin.
Propiedades pblicas
IsNull Obtiene un valor que indica si el valor almacenado en la estructura IfxDecimal es nulo. Obtiene un valor que indica la precisin del valor de la estructura IfxDecimal. Obtiene un valor que indica la escala del valor de la estructura IfxDecimal. Obtiene el valor almacenado en la estructura IfxDecimal. Obtiene el valor aproximado almacenado en la estructura IfxDecimal.
Precision Scale Value ValueApproximate
Consulta Miembros de IfxDecimal en la pgina 3-831 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es 29 dgitos, y el tipo de datos string si la precisin mxima es 31 dgitos. Las tablas siguientes listan los miembros expuestos por la estructura IfxDecimal. Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxDecimal.IsNull: Obtiene un valor que indica si el valor almacenado en la estructura IfxDecimal es nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de la propiedad true si Value es nulo; de lo contrario, false.

3-841
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxDecimal.Precision: Obtiene un valor que indica la precisin del valor de la estructura IfxDecimal. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Precision As Integer [C#] public int Precision {get;} [C++] public: __property int get_Precision(); [JScript] public function get Precision() : int;
Valor de la propiedad Entero que representa la precisin de la estructura IfxDecimal. Ms especficamente, esta propiedad indica el nmero de figuras significativas del valor IfxDecimal. Comentarios Se emite una excepcin si la instancia de IfxDecimal tiene el valor IfxDecimal.Null. Excepciones
Tipo de excepcin IfxNullValueException Condicin El valor de IfxType es nulo.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos.
3-842
Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxDecimal.Scale: Obtiene un valor que indica la escala del valor de la estructura IfxDecimal. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Property Scale As Integer [C#] public int Scale {get;} [C++] public: __property int get_Scale(); [JScript] public function get Scale() : int;
Valor de la propiedad Entero que representa la escala de la estructura IfxDecimal. Comentarios Se emite una excepcin si la instancia de IfxDecimal tiene el valor IfxDecimal.Null. Excepciones
Tipo de excepcin IfxNullValueException Condicin El valor de IfxType es nulo.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxDecimal.ValueApproximate: Obtiene el valor aproximado almacenado en la estructura IfxDecimal. No emite una excepcin si se pierden dgitos menos significativos. Espacio de nombres: IBM.Data.InformixTypes
3-843

Visual Basic] Public ReadOnly Property ValueApproximate As Decimal [C#] public decimal ValueApproximate {get;} [C++] public: __property Decimal get_ValueApproximate(); [JScript] public function get ValueApproximate() : decimal;
Valor de la propiedad Decimal que representa el valor aproximado de la instancia de IfxDecimal. Excepciones
Tipo de excepcin IfxNullValueException OverflowException Condicin El valor IfxDecimal.Null no se puede asignar a un decimal. El valor que se est asignado a un decimal es demasiado grande.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxDecimal.Value: Obtiene el valor almacenado en la estructura IfxDecimal. Este mtodo emitir una OverflowException si la precisin del valor DB2Decimal es mayor de lo que puede contener un tipo decimal de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Value As Decimal [C#] public decimal Value {get;}
3-844
[C++] public: __property Decimal get_Value(); [JScript] public function get Value() : decimal;
Excepciones
Tipo de excepcin IfxNullValueException IfxTruncateException OverflowException Condicin El valor IfxDecimal.Null no se puede asignar a un decimal. Las cifras significativas se pierden al asignar el valor IfxDecimal a un decimal. El valor que se est asignado a un decimal es demasiado grande.
Valor de la propiedad Decimal que representa la instancia de IfxDecimal. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDecimal en la pgina 3-830 Representa el tipo de datos DECIMAL de DB2. Encapsula el tipo de datos decimal de .NET si la precisin mxima es de 29 dgitos y el tipo de datos string si la precisin mxima es de 31 dgitos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Estructura IfxDouble
Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Public [C#] public [C++] public Basic] Structure IfxDouble struct IfxDouble value class IfxDouble
Ejemplo
[C#] El ejemplo siguiente demuestra cmo recuperar un nico valor de columna FLOAT de una tabla.
3-845
[C#] public static string getParam(IfxConnection conn) { string mySelectQuery = "SELECT DOUBLECOL FROM TESTTBL"; IfxCommand myCommand = new IfxCommand(mySelectQuery, conn); IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxDouble selectValue = reader.GetIfxDouble(0); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxDouble Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxDouble. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxDouble
Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxDouble.
Campos pblicos
MaxValue MinValue Null Valor de Zero para IfxDouble. Zero Valor mximo de IfxDouble: 1.79769313486232e308. Valor mnimo de IfxDouble: -1.79769313486232e308. Valor de Null para IfxDouble.
IfxDouble Inicializa una estructura IfxDouble nueva con el valor especificado.
3-846
Propiedades pblicas
IsNull Obtiene un valor que indica si el valor almacenado en la estructura IfxDouble es nulo. Obtiene el valor almacenado en la estructura IfxDouble.
Value
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres proporcionada en IfxDouble. Devuelve una serie de caracteres que representa la estructura IfxDouble. Convierte la estructura IfxDouble en un doble. Convierte el doble proporcionado en IfxDouble.
Consulta Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Campos de IfxDouble
Los campos de la clase IfxDouble se listan a continuacin.
Campos pblicos
MaxValue MinValue Null Valor de Zero para IfxDouble. Zero Valor mximo de IfxDouble: 1.79769313486232e308. Valor mnimo de IfxDouble: -1.79769313486232e308. Valor de Null para IfxDouble.
Consulta Miembros de IfxDouble en la pgina 3-846 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxDouble. Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET.
3-847
Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxDouble.MaxValue: Valor mximo de IfxDouble: 1.79769313486232e308. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MaxValue As IfxDouble [C#] public static readonly IfxDouble MaxValue [C++] public: static initonly IfxDouble MaxValue [JScript] public static final var MaxValue () : IfxDouble
Comentarios El valor de esta constante es 1.79769313486232e308. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxDouble.MinValue: Valor mnimo de IfxDouble: -1.79769313486232e308. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MinValue As IfxDouble [C#] public static readonly IfxDouble MinValue [C++] public:
3-848
static initonly IfxDouble MinValue [JScript] public static final var MinValue () : IfxDouble
Comentarios El valor de esta constante es -1.79769313486232e308. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxDouble.Null: Valor de Null para IfxDouble. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxDouble [C#] public static readonly IfxDouble Null [C++] public: static initonly IfxDouble Null [JScript] public static final var Null () : IfxDouble
Comentarios El valor de esta constante es NULL. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxDouble.Zero:
3-849
Valor de Zero para IfxDouble. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Zero As IfxDouble [C#] public static readonly IfxDouble Zero [C++] public: static initonly IfxDouble Zero [JScript] public static final var Zero () : IfxDouble
Comentarios El valor de esta constante es 0. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Constructor de IfxDouble
Inicializa una estructura IfxDouble nueva con el valor especificado. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] Public Sub New(value as Double) [C#] public IfxDouble(double value); [C++] public: IfxDouble(double value); [JScript] public function IfxDouble(value : double);
Parmetros
value Un doble para llenar la instancia de IfxDouble.
3-850
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxDouble
Los mtodos de la clase IfxDouble se listan a continuacin.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres proporcionada en IfxDouble. Devuelve una serie de caracteres que representa la estructura IfxDouble. Convierte la estructura IfxDouble en un doble. Convierte el doble proporcionado en IfxDouble.
Consulta Miembros de IfxDouble en la pgina 3-846 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxDouble. Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxDouble.op_explicit: Convierte la estructura IfxDouble proporcionada en un valor doble. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Narrowing Operator CType (origen As IfxDouble) As Double [C#] public static implicit operator double (IfxDouble origen) [C++] public: static implicit operator double (IfxDouble origen)
3-851
Parmetros source Estructura IfxDouble que se convertir en un doble. Valor de retorno Valor doble convertido a partir de una instancia de IfxDouble. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxDouble.op_implicit: Convierte el valor doble proporcionado en IfxDouble. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Widening Operator CType (origen As Double) As IfxDouble [C#] public static implicit operator IfxDouble (double origen) [C++] public: static implicit operator IfxDouble (double origen)
Parmetros source Un valor doble que se convertir en IfxDouble. Valor de retorno Una estructura IfxDouble con el valor de origen. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-852
Mtodo IfxDouble.Parse: Convierte la Serie de caracteres proporcionada en IfxDouble. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Function Parse (szDouble As String) As IfxDouble [C#] public static IfxDouble Parse (string szDouble) [C++] public: static IfxDouble Parse (string szDouble) [JScript] public static function Parse (szDouble String ) : IfxDouble
Parmetros szDouble Valor de Serie de caracteres que se convertir en IfxDouble. Valor de retorno Estructura IfxDouble con el valor numrico de szDouble. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxDouble.ToString: Devuelve una serie de caracteres que representa el objeto IfxDouble. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function ToString As String [C#] public override string ToString () [C++] public:
3-853
virtual String^ ToString () override [JScript] public override function ToString () : String
Valor de retorno Serie de caracteres que representa el valor de la estructura IfxDouble. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Propiedades de IfxDouble
Las propiedades de la clase IfxDouble se listan a continuacin.
Propiedades pblicas
IsNull Obtiene un valor que indica si el valor almacenado en la estructura IfxDouble es nulo. Obtiene el valor almacenado en la estructura IfxDouble.
Value
Consulta Miembros de IfxDouble en la pgina 3-846 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxDouble. Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxDouble.IsNull: Obtiene un valor que indica si el valor almacenado en el objeto IfxDouble es nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property IsNull As Boolean [C#]
3-854
public bool IsNull {get;} [C++] public: __property bool get_IsNull(); [JScript] public final function get IsNull() : boolean
Valor de la propiedad true si Value es nulo; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxDouble.Value: Obtiene el valor almacenado almacenado en el objeto IfxDouble. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Value As Double [C#] public double Value {get;} [C++] public: __property double get_Value(); [JScript] public function get Value() : double;
Valor de la propiedad Un doble que representa la instancia de IfxDouble. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxDouble en la pgina 3-845 Representa los tipos de datos DOUBLE PRECISION y FLOAT de DB2. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-855
Estructura IfxInt16
Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Public [C#] public [C++] public Basic] Structure IfxInt16 struct IfxInt16 value class IfxInt16
Ejemplo
[C#] El ejemplo siguiente demuestra cmo recuperar un solo valor de columna SMALLINT de una tabla.
[C#] public static string getParam(IfxConnection conn) { string mySelectQuery = "SELECT * FROM EMPLOYEE"; IfxCommand myCommand = new IfxCommand(mySelectQuery, conn); IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxInt16 selectValue = reader.GetIfxInt16(8); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxInt16 en la pgina 3-857 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxInt16. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-856
Miembros de IfxInt16
Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxInt16.
Campos pblicos
MaxValue MinValue Null Representa el valor de Zero para IfxInt16. Zero Representa el valor mximo de IfxInt16: 32,767. Representa el valor mnimo de IfxInt16: -32,768. Representa el valor de Null para IfxInt16.
IfxInt16 Inicializa un nuevo objeto IfxInt16 con el valor especificado.
Propiedades pblicas
IsNull Value Obtiene un valor que indica si el valor almacenado en la estructura IfxInt16 es nulo. Obtiene el valor almacenado en la estructura IfxInt16.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte el valor de Serie de caracteres proporcionado en IfxInt16. Devuelve una serie de caracteres que representa la estructura IfxInt16. Convierte la estructura IfxInt16 proporcionada en un entero corto. Convierte el entero corto proporcionado en IfxInt16.
Consulta Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Campos de IfxInt16
Los campos de la estructura IfxInt16 se listan a continuacin.
3-857
Campos pblicos
MaxValue MinValue Null Representa el valor de Zero para IfxInt16. Zero Representa el valor mximo de IfxInt16: 32,767. Representa el valor mnimo de IfxInt16: -32,768. Representa el valor de Null para IfxInt16.
Consulta Miembros de IfxInt16 en la pgina 3-857 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxInt16. Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxInt16.MaxValue: Representa el valor mximo de IfxInt16: 32,767. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MaxValue As IfxInt16 [C#] public static readonly IfxInt16 MaxValue [C++] public: static initonly IfxInt16 MaxValue [JScript] public static final var MaxValue () : IfxInt16
Comentarios El valor de esta constante es 32,767. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET.
3-858
Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxInt16.MinValue: Representa el valor mnimo de IfxInt16: -32,768. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MinValue As IfxInt16 [C#] public static readonly IfxInt16 MinValue [C++] public: static initonly IfxInt16 MinValue [JScript] public static final var MinValue () : IfxInt16
Comentarios El valor de esta constante es -32,768. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxInt16.Null: Representa el valor de Null para IfxInt16. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxInt16 [C#] public static readonly IfxInt16 Null [C++] public:
3-859
static initonly IfxInt16 Null [JScript] public static final var Null () : IfxInt16
Comentarios El valor de esta constante es NULL. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxInt16.Zero: Representa el valor de Zero para IfxInt16. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Zero As IfxInt16 [C#] public static readonly IfxInt16 Zero [C++] public: static initonly IfxInt16 Zero [JScript] public static final var Zero () : IfxInt16
Comentarios El valor de esta constante es 0. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-860
Constructor de IfxInt16
Inicializa una estructura IfxInt16 nueva con el valor especificado. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] Public Sub New(value as Short) [C#] public IfxInt16(short value); [C++] public: IfxInt16(short value); [JScript] public function IfxInt16(value : short);
Parmetros
value Valor de entero corto para llenar la instancia de IfxInt16.
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxInt16
Los mtodos de la estructura IfxInt16 se listan a continuacin.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte el valor de Serie de caracteres proporcionado en IfxInt16. Devuelve una serie de caracteres que representa la estructura IfxInt16. Convierte la estructura IfxInt16 proporcionada en un entero corto. Convierte el entero corto proporcionado en IfxInt16.
Consulta Miembros de IfxInt16 en la pgina 3-857 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxInt16.
3-861
Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxInt16.op_explicit: Convierte la estructura IfxInt16 proporcionada en un entero corto. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Narrowing Operator CType (origen As IfxInt16) As Short [C#] public static implicit operator short (IfxInt16 origen) [C++] public: static implicit operator short (IfxInt16 origen)
Parmetros source Estructura IfxInt16 que se convertir en un entero corto. Valor de retorno Valor de entero corto convertido a partir de una instancia de IfxInt16. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxInt16.op_implicit: Convierte el entero corto proporcionado en IfxInt16. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-862
Sintaxis
Visual Basic] Public Shared Widening Operator CType (origen As Short) As IfxInt16 [C#] public static implicit operator IfxInt16 (short origen) [C++] public: static implicit operator IfxInt16 (short origen)
Parmetros source Valor de entero corto que se convertir en IfxInt16. Valor de retorno Estructura IfxInt16 con el valor de origen. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxInt16.Parse: Convierte el valor de Serie de caracteres proporcionado en IfxInt16. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Function Parse (szInt16 As String) As IfxInt16 [C#] public static IfxInt16 Parse (string szInt16) [C++] public: static IfxInt16 Parse (string szInt16) [JScript] public static function Parse (szInt16 String ) : IfxInt16
Parmetros szInt16 Valor de Serie de caracteres que se convertir en IfxInt16. Valor de retorno Estructura IfxInt16 con el valor numrico de szInt16.
3-863
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxInt16.ToString: Devuelve una serie de caracteres que representa la estructura IfxInt16. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Serie de caracteres que representa el valor de la estructura IfxInt16. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Propiedades de IfxInt16
Las propiedades de la estructura IfxInt16 se listan a continuacin.
Propiedades pblicas
IsNull Obtiene un valor que indica si el valor almacenado en la estructura IfxInt16 es nulo.
3-864
Value
Obtiene el valor almacenado en la estructura IfxInt16.
Consulta Miembros de IfxInt16 en la pgina 3-857 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxInt16. Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxInt16.IsNull: Obtiene un valor que indica si el valor almacenado en la estructura IfxInt16 es nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de la propiedad true si Value es nulo; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxInt16.Value: Obtiene el valor almacenado en la estructura IfxInt16.
3-865

Visual Basic] Public ReadOnly Property Value As Short [C#] public short Value {get;} [C++] public: __property short get_Value(); [JScript] public function get Value() : short;
Valor de la propiedad Entero corto que representa la instancia de IfxInt16. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Estructura IfxInt32
Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Ejemplo
[C#] El ejemplo siguiente demuestra cmo recuperar un solo valor de columna INT de una tabla.
[C#] public static string getParam(IfxConnection conn) { string mySelectQuery = "SELECT * FROM SALES"; IfxCommand myCommand = new IfxCommand(mySelectQuery, conn);
3-866
IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxInt32 selectValue = reader.GetIfxInt32(3); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxInt32 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxInt32. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxInt32.
Campos pblicos
MaxValue MinValue Null Representa el valor de Zero para IfxInt32. Zero Representa el valor mximo de IfxInt32: 2,147,483,647. Representa el valor mnimo de IfxInt32: -2,147,483,648. Representa el valor nulo para IfxInt32.
IfxInt32 Inicializa una estructura IfxInt32 nueva con el valor especificado.
Propiedades pblicas
IsNull Obtiene un valor que indica si el valor almacenado en la estructura IfxInt32 es nulo.
3-867
Value
Obtiene el valor almacenado en la estructura IfxInt32.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres proporcionada en IfxInt32. Devuelve una serie de caracteres que representa la estructura IfxInt32. Convierte la estructura IfxInt32 proporcionada en un entero. Convierte el entero proporcionado en IfxInt32.
Consulta Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Campos de IfxInt32
Los campos de la estructura IfxInt32 se listan a continuacin.
Campos pblicos
MaxValue MinValue Null Representa el valor de Zero para IfxInt32. Zero Representa el valor mximo de IfxInt32: 2,147,483,647. Representa el valor mnimo de IfxInt32: -2,147,483,648. Representa el valor nulo para IfxInt32.
Consulta Miembros de IfxInt32 en la pgina 3-867 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxInt32. Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxInt32.MaxValue: Representa el valor mximo de IfxInt32: 2,147,483,647.
3-868

Comentarios El valor de esta constante es 2,147,483,647. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxInt32.MinValue: Representa el valor mnimo de IfxInt32: -2,147,483,648. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Comentarios El valor de esta constante es -2,147,483,648.
3-869
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxInt32.Null: Representa el valor nulo para IfxInt32. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxInt32 [C#] public static readonly IfxInt32 Null [C++] public: static initonly IfxInt32 Null [JScript] public static final var Null () : IfxInt32
Comentarios El valor de esta constante es NULL. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxInt32.Zero: Representa el valor de Zero para IfxInt32. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-870
Sintaxis
Comentarios El valor de esta constante es 0. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Inicializa una estructura IfxInt32 nueva con el valor especificado.
Sintaxis
Visual Basic] Public Sub New(value as Integer) [C#] public IfxInt32(int value); [C++] public: IfxInt32(int value); [JScript] public function IfxInt32(value : int);
Parmetros
value Valor de entero para llenar la instancia de IfxInt32.
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxInt32
Los mtodos de la estructura IfxInt32 se listan a continuacin.
3-871
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres proporcionada en IfxInt32. Devuelve una serie de caracteres que representa la estructura IfxInt32. Convierte la estructura IfxInt32 proporcionada en un entero. Convierte el entero proporcionado en IfxInt32.
Consulta Miembros de IfxInt32 en la pgina 3-867 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxInt32. Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxInt32.op_explicit: Convierte la estructura IfxInt32 proporcionada en un entero. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Narrowing Operator CType (origen As IfxInt32) As Integer [C#] public static implicit operator int (IfxInt32 origen) [C++] public: static implicit operator int (IfxInt32 origen)
Parmetros source Estructura IfxInt32 que se convertir en un entero. Valor de retorno Valor de entero convertido a partir de la instancia de IfxInt32. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta
3-872
Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxInt32.op_implicit: Convierte el entero proporcionado en IfxInt32. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Widening Operator CType (origen As Integer) As IfxInt32 [C#] public static implicit operator IfxInt32 (int origen) [C++] public: static implicit operator IfxInt32 (int origen)
Parmetros source Valor de entero que se convertir en IfxInt32. Valor de retorno Estructura de IfxInt32 con el valor de origen. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxInt32.Parse: Convierte la Serie de caracteres proporcionada en IfxInt32. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-873
Sintaxis
Parmetros szInt32 Valor de Serie de caracteres que se convertir en IfxInt32. Valor de retorno Estructura IfxInt32 con el valor numrico de szInt32. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxInt32.ToString: Devuelve una serie de caracteres que representa la estructura IfxInt32. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Serie de caracteres que representa el valor de la estructura IfxInt32.
3-874
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Las propiedades de la estructura IfxInt32 se listan a continuacin.
Propiedades pblicas
Consulta Miembros de IfxInt32 en la pgina 3-867 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Las tablas siguientes listan los miembros expuestos por la clase IfxInt32. Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxInt32.IsNull: Obtiene un valor que indica si el valor almacenado en la estructura IfxInt32 es nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de la propiedad true si Value es nulo; de lo contrario, false.

3-875
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxInt32.Value: Obtiene el valor almacenado en la estructura IfxInt32. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Value As Short [C#] public short Value {get;} [C++] public: __property short get_Value(); [JScript] public function get Value() : short;
Valor de la propiedad Entero corto que representa la instancia de IfxInt32. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt32 en la pgina 3-866 Representa el tipo de datos INTEGER de DB2. Encapsula el tipo de datos int de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Estructura IfxInt64
Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-876
Sintaxis
Ejemplo
[C#] El ejemplo siguiente demuestra cmo recuperar un solo valor de columna BIGINT de una tabla.
[C#] public static string getParam(IfxConnection conn) { string mySelectQuery = "SELECT * FROM CUSTOMER"; IfxCommand myCommand = new IfxCommand(mySelectQuery, conn); IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxInt64 selectValue = reader.GetIfxInt64(0); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxInt64 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Las tablas siguientes lista los miembros expuestos por la clase IfxInt64. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Las tablas siguientes lista los miembros expuestos por la clase IfxInt64.
Campos pblicos
Valor mximo de IfxInt64: 2^63-1. MaxValue Valor mnimo de IfxInt64: -2^63. MinValue
3-877
Valor de Null para IfxInt64. Null Valor de Zero para IfxInt64. Zero
IfxInt64 Inicializa una estructura IfxInt64 nueva con el valor especificado.
Propiedades pblicas
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres proporcionada en IfxInt64. Devuelve una serie de caracteres que representa la estructura IfxInt64. Convierte la estructura IfxInt64 proporcionada en un entero largo. Convierte el entero largo proporcionado en IfxInt64.
Consulta Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Campos de IfxInt64
Los campos de la clase IfxInt64 se listan a continuacin.
Campos pblicos
Valor mximo de IfxInt64: 2^63-1. MaxValue Valor mnimo de IfxInt64: -2^63. MinValue Valor de Null para IfxInt64. Null Valor de Zero para IfxInt64. Zero
3-878
Consulta Miembros de IfxInt64 en la pgina 3-877 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Las tablas siguientes lista los miembros expuestos por la clase IfxInt64. Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxInt64.MaxValue: Valor mximo de IfxInt64: 2^63-1. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Comentarios El valor de esta constante es 2^63-1. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxInt64.MinValue: Valor mnimo de IfxInt64: -2^63. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-879
Sintaxis
Comentarios El valor de esta constante es -2^63. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxInt64.Null: Valor de Null para IfxInt64. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxInt64 [C#] public static readonly IfxInt64 Null [C++] public: static initonly IfxInt64 Null [JScript] public static final var Null () : IfxInt64
Comentarios El valor de esta constante es NULL. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta
3-880
Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxInt64.Zero: Valor de Zero para IfxInt64. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Comentarios El valor de esta constante es 0. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Inicializa una estructura IfxInt64 nueva con el valor especificado. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] Public Sub New(value as Long) [C#] public IfxInt64(long value);
3-881
[C++] public: IfxInt64(long value); [JScript] public function IfxInt64(value : long);
Parmetros
value Valor de entero largo para llenar la instancia de IfxInt64.
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxInt64
Los mtodos de la clase IfxInt64 se listan a continuacin.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres proporcionada en IfxInt64. Devuelve una serie de caracteres que representa la estructura IfxInt64. Convierte la estructura IfxInt64 proporcionada en un entero largo. Convierte el entero largo proporcionado en IfxInt64.
Consulta Miembros de IfxInt64 en la pgina 3-877 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Las tablas siguientes lista los miembros expuestos por la clase IfxInt64. Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxInt64.op_explicit: Convierte la estructura IfxInt64 proporcionada en un entero largo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-882
Sintaxis
Visual Basic] Public Shared Narrowing Operator CType (origen As IfxInt64) As Long [C#] public static implicit operator long (IfxInt64 origen) [C++] public: static implicit operator long (IfxInt64 origen)
Parmetros source Estructura IfxInt64 que se convertir en un entero largo. Valor de retorno Valor de entero largo convertido a partir de la instancia de IfxInt64. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxInt64.op_implicit: Convierte el entero largo proporcionado en IfxInt64. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Widening Operator CType (origen As Long) As IfxInt64 [C#] public static implicit operator IfxInt64 (long origen) [C++] public: static implicit operator IfxInt64 (long origen)
Parmetros source Valor de entero largo que se convertir en IfxInt64. Valor de retorno Estructura de IfxInt64 con el valor de origen. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0
3-883
Consulta Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxInt64.Parse: Convierte la Serie de caracteres proporcionada en IfxInt64. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Parmetros szInt64 Valor de Serie de caracteres que se convertir en IfxInt64. Valor de retorno Estructura IfxInt64 con el valor numrico de szInt64. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxInt64.ToString: Devuelve una serie de caracteres que representa la estructura IfxInt64. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-884
Sintaxis
Valor de retorno Serie de caracteres que representa el valor de la estructura IfxInt64. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Las propiedades de la clase IfxInt64 se listan a continuacin.
Propiedades pblicas
Consulta Miembros de IfxInt64 en la pgina 3-877 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Las tablas siguientes lista los miembros expuestos por la clase IfxInt64. Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxInt64.IsNull: Obtiene un valor que indica si el valor almacenado en la estructura IfxInt64 es nulo. Espacio de nombres: IBM.Data.InformixTypes
3-885

Valor de la propiedad true si Value es nulo; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxInt64.Value: Obtiene el valor almacenado en la estructura IfxInt64. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Value As Long [C#] public long Value {get;} [C++] public: __property long get_Value(); [JScript] public function get Value() : long;
Valor de la propiedad Entero largo que representa la instancia de IfxInt64. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta
3-886
Estructura IfxInt64 en la pgina 3-876 Representa el tipo de datos BIGINT de DB2. Encapsula el tipo de datos long de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Clase IfxNullValueException
Excepcin que se genera cuando el mtodo Value para el objeto de clases IBM.Data.IfxTypes aplicable se llama con un valor nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.Exception System.SystemException IBM.Data.Informix.IfxTypeException IBM.Data.Informix.IfxNullValueException
Sintaxis
Visual Basic] Public Class IfxNullValueException [C#] public class IfxNullValueException [C++] public __gc class IfxNullValueException [JScript] public class IfxNullValueException
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxNullValueException en la pgina 3-888 Excepcin que se genera cuando el mtodo Value para la estructura o clase IBM.Data.IfxTypes aplicable se llama con un valor nulo. Las tablas siguientes listan los miembros expuestos por la clase IfxNullValueException. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-887
Miembros de IfxNullValueException
Excepcin que se genera cuando el mtodo Value para la estructura o clase IBM.Data.IfxTypes aplicable se llama con un valor nulo. Las tablas siguientes listan los miembros expuestos por la clase IfxNullValueException.
Propiedades pblicas
HelpLink (heredada de Exception) InnerException (heredada de Exception) Message (heredada de Exception Source (heredada de Exception StackTrace (heredada de Exception) Obtiene el nombre de la aplicacin o del objeto que ha generado el error. Obtiene una representacin de series de las tramas en la pila de llamada en el momento en que se ha emitido la excepcin actual. Obtiene el mtodo que emite la excepcin actual. Obtiene o establece un enlace con el archivo de ayuda asociado con esta excepcin. Obtiene la instancia de Exception que ha causado la excepcin actual. Obtiene el texto que describe el error.
Mtodos pblicos
GetObjectData (heredado de Object)
3-888
Mtodos protegidos
Consulta Clase IfxNullValueException en la pgina 3-887 Excepcin que se genera cuando el mtodo Value para el objeto de clases IBM.Data.IfxTypes aplicable se llama con un valor nulo. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Clase IfxFormatException
Excepcin que se genera cuando el mtodo Parse para la clase IBM.Data.IfxTypes aplicable incluye una serie de caracteres con valores no numricos. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.Exception System.SystemException IBM.Data.Informix.IfxTypeException IBM.Data.Informix.IfxFormatException
Sintaxis
Visual Basic] Public Class IfxFormatException [C#] public class IfxFormatException [C++] public __gc class IfxFormatException [JScript] public class IfxFormatException
Seguridad de hebra
3-889
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxFormatException Excepcin que se genera cuando el mtodo Parse para la clase o estructura IBM.Data.IfxTypes incluye una serie de caracteres con valores no numricos. Las tablas siguientes listan los miembros expuestos por la clase IfxFormatException. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxFormatException
Excepcin que se genera cuando el mtodo Parse para la clase o estructura IBM.Data.IfxTypes incluye una serie de caracteres con valores no numricos. Las tablas siguientes listan los miembros expuestos por la clase IfxFormatException.
Propiedades pblicas
Mtodos pblicos
Equals (heredado de Object) GetBaseException (heredado de Exception) Sobrecargado. Determina si dos instancias de Object son iguales. Cuando est alterado temporalmente en una clase derivada, devuelve la Exception que es la causa inicial de una o ms excepciones subsiguientes. Funciona como una funcin de hash para un tipo determinado, apto para la utilizacin en algoritmos de hash y en estructuras de datos como una tabla hash. Alterado temporalmente. Consulte Exception.GetObjectData. Obtiene el Type de la instancia actual. GetType (heredado de Object)
3-890
ToString (heredado de Exception)
Alterado temporalmente. Crea y devuelve una representacin de series de la excepcin actual.
Mtodos protegidos
Consulta Clase IfxFormatException en la pgina 3-889 Excepcin que se genera cuando el mtodo Parse para la clase IBM.Data.IfxTypes aplicable incluye una serie de caracteres con valores no numricos. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Estructura IfxReal370
Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Public [C#] public [C++] public Basic] Structure IfxReal370 struct IfxReal370 value class IfxReal370
Comentarios
La clase IfxReal370 solo est soportada para aplicaciones con conexiones a DB2 para bases de datos de z/OS.
3-891
Ejemplo
[C#] El ejemplo siguiente demuestra cmo recuperar un solo valor de columna REAL de una tabla de DB2 para z/OS.
[C#] public static string getParam(IfxConnection conn) { string mySelectQuery = "SELECT REAL370COL FROM TESTTBL"; IfxCommand myCommand = new IfxCommand(mySelectQuery, conn); IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxReal370 selectValue = reader.GetIfxReal370(0); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxReal370 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxReal370. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxReal370
Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxReal370.
Campos pblicos
Valor mximo para IfxReal370: 7.2e75. MaxValue Valor mnimo de IfxReal370: -7.2e75. MinValue Valor de Null para IfxReal370. Null Valor de Zero para IfxReal370. Zero
3-892
IfxReal370 Inicializa una nueva estructura IfxReal370 con el valor especificado.
Propiedades pblicas
IsNull Value Obtiene un valor que indica si el valor almacenado en el objeto IfxReal370 es nulo. Obtiene el valor almacenado en la estructura IfxReal370.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres proporcionada en IfxReal370. Devuelve una serie de caracteres que representa la estructura IfxReal370. Convierte la estructura IfxReal370 proporcionada en un doble. Convierte el valor doble proporcionado en IfxReal370.
Consulta Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Campos de IfxReal370
Los campos de la estructura IfxReal370 se listan a continuacin.
Campos pblicos
Valor mximo para IfxReal370: 7.2e75. MaxValue Valor mnimo de IfxReal370: -7.2e75. MinValue Valor de Null para IfxReal370. Null Valor de Zero para IfxReal370. Zero
Consulta Miembros de IfxReal370 en la pgina 3-892 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est
3-893
representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxReal370. Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxReal370.MaxValue: Valor mximo para IfxReal370: 7.2e75. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MaxValue As IfxReal370 [C#] public static readonly IfxReal370 MaxValue [C++] public: static initonly IfxReal370 MaxValue [JScript] public static final var MaxValue () : IfxReal370
Comentarios El valor de esta constante es 7.2e75. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxReal370.MinValue: Valor mnimo de IfxReal370: -7.2e75. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-894
Sintaxis
Visual Basic] Public Shared ReadOnly MinValue As IfxReal370 [C#] public static readonly IfxReal370 MinValue [C++] public: static initonly IfxReal370 MinValue [JScript] public static final var MinValue () : IfxReal370
Comentarios El valor de esta constante es -7.2e75. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxReal370.Null: Valor de Null para IfxReal370. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxReal370 [C#] public static readonly IfxReal370 Null [C++] public: static initonly IfxReal370 Null [JScript] public static final var Null () : IfxReal370
Comentarios El valor de esta constante es NULL. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta
3-895
Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxReal370.Zero: Valor de Zero para IfxReal370. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Zero As IfxReal370 [C#] public static readonly IfxReal370 Zero [C++] public: static initonly IfxReal370 Zero [JScript] public static final var Zero () : IfxReal370
Comentarios El valor de esta constante es 0. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Constructor de IfxReal370
Inicializa un objeto IfxReal370 nuevo con el valor especificado. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] Public Sub New(value as Double) [C#]
3-896
public IfxReal370(double value); [C++] public: IfxReal370(double value); [JScript] public function IfxReal370(value : double);
Parmetros
value Un valor doble para llenar la instancia de IfxReal370.
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxReal370
Los mtodos de la estructura IfxReal370 se listan a continuacin.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres proporcionada en IfxReal370. Devuelve una serie de caracteres que representa la estructura IfxReal370. Convierte la estructura IfxReal370 proporcionada en un doble. Convierte el valor doble proporcionado en IfxReal370.
Consulta Miembros de IfxReal370 en la pgina 3-892 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxReal370. Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxReal370.op_explicit: Convierte la estructura IfxReal370 proporcionada en un doble.
3-897

Visual Basic] Public Shared Narrowing Operator CType (origen As IfxReal370) As Double [C#] public static implicit operator double (IfxReal370 origen) [C++] public: static implicit operator double (IfxReal370 origen)
Parmetros source Estructura IfxReal370 que se convertir en un doble. Valor de retorno Valor doble convertido a partir de una instancia de IfxReal370. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxReal370.op_implicit: Convierte el valor doble proporcionado en IfxReal370. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Widening Operator CType (origen As Float) As IfxReal370 [C#] public static implicit operator IfxReal370 (float origen) [C++] public: static implicit operator IfxReal370 (float origen)
Parmetros source Un valor doble que se convertir en IfxReal370.
3-898
Valor de retorno Estructura IfxReal370 con el valor de origen. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxReal370.Parse: Convierte la Serie de caracteres proporcionada en IfxReal370. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Function Parse (szReal370 As String) As IfxReal370 [C#] public static IfxReal370 Parse (string szReal370) [C++] public: static IfxReal370 Parse (string szReal370) [JScript] public static function Parse (szReal370 String ) : IfxReal370
Parmetros szReal370 Valor de Serie de caracteres que se convertir en IfxReal370. Valor de retorno Estructura IfxReal370 con el valor numrico de szReal370. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET.
3-899
Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxReal370.ToString: Devuelve una serie de caracteres que representa el objeto IfxReal370. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Serie de caracteres que representa el valor de la estructura IfxReal370. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Propiedades de IfxReal370
Las propiedades de la clase IfxReal370 se listan a continuacin.
Propiedades pblicas
IsNull Value Obtiene un valor que indica si el valor almacenado en el objeto IfxReal370 es nulo. Obtiene el valor almacenado en la estructura IfxReal370.
Consulta Miembros de IfxReal370 en la pgina 3-892 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est
3-900
representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxReal370. Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxReal370.IsNull: Obtiene un valor que indica si el valor almacenado en el objeto IfxReal370 es nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de la propiedad true si Value es nulo; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxReal370.Value: Obtiene el valor almacenado en la estructura IfxReal370. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-901
Sintaxis
Visual Basic] Public ReadOnly Property Value As Double [C#] public double Value {get;} [C++] public: __property double get_Value(); [JScript] public function get Value() : double;
Valor de la propiedad Un doble que representa la instancia de IfxReal370. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal370 en la pgina 3-891 Representa el tipo de base de datos de DB2 para OS/390 REAL, que est representado en una notacin IBM 370. Encapsula el tipo de datos double de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Estructura IfxReal
Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Public [C#] public [C++] public Basic] Structure IfxReal struct IfxReal value class IfxReal
Comentarios
La clase IfxReal solo est soportada para aplicaciones con conexiones a DB2 para bases de datos Linux, UNIX o Windows.
Ejemplo
[C#] El ejemplo siguiente demuestra cmo recuperar una solo valor de columna REAL de una tabla.
[C#] public static string getParam(IfxConnection conn) { string mySelectQuery = "SELECT REALCOL FROM TESTTBL";
3-902
IfxCommand myCommand = new IfxCommand(mySelectQuery, conn); IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxReal selectValue = reader.GetIfxReal(0); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxReal Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxReal. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxReal
Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxReal.
Campos pblicos
Valor mximo de IfxReal: 3,402823e38. MaxValue Valor mnimo de IfxReal: -3,402823e38. MinValue Valor de Null para IfxReal. Null Valor de Zero para IfxReal. Zero
IfxReal Inicializa una nueva estructura IfxReal con el valor especificado.
3-903
Propiedades pblicas
IsNull Value Obtiene un valor que indica si el valor almacenado en la estructura IfxReal es nulo. Obtiene el valor almacenado en la estructura IfxReal.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte el valor String proporcionado en IfxReal. Devuelve una serie de caracteres que representa la estructura IfxReal. Convierte la estructura IfxReal proporcionada en un valor flotante. Convierte el valor flotante proporcionado en IfxReal.
Consulta Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Campos de IfxReal
Los campos de la clase IfxReal se listan a continuacin.
Campos pblicos
Valor mximo de IfxReal: 3,402823e38. MaxValue Valor mnimo de IfxReal: -3,402823e38. MinValue Valor de Null para IfxReal. Null Valor de Zero para IfxReal. Zero
Consulta Miembros de IfxReal en la pgina 3-903 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxReal. Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET.
3-904
Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxReal.MaxValue: Valor mximo de IfxReal: 3,402823e38. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MaxValue As IfxReal [C#] public static readonly IfxReal MaxValue [C++] public: static initonly IfxReal MaxValue [JScript] public static final var MaxValue () : IfxReal
Comentarios El valor de esta constante es 3,402823e38. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxReal.MinValue: Valor mnimo de IfxReal: -3,402823e38. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MinValue As IfxReal [C#] public static readonly IfxReal MinValue [C++] public:
3-905
static initonly IfxReal MinValue [JScript] public static final var MinValue () : IfxReal
Comentarios El valor de esta constante es -3,402823e38. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxReal.Null: Valor de Null para IfxReal. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxReal [C#] public static readonly IfxReal Null [C++] public: static initonly IfxReal Null [JScript] public static final var Null () : IfxReal
Comentarios El valor de esta constante es NULL. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxReal.Zero:
3-906
Valor de Zero para IfxReal. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Zero As IfxReal [C#] public static readonly IfxReal Zero [C++] public: static initonly IfxReal Zero [JScript] public static final var Zero () : IfxReal
Comentarios El valor de esta constante es 0. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Constructor de IfxReal
Inicializa un objeto IfxReal nuevo con el valor especificado. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] Public Sub New(value as Float) [C#] public IfxReal(float value); [C++] public: IfxReal(float value); [JScript] public function IfxReal(value : float);
Parmetros
value Un valor flotante para llenar la instancia de IfxReal.
3-907
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxReal
Los mtodos de la estructura IfxReal se listan a continuacin.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte el valor String proporcionado en IfxReal. Devuelve una serie de caracteres que representa la estructura IfxReal. Convierte la estructura IfxReal proporcionada en un valor flotante. Convierte el valor flotante proporcionado en IfxReal.
Consulta Miembros de IfxReal en la pgina 3-903 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxReal. Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxReal.op_explicit: Convierte la estructura IfxReal proporcionada en un valor flotante. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Narrowing Operator CType (origen As IfxReal) As Float [C#] public static implicit operator float (IfxReal origen) [C++] public: static implicit operator float (IfxReal origen)
3-908
Parmetros source Estructura IfxReal que se convertir en un valor flotante. Valor de retorno Un valor flotante convertido a partir de la instancia de IfxReal. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxReal.op_implicit: Convierte el valor flotante proporcionado en IfxReal. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Widening Operator CType (origen As Float) As IfxReal [C#] public static implicit operator IfxReal (float origen) [C++] public: static implicit operator IfxReal (float origen)
Parmetros source Un valor flotante que se convertir en IfxReal. Valor de retorno Estructura IfxReal con el valor de origen. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-909
Mtodo IfxReal.Parse: Convierte el valor String proporcionado en IfxReal. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Function Parse (szReal As String) As IfxReal [C#] public static IfxReal Parse (string szReal) [C++] public: static IfxReal Parse (string szReal) [JScript] public static function Parse (szReal String ) : IfxReal
Parmetros szReal Un valor de String que se convertir en IfxReal. Valor de retorno Estructura IfxReal con el valor numrico de szReal. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxReal.ToString: Devuelve una serie de caracteres que representa la estructura IfxReal. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-910
Valor de retorno Serie de caracteres que representa el valor de la estructura IfxReal. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Propiedades de IfxReal
Las propiedades de la estructura IfxReal se listan a continuacin.
Propiedades pblicas
IsNull Value Obtiene un valor que indica si el valor almacenado en la estructura IfxReal es nulo. Obtiene el valor almacenado en la estructura IfxReal.
Consulta Miembros de IfxReal en la pgina 3-903 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxReal. Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxReal.IsNull: Obtiene un valor que indica si el valor almacenado en la estructura IfxReal es nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
3-911
Valor de la propiedad true si Value es nulo; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxReal.Value: Obtiene el valor almacenado en el objeto IfxReal. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Value As Float [C#] public float Value {get;} [C++] public: __property float get_Value(); [JScript] public function get Value() : float;
Valor de la propiedad Un valor flotante que representa la instancia de IfxReal. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-912
Estructura IfxRowId
Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Public [C#] public [C++] public Basic] Structure IfxRowId struct IfxRowId value class IfxRowId
Comentarios
La clase IfxRowId solo est soportada para aplicaciones con conexiones a DB2 para bases de datos de z/OS o a DB2 para bases de datos de i5/OS. Solo se pueden crear instancias de estructuras IfxRowId leyendo las columnas ROWID de una base de datos (utilizando el mtodo GetIfxRowId de las clases IfxDataReader, IfxResultSet, IfxRecord o IfxUpdatableRecord).
Ejemplo
[C#] El ejemplo siguiente demuestra cmo utilizar la estructura IfxRowId.
[C#] public static string getParam(IfxConnection conn, IfxRowId rowid) { string mySelectQuery = "SELECT EMPNO FROM EMPLOYEE WHERE EMP_ROWID=ROWID(?)"; IfxCommand myCommand = new IfxCommand(mySelectQuery, conn); IfxParameter p1 = new IfxParameter(); p1.Value = rowid; myCommand.Parameters.Add(p1); IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxString selectValue = reader.GetIfxString(0); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0
3-913
Consulta Miembros de IfxRowId Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxRowId. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxRowId
Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxRowId.
Campos pblicos
Valor de Null para IfxRowId. Null
Propiedades pblicas
IsNull Obtiene un valor que indica si el valor almacenado en la estructura IfxRowId es nulo. Obtiene el valor almacenado en la estructura IfxRowId.
Value
Mtodos pblicos
op_explicit ToString Convierte la estructura IfxRowId proporcionada en una matriz de bytes. Devuelve una serie de caracteres que representa la estructura IfxRowId.
Consulta Estructura IfxRowId en la pgina 3-913 Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Campos de IfxRowId
Los campos de la clase IfxRowId se listan a continuacin.
Campos pblicos
Valor de Null para IfxRowId. Null
Consulta
3-914
Miembros de IfxRowId en la pgina 3-914 Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxRowId. Estructura IfxRowId en la pgina 3-913 Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxRowId.Null: Valor de Null para IfxRowId. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxRowId [C#] public static readonly IfxRowId Null [C++] public: static initonly IfxRowId Null [JScript] public static final var Null () : IfxRowId
Comentarios El valor de esta constante es NULL. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxRowId en la pgina 3-913 Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxRowId
Los mtodos de la estructura IfxRowId se listan a continuacin.
Mtodos pblicos
op_explicit ToString Convierte la estructura IfxRowId proporcionada en una matriz de bytes. Devuelve una serie de caracteres que representa la estructura IfxRowId.
3-915
Consulta Miembros de IfxRowId en la pgina 3-914 Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxRowId. Estructura IfxRowId en la pgina 3-913 Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxRowId.op_explicit: Convierte la estructura IfxRowId proporcionada en una matriz de bytes. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Narrowing Operator CType (origen As IfxRowId) As Byte() [C#] public static implicit operator byte[] (IfxRowId origen) [C++] public: static implicit operator array<unsigned char> (IfxRowId origen)
Parmetros source Estructura IfxRowId que se convertir en una matriz de bytes. Valor de retorno Matriz de bytes que se convertir a partir de una instancia de IfxRowId. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxRowId en la pgina 3-913 Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxRowId.ToString: Devuelve una serie de caracteres que representa la estructura IfxRowId. Espacio de nombres: IBM.Data.InformixTypes
3-916

Valor de retorno Serie de caracteres que representa el valor de la estructura IfxRowId. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxRowId en la pgina 3-913 Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Propiedades de IfxRowId
Las propiedades de la clase IfxRowId se listan a continuacin.
Propiedades pblicas
IsNull Obtiene un valor que indica si el valor almacenado en la estructura IfxRowId es nulo. Obtiene el valor almacenado en la estructura IfxRowId.
Value
Consulta Miembros de IfxRowId en la pgina 3-914 Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxRowId. Estructura IfxRowId en la pgina 3-913 Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxRowId.IsNull:
3-917
Obtiene un valor que indica si el valor almacenado en la estructura IfxRowId es nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de la propiedad true si Value es nulo; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxRowId en la pgina 3-913 Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxRowId.Value: Obtiene el valor almacenado en el objeto IfxRowId. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Value As Byte() [C#] public byte[] Value {get;} [C++] public: __property array<unsigned char> get_Value(); [JScript] public function get Value() : byte[];
Valor de la propiedad Matriz de bytes que representa la instancia de IfxRowId.
3-918
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxRowId en la pgina 3-913 Representa el tipo de datos ROWID de DB2. Encapsula el tipo de datos byte[ ] de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Estructura IfxString
Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Public [C#] public [C++] public Basic] Structure IfxString struct IfxString value class IfxString
Ejemplo
[C#] El ejemplo siguiente demuestra cmo recuperar valores de columna de serie de caracteres de una tabla.
[C#] public static string getParam(IfxConnection conn) { string mySelectQuery = "SELECT * FROM EMPLOYEE WHERE WORKDEPT=(?)"; IfxCommand myCommand = new IfxCommand(mySelectQuery, conn); IfxParameter p1 = new IfxParameter(); IfxString dept = new IfxString("D11"); p1.Value = dept; myCommand.Parameters.Add(p1); IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxString selectValue = reader.GetIfxString(3); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
3-919
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxString Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxString. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxString
Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxString.
Campos pblicos
Valor de Null para IfxString. Null
IfxString Inicializa una estructura IfxString nueva con el valor especificado.
Propiedades pblicas
IsNull Obtiene un valor que indica si el valor almacenado en la estructura IfxString es nulo. Obtiene el valor almacenado en la estructura IfxString.
Value
Mtodos pblicos
ToString op_explicit op_implicit Devuelve una serie que representa la estructura IfxString. Convierte la estructura IfxString proporcionada en una serie de caracteres. Convierte la serie de caracteres proporcionada en IfxString.
3-920
Consulta Estructura IfxString en la pgina 3-919 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Campos de IfxString
Los campos de la clase IfxString se listan a continuacin.
Campos pblicos
Valor de Null para IfxString. Null
Consulta Miembros de IfxString en la pgina 3-920 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxString. Estructura IfxString en la pgina 3-919 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxString.Null: Valor de Null para IfxString. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxString [C#] public static readonly IfxString Null [C++] public: static initonly IfxString Null [JScript] public static final var Null () : IfxString
Comentarios El valor de esta constante es NULL.
3-921
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxString en la pgina 3-919 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Constructor de IfxString
Inicializa una estructura IfxString nueva con el valor especificado. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] Public Sub New(value as String) [C#] public IfxString(string value); [C++] public: IfxString(string value); [JScript] public function IfxString(value : string);
Parmetros
value Serie de caracteres para llenar la instancia de IfxString.
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxString en la pgina 3-919 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxString
Los mtodos de la clase IfxString se listan a continuacin.
Mtodos pblicos
ToString Devuelve una serie que representa la estructura IfxString.
3-922
op_explicit op_implicit
Convierte la estructura IfxString proporcionada en una serie de caracteres. Convierte la serie de caracteres proporcionada en IfxString.
Consulta Miembros de IfxString en la pgina 3-920 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxString. Estructura IfxString en la pgina 3-919 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxString.op_explicit: Convierte la estructura IfxString proporcionada en una serie de caracteres. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Narrowing Operator CType (origen As IfxString) As String [C#] public static implicit operator string (IfxString origen) [C++] public: static implicit operator string (IfxString origen)
Parmetros source Estructura IfxString que se convertir en una serie de caracteres. Valor de retorno Valor de una serie de caracteres convertida a partir de una instancia de IfxString. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxString en la pgina 3-919 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET.
3-923
Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxString.op_implicit: Convierte la serie de caracteres proporcionada en IfxString. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Widening Operator CType (origen As String) As IfxString [C#] public static implicit operator IfxString (string origen) [C++] public: static implicit operator IfxString (string origen)
Parmetros source Valor de una serie de caracteres que se convertir en IfxString. Valor de retorno Estructura IfxString con el valor de origen. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxString en la pgina 3-919 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxString.ToString: Devuelve una serie que representa la estructura IfxString. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Overrides Function ToString As String [C#] public override string ToString () [C++]
3-924
public: virtual String^ ToString () override [JScript] public override function ToString () : String
Valor de retorno Serie de caracteres que represneta el valor de la estructura IfxString. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxString en la pgina 3-919 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Propiedades de IfxString
Las propiedades de la clase IfxString se listan a continuacin.
Propiedades pblicas
IsNull Obtiene un valor que indica si el valor almacenado en la estructura IfxString es nulo. Obtiene el valor almacenado en la estructura IfxString.
Value
Consulta Miembros de IfxString en la pgina 3-920 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxString. Estructura IfxString en la pgina 3-919 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxString.IsNull: Obtiene un valor que indica si el valor almacenado en la estructura IfxString es nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-925
Sintaxis
Valor de la propiedad true si Value es nulo; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxString en la pgina 3-919 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxString.Value: Obtiene el valor almacenado en la estructura IfxString. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public ReadOnly Property Value As String [C#] public string Value {get;} [C++] public: __property string get_Value(); [JScript] public function get Value() : string;
Valor de la propiedad Serie de caracteres que representa la instancia de IfxString. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta
3-926
Estructura IfxString en la pgina 3-919 Representa los tipos de datos CHAR, VARCHAR, LONG VARCHAR, GRAPHIC, VARGRAPHIC y LONG VARGRAPHIC de DB2. Encapsula el tipo de datos string de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Estructura IfxTime
Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Public [C#] public [C++] public Basic] Structure IfxTime struct IfxTime value class IfxTime
Ejemplo
[C#] El ejemplo siguiente demuestra cmo recuperar un solo valor de columna TIME de una tabla.
[C#] public static string getParam(IfxConnection conn) { string mySelectQuery = "SELECT * FROM CL_SCHED"; IfxCommand myCommand = new IfxCommand(mySelectQuery, conn); IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxTime selectValue = reader.GetIfxTime(3); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
Seguridad de hebra
3-927
Miembros de IfxTime Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxTime. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxTime
Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxTime.
Campos pblicos
Valor de Null para IfxTime. Null Valor mximo para IfxTime: 24:00:00. MaxValue Valor mximo para IfxTime: 00:00:00. MinValue
Inicializa una estructura IfxTime nueva. IfxTime() IfxTime(TimeSpan) Inicializa una nueva estructura IfxTime con el valor TimeSpan especificado.
Propiedades pblicas
IsNull Value Obtiene un valor que indica si el valor almacenado en la estructura IfxTime es nulo. Obtiene el valor almacenado en la estructura IfxTime en la forma de un TimeStamp.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres proporcionada en IfxTime. Devuelve una serie de caracteres que representa la estructura IfxTime. Convierte la estructura IfxTime proporcionada en TimeStamp. Convierte el TimeStamp proporcionado en IfxTime.
Consulta Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET.
3-928
Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Campos de IfxTime
Los campos de la estructura IfxTime se listan a continuacin.
Campos pblicos
Valor de Null para IfxTime. Null Valor mximo para IfxTime: 24:00:00. MaxValue Valor mximo para IfxTime: 00:00:00. MinValue
Consulta Miembros de IfxTime en la pgina 3-928 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxTime. Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxTime.MaxValue: Valor mximo para IfxTime: 24:00:00. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MaxValue As IfxTime [C#] public static readonly IfxTime MaxValue [C++] public: static initonly IfxTime MaxValue [JScript] public static final var MaxValue () : IfxTime
Comentarios El valor de esta constante es 24:00:00. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0
3-929
Consulta Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxTime.MinValue: Valor mnimo de IfxTime: 00:00:00. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MinValue As IfxTime [C#] public static readonly IfxTime MinValue [C++] public: static initonly IfxTime MinValue [JScript] public static final var MinValue () : IfxTime
Comentarios El valor de esta constante es: 00:00:00. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxTime.Null: Valor de Null para IfxTime. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxTime [C#]
3-930
public static readonly IfxTime Null [C++] public: static initonly IfxTime Null [JScript] public static final var Null () : IfxTime
Comentarios El valor de esta constante es NULL. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Constructores de IfxTime
Inicializa una nueva instancia de la clase IfxTime.
Inicializa un objeto IfxTime nuevo. IfxTime() IfxTime(TimeSpan) Inicializa un objeto IfxTime nuevo con el valor de TimeSpan especificado.
Consulta Miembros de IfxTime en la pgina 3-928 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxTime. Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Constructor de IfxTime.IfxTime(): Inicializa un objeto IfxTime nuevo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-931
Sintaxis
[Visual Basic] Public Sub New() [C#] public IfxTime(); [C++] public: IfxTime(); [JScript] public function IfxTime();
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Constructor de IfxTime.IfxTime(TimeSpan): Inicializa un objeto IfxTime nuevo con el valor de TimeSpan especificado. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New(value as TimeSpan) [C#] public IfxTime(TimeSpan value); [C++] public: IfxTime(TimeSpan value); [JScript] public function IfxTime(value : TimeSpan);
Parmetros Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Constructor de IfxTime.IfxTime(string)
Inicializa una nueva estructura IfxTime con el valor especificado.
3-932
Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Basic] Public Sub New(value as TimeSpan) [C#] public IfxTime(TimeSpan value); [C++] public: IfxTime(TimeSpan value); [JScript] public function IfxTime(value : TimeSpan);
Parmetros
value Un valor System.Timestamp para llenar la instancia de IfxTime.
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxTime
Los mtodos de la estructura IfxTime se listan a continuacin.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres proporcionada en IfxTime. Devuelve una serie de caracteres que representa la estructura IfxTime. Convierte la estructura IfxTime proporcionada en TimeStamp. Convierte el TimeStamp proporcionado en IfxTime.
Consulta Miembros de IfxTime en la pgina 3-928 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxTime. Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET.
3-933
Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxReal.op_explicit: Convierte la estructura IfxReal proporcionada en TimeStamp. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Narrowing Operator CType (origen As IfxReal) As TimeStamp [C#] public static implicit operator TimeStamp (IfxReal origen) [C++] public: static implicit operator TimeStamp (IfxReal origen)
Parmetros source Estructura IfxReal que se convertir en TimeStamp. Valor de retorno Valor TimeStamp que se convertir en una instancia de IfxReal. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxReal en la pgina 3-902 Representa el tipo de datos REAL de DB2. Encapsula el tipo de datos float de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxTime.op_implicit: Convierte el TimeStamp proporcionado en IfxTime. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Widening Operator CType (origen As TimeStamp) As IfxTime [C#] public static implicit operator IfxTime (TimeStamp origen)
3-934
[C++] public: static implicit operator IfxTime (TimeStamp origen)
Parmetros source TimeStamp que se convertir en IfxTime. Valor de retorno Estructura IfxTime con el valor de origen. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxTime.Parse: Convierte la Serie de caracteres proporcionada en IfxTime. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Function Parse (szTime As String) As IfxTime [C#] public static IfxTime Parse (string szTime) [C++] public: static IfxTime Parse (string szTime) [JScript] public static function Parse (szTime String ) : IfxTime
Parmetros szTime Un valor de Serie de caracteres que se convertir en IfxTime. La representacin de la serie de caracteres debe reflejar el formato de hora que corresponde al cdigo de territorio de la aplicacin de cliente. Valor de retorno Estructura IfxTime con el valor numrico de szTime. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0
3-935
Consulta Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxTime.ToString: Devuelve una serie de caracteres que representa la estructura IfxTime. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Serie de caracteres que representa el valor de la estructura IfxTime. La representacin de la serie de caracteres de la hora reflejar el formato de hora que corresponde al cdigo de territorio de la aplicacin de cliente. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Propiedades de IfxTime
Las propiedades de la estructura IfxTime se listan a continuacin.
Propiedades pblicas
IsNull Value Obtiene un valor que indica si el valor almacenado en la estructura IfxTime es nulo. Obtiene el valor almacenado en la estructura IfxTime en la forma de un TimeStamp.
3-936
Consulta Miembros de IfxTime en la pgina 3-928 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxTime. Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxTime.IsNull: Obtiene un valor que indica si el valor almacenado en la estructura IfxTime es nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de la propiedad true si Value es nulo; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxTime.TimeSpanValue: Obtiene el valor almacenado en la estructura IfxTime en la forma de una estructura TimeSpan. Espacio de nombres: IBM.Data.InformixTypes
3-937

Visual Basic] Public ReadOnly Property Value As TimeStamp [C#] public TimeStamp Value {get;} [C++] public: __property TimeStamp get_Value(); [JScript] public function get Value() : TimeStamp;
Valor de la propiedad TimeStamp que representa la instancia de IfxTime. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxTime.Value: Obtiene el valor almacenado en la estructura IfxTime en la forma de un TimeStamp. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de la propiedad TimeStamp que representa la instancia de IfxTime. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta
3-938
Estructura IfxTime en la pgina 3-927 Representa el tipo de datos TIME de DB2. Encapsula el tipo de datos TimeSpan de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Estructura IfxTimeStamp
Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
Sintaxis
Visual Public [C#] public [C++] public Basic] Structure IfxTimeStamp struct IfxTimeStamp value class IfxTimeStamp
Ejemplo
[C#] El ejemplo siguiente demuestra cmo recuperar un solo valor de columna TIMESTAMP de una tabla.
[C#] public static string getParam(IfxConnection conn) { string mySelectQuery = "SELECT * FROM IN_TRAY"; IfxCommand myCommand = new IfxCommand(mySelectQuery, conn); IfxDataReader reader = myCommand.ExecuteReader(); if (reader.Read()) { IfxTimeStamp selectValue = reader.GetIfxTimeStamp(0); if (!selectValue.IsNull) { return selectValue.ToString(); } } return "NULL"; }
Seguridad de hebra
3-939
Miembros de IfxTimeStamp Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxTimeStamp. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxTimeStamp
Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxTimeStamp.
Campos pblicos
Valor de Null para IfxTimeStamp. Null MaxValue MinValue Valor mximo de IfxTimeStamp: 24:00:00.00000, Diciembre 31, 9999. Valor mximo para IfxTimeStamp: 00:00:00.000000, Enero 1, 0001.
IfxTimeStamp(int, int, int, int, int, int, int) IfxTimeStamp(DateTime) Inicializa una nueva estructura IfxTimeStamp con los valores de enteros especificados. Inicializa una estructura IfxTimeStamp nueva con el valor DateTime especificado.
Propiedades pblicas
IsNull Obtiene un valor que indica si el valor almacenado en el objeto IfxTimeStamp es nulo. Obtiene el valor almacenado en el objeto IfxTimeStamp en forma de una serie de caracteres.
Value
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres en IfxTimeStamp. Devuelve una serie de caracteres que representa el objeto IfxTimeStamp. Convierte la estructura IfxTimeStamp proporcionada en TimeStamp. Convierte el TimeStamp proporcionado en IfxTimeStamp.
Consulta
3-940
Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Campos de IfxTimeStamp
Los campos de la estructura IfxTimeStamp se listan a continuacin.
Campos pblicos
Valor de Null para IfxTimeStamp. Null MaxValue MinValue Valor mximo de IfxTimeStamp: 24:00:00.00000, Diciembre 31, 9999. Valor mximo para IfxTimeStamp: 00:00:00.000000, Enero 1, 0001.
Consulta Miembros de IfxTimeStamp en la pgina 3-940 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxTimeStamp. Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxTimeStamp.MaxValue: Valor mximo de IfxTimeStamp: 24:00:00.00000, Diciembre 31, 9999. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MaxValue As IfxTimeStamp [C#] public static readonly IfxTimeStamp MaxValue [C++] public: static initonly IfxTimeStamp MaxValue [JScript] public static final var MaxValue () : IfxTimeStamp
Comentarios El valor de esta constante es 24:00:00.00000, Diciembre 31, 9999.
3-941
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxTimeStamp.MinValue: Valor mnimo de IfxTimeStamp: 00:00:00.000000, Enero 1, 0001. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared ReadOnly MinValue As IfxTimeStamp [C#] public static readonly IfxTimeStamp MinValue [C++] public: static initonly IfxTimeStamp MinValue [JScript] public static final var MinValue () : IfxTimeStamp
Comentarios El valor de esta constante es: 00:00:00.000000, Enero 1, 0001. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Campo IfxTimeStamp.Null: Valor de Null para IfxTimeStamp. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-942
Sintaxis
Visual Basic] Public Shared ReadOnly Null As IfxTimeStamp [C#] public static readonly IfxTimeStamp Null [C++] public: static initonly IfxTimeStamp Null [JScript] public static final var Null () : IfxTimeStamp
Comentarios El valor de esta constante es NULL. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Constructores IfxTimeStamp
Inicializa una nueva instancia de la clase IfxTimeStamp.
IfxTimeStamp(int, int, int, int, int, int, int) IfxTimeStamp(DateTime) Inicializa un objeto IfxTimeStamp nuevo con el valor DateTime especificado. Inicializa un objeto IfxTimeStamp nuevo con los valores de enteros especificados.
Consulta Miembros de IfxTimeStamp en la pgina 3-940 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxTimeStamp. Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Constructor de IfxTimeStamp.IfxTimeStamp(int, int, int, int, int, int, int): Inicializa una nueva estructura IfxTimeStamp con los valores de enteros especificados.
3-943

Visual Basic] Public Sub New(year as Integer, month as Integer, _ day as Integer, hour as Integer, _ minute as Integer, second as Integer, _ microsecond as Integer _ ) [C#] public IfxTimeStamp(int year, int month, int day, int hour, int minute, int second, int second ); [C++] public: IfxTimeStamp(int year,int month, int day, int hour, int minute, int second, int second ); [JScript] public function IfxTimeStamp(year : int, month : int, year : int, month : int, day : int, hour : int, minute : int, second : int, microsecond : int );
Parmetros year Valor entero para proporcionar el ao para la instancia de IfxTimeStamp.
month Valor entero para proporcionar el mes para la instancia de IfxTimeStamp. day hour minute Valor entero para proporcionar el minuto para la instancia de IfxTimeStamp. second Valor entero para proporcionar el segundo para la instancia de IfxTimeStamp. microsecond Valor entero para proporcionar el microsegundo para la instancia de IfxTimeStamp. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Valor entero para proporcionar el da para la instancia de IfxTimeStamp. Valor entero para proporcionar la hora para la instancia de IfxTimeStamp.
3-944
Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Constructor de IfxTimeStamp.IfxTimeStamp(DateTime): Inicializa una estructura IfxTimeStamp nueva con el valor DateTime especificado. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Sub New(valordh as DateTime) [C#] public IfxTimeStamp(DateTime valordh); [C++] public: IfxTimeStamp(DateTime valordh); [JScript] public function IfxTimeStamp(valordh : DateTime);
Parmetros value Valor de DateTime para llenar la instancia de IfxTimeStamp.
Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Mtodos de IfxTimeStamp
Los mtodos de la clase IfxTimeStamp se listan a continuacin.
Mtodos pblicos
Parse ToString op_explicit op_implicit Convierte la Serie de caracteres en IfxTimeStamp. Devuelve una serie de caracteres que representa el objeto IfxTimeStamp. Convierte la estructura IfxTimeStamp proporcionada en TimeStamp. Convierte el TimeStamp proporcionado en IfxTimeStamp.
Consulta
3-945
Miembros de IfxTimeStamp en la pgina 3-940 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxTimeStamp. Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxTimeStamp.op_explicit: Convierte la estructura IfxTimeStamp proporcionada en DateTime. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Narrowing Operator CType (source As IfxTimeStamp) As DateTime [C#] public static implicit operator DateTime (IfxTimeStamp source) [C++] public: static implicit operator DateTime (IfxTimeStamp source)
Parmetros source Estructura IfxTimeStamp que se convertir en DateTime. Valor de retorno Valor DateTime convertido a partir de una instancia de IfxTimeStamp. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxTimeStamp.op_implicit: Convierte el TimeStamp proporcionado en IfxTimeStamp. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
3-946
Sintaxis
Visual Basic] Public Shared Widening Operator CType (origen As Short) As IfxTimeStamp [C#] public static implicit operator IfxTimeStamp (short origen) [C++] public: static implicit operator IfxTimeStamp (short origen)
Parmetros source Valor TimeStamp que se convertir en IfxTimeStamp. Valor de retorno Estructura IfxTimeStamp con el valor de origen. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxInt16 en la pgina 3-856 Representa el tipo de datos SMALLINT de DB2. Encapsula el tipo de datos short de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxTimeStamp.Parse: Convierte la Serie de caracteres en IfxTimeStamp. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Visual Basic] Public Shared Function Parse (szTimeStamp As String) As IfxTimeStamp [C#] public static IfxTimeStamp Parse (string szTimeStamp) [C++] public: static IfxTimeStamp Parse (string szTimeStamp) [JScript] public static function Parse (szTimeStamp String ) : IfxTimeStamp
Parmetros szTimeStamp Valor de Serie de caracteres que se convertir en IfxTimeStamp. La representacin de la serie de la indicacin de fecha y hora debe reflejar el formato de fecha que corresponde al cdigo de territorio de la aplicacin de cliente.
3-947
Valor de retorno Estructura IfxTimeStamp con el valor numrico de szTimeStamp. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Mtodo IfxTimeStamp.ToString: Devuelve una serie de caracteres que representa la estructura IfxTimeStamp. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de retorno Serie de caracteres que representa el valor de la estructura IfxTimeStamp. La representacin de la serie de caracteres de la indicacin de fecha y hora reflejar el formato de fecha y hora que corresponde al cdigo de territorio de la aplicacin de cliente. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Propiedades de IfxTimeStamp
Las propiedades de la estructura IfxTimeStamp se listan a continuacin.
3-948
Propiedades pblicas
IsNull Obtiene un valor que indica si el valor almacenado en el objeto IfxTimeStamp es nulo. Obtiene el valor almacenado en el objeto IfxTimeStamp en forma de una serie de caracteres.
Value
Consulta Miembros de IfxTimeStamp en la pgina 3-940 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Las tablas siguientes listan los miembros expuestos por la estructura IfxTimeStamp. Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider. Propiedad IfxTimeStamp.IsNull: Obtiene un valor que indica si el valor almacenado en la estructura IfxTimeStamp es nulo. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de la propiedad true si Value es nulo; de lo contrario, false. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-949
Propiedad IfxTimeStamp.Value: Obtiene el valor almacenado en el objeto IfxTimeStamp en forma de un TimeStamp. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis
Valor de la propiedad TimeStamp que representa la instancia de IfxTimeStamp. Informacin de versin Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Estructura IfxTimeStamp en la pgina 3-939 Representa el tipo de datos TIMESTAMP de DB2. Encapsula el tipo de datos DateTime de .NET. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Clase IfxTruncateException
La excepcin que se genera al acceder a la propiedad Value para una instancia IfxDecimal o IfxDecimalFloat y la precisin del valor excede el que una variable .NET Decimal. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.Exception System.SystemException IBM.Data.Informix.IfxTypeException IBM.Data.Informix.IfxTruncateException
3-950
Sintaxis
Visual Basic] Public Class IfxTruncateException [C#] public class IfxTruncateException [C++] public __gc class IfxTruncateException [JScript] public class IfxTruncateException
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxTruncateException La excepcin qeu se genera al acceder a la propiedad Value para una instancia IfxDecimal o IfxDecimalFloat y la precisin del valor excede el que una variable .NET Decimal. Las tablas siguientes listan los miembros expuestos por la clase IfxTruncateException. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxTruncateException
La excepcin qeu se genera al acceder a la propiedad Value para una instancia IfxDecimal o IfxDecimalFloat y la precisin del valor excede el que una variable .NET Decimal. Las tablas siguientes listan los miembros expuestos por la clase IfxTruncateException.
Propiedades pblicas
3-951
Mtodos pblicos
Mtodos protegidos
Consulta Clase IfxTruncateException en la pgina 3-950 La excepcin que se genera al acceder a la propiedad Value para una instancia IfxDecimal o IfxDecimalFloat y la precisin del valor excede el que una variable .NET Decimal. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-952
Clase IfxTypeException
Las subclases IfxFormatException, IfxNullValueException, IfxTruncateException representan las excepciones que se pueden emitir durante la utilizacin incorrecta de determinadas instancias de clase o estructura IBM.Data.IfxTypes. Espacio de nombres: IBM.Data.InformixTypes Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll)
System.Object System.Exception System.SystemException IBM.Data.Informix.IfxTypeException
Sintaxis
Visual Basic] Public Class IfxTypeException [C#] public class IfxTypeException [C++] public __gc class IfxTypeException [JScript] public class IfxTypeException
Seguridad de hebra
Versin de .NET Framework Soportado en: 1.1, 2.0 y 3.0 Consulta Miembros de IfxTypeException Las subclases IfxFormatException, IfxNullValueException, IfxTruncateException representan las excepciones que se pueden emitir durante la utilizacin incorrecta de determinadas instancias de clase o estructura IBM.Data.IfxTypes. Las tablas siguientes listan los miembros expuestos por la clase IfxTypeException. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
Miembros de IfxTypeException
Las subclases IfxFormatException, IfxNullValueException, IfxTruncateException representan las excepciones que se pueden emitir durante la utilizacin incorrecta de determinadas instancias de clase o estructura IBM.Data.IfxTypes. Las tablas siguientes listan los miembros expuestos por la clase IfxTypeException.
3-953
Propiedades pblicas
Mtodos pblicos
3-954
Mtodos protegidos
Consulta Clase IfxTypeException en la pgina 3-953 Las subclases IfxFormatException, IfxNullValueException, IfxTruncateException representan las excepciones que se pueden emitir durante la utilizacin incorrecta de determinadas instancias de clase o estructura IBM.Data.IfxTypes. Espacio de nombres IBM.Data.IfxTypes en la pgina 3-802 El espacio de nombres IBM.Data.IfxTypes proporciona clases y estructuras que representan tipos de datos Informix para .NET Framework Data Provider.
3-955
3-956

Programas de demostracin. . . . . . . . . . . . . . . . Ejemplos . . . . . . . . . . . . . . . . . . . . . . Recuperacin de un nico valor . . . . . . . . . . . . . Recuperacin de mltiples columnas. . . . . . . . . . . . Ejecucin de SQL, que no devuelve datos, y uso de una transaccin . Recuperacin de datos en un archivo . . . . . . . . . . . Utilizacin del objeto IfxCommandBuilder para reconciliar los cambios Llamada de un procedimiento almacenado . . . . . . . . . Uso de las transacciones distribuidas . . . . . . . . . . . Grabar CLOBs en archivos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . con la base . . . . . . . . . . . . . . . . . . de . . . . . . . . . . . . . . . datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1 4-1 4-1 4-2 4-3 4-3 4-4 4-5 4-6 4-7
Programas de demostracin
Los programas de demostracin para IBM Informix .NET Provider estn disponibles en la carpeta %INFORMIXDIR%\demo\dotnetdemo. Estos programas incluyen los siguientes dominios de desarrollo de la aplicacin: v C# Windows Forms v VB.NET Windows Forms v ASP.NET Web Forms
Ejemplos
Esta seccin incluye ejemplos breves que demuestran el uso de cada objeto o muestra cmo realizar determinadas tareas de la base de datos. Los ejemplos son breves para que sean ms claros. Por ello, no representan aplicaciones completas reales. Se presupone que estos ejemplos hacen referencia a aplicaciones de consola escritas en el lenguaje C#. Se da por hecho que el usuario ya ha importado el espacio de nombres IBM.Data.Informix incluyendo la siguiente directiva en el programa:
using IBM.Data.Informix;
En la mayora de ejemplos se utiliza una de las bases de datos de ejemplo incluidas en los servidores de la base de datos IBM Informix. Las bases de datos de ejemplo utilizadas son stores_demo y superstores_demo. Las instrucciones sobre cmo crear estas bases de datos se encuentran en IBM Informix Gua del usuario de DBAccess.
Recuperacin de un nico valor

Utilice el mtodo IfxCommand.ExecuteScalar si sabe que el SQL que quiere ejecutar devolver un nico valor. El mtodo IfxCommand.ExecuteScalar devuelve un System.Object. Deber convertir el resultado al tipo de datos que quiera recibir. Este ejemplo devuelve la entrada de COUNT(*) que es un valor decimal, por lo que System.Object se convertir al tipo System.Decimal.
try { // Abra una conexin IfxConnection conn = new IfxConnection( "Host=myhost;Service=1541;Server=myifxserver;Database=stores_demo;" + "User ID=mylogin;password=mypassword"
4-1
); conn.Open(); // Cree un mandato SQL IfxCommand cmd = new IfxCommand( "SELECT COUNT(*) FROM customer", conn ); Decimal ccount = (Decimal)cmd.ExecuteScalar(); Console.WriteLine("There are " + ccount + " customers"); // Cierre la conexin conn.Close(); Console.ReadLine(); // Espere la respuesta } catch(IfxException e) { Console.WriteLine(e.ToString()); Console.ReadLine(); //Espere la respuesta }
Recuperacin de mltiples columnas

Este ejemplo conecta la base de datos stores_demo y utiliza un objeto IfxDataReader para recuperar todos los nombres de la tabla del cliente. Utilice un objeto IfxDataReader para acceder ms fcilmente a los datos para no tener que escribir ni tener que retroceder.
try { // Abra una conexin IfxConnection conn = new IfxConnection( "Host=myhost;Service=1541;Server=myifxserver;Database=stores_demo;" + "User ID=mylogin;password=mypassword" ); conn.Open(); // Cree un mandato SQL IfxCommand cmd = new IfxCommand( "SELECT fname FROM customer", conn ); IfxDataReader dr = cmd.ExecuteReader(); // Escriba los datos en la consola while (dr.Read()) { Console.WriteLine(dr["fname"].ToString()); } Console.ReadLine(); // Espere la respuesta dr.Close(); // Cierre la conexin conn.Close(); } catch(IfxException e) { Console.WriteLine(e.ToString()); Console.ReadLine(); // Espere la respuesta }
4-2
Ejecucin de SQL, que no devuelve datos, y uso de una transaccin

Para ejecutar sentencias SQL que no devuelven datos deber utilizar le mtodo IfxCommand.ExecuteNonQuery. Los tipos de sentencias SQL que no devuelven datos son: v Inserciones v Actualizaciones v Supresiones v Creacin o alteracin de objetos de la base de datos Este ejemplo muestra cmo utilizar IfxCommand.ExecuteNonQuery para realizar una insercin y tambin cmo ejecutar un IfxCommand dentro de una transaccin local. Para que funcione este ejemplo, la base de datos stores_demo debe tener una anotacin cronolgica de transacciones. Para crear una base de datos stores_demo que tenga una anotacin cronolgica de transacciones, ejecute el mandato dbaccessdemo con la opcin -log.
try { // Abra una conexin IfxConnection conn = new IfxConnection( "Host=myhost;Service=1541;" + "Server=myifxserver;Database=stores_demo;" + "User ID=mylogin;password=mypassword" ); conn.Open(); //Inicie la transaccin IfxTransaction tx = conn.BeginTransaction(); //Cree un IfxCommand que utilice la conexin y la transaccin IfxCommand cmd = new IfxCommand( "INSERT INTO state VALUES(XX,No State)", conn, tx ); //Ejecute el mandato cmd.ExecuteNonQuery(); //Confirme la transaccin tx.Commit(); // Cierre la conexin conn.Close(); } catch(IfxException e) { Console.WriteLine(e.ToString()); Console.ReadLine(); //Espere la respuesta }
Recuperacin de datos en un archivo

Para recuperar la informacin de la base de datos en un objeto System.Data.DataSet para seguir procesndola, utilice un objeto IfxDataAdapter. Este ejemplo crea un System.Data.DataSet y lo llena con el primer y el ltimo nombre de la tabla del cliente. A continuacin, para mostrar que est lleno, enva el System.Data.DataSet a la consola en formato XML. Para obtener informacin sobre los archivos, consulte su documentacin sobre .NET o ADO.
4-3
try { // Abra una conexin IfxConnection conn = new IfxConnection( "Host=myhost;Service=1541;Server=myifxserver;Database=stores_demo;" + "User ID=mylogin;password=mypassword" ); conn.Open(); IfxDataAdapter da = new IfxDataAdapter( "SELECT fname, lname FROM customer", conn ); System.Data.DataSet ds = new System.Data.DataSet("Names"); //Llene el DataSet da.Fill(ds); //El DataSet ya se puede utilizar. //Este ejemplo enva el DataSet a la consola como XML //para mostrar que est lleno. ds.WriteXml(Console.Out); Console.ReadLine(); //Espere la respuesta // Cierre la conexin conn.Close(); } catch(IfxException e) { Console.WriteLine(e.ToString()); Console.ReadLine(); //Espere la respuesta }
Utilizacin del objeto IfxCommandBuilder para reconciliar los cambios con la base de datos
Puede utilizar el objeto IfxCommandBuilder para recuperar los datos con una sentencia SQL SELECT, realizar cambios en el archivo y luego reconciliarlos con la base de datos de IBM Informix, tal como se muestra en el siguiente ejemplo. El objeto IfxCommandBuilder permite una fcil reconciliacin de los cambios realizados en su archivo con la base de datos. Para obtener ms informacin sobre cmo reconciliar los cambios en la base de datos, consulte Reconciliacin de los cambios de DataSet con la base de datos en la pgina 1-5.
// Agregue el espacio de nombres IBM Informix using System.Data; using IBM.Data.Informix; // Cree una conexin IfxConnection conn=new IfxConnection("Host=berry; Service=3500; Server=testserver; User ID=informix; password=ifxtest; Database=testdb"); // Cree un objeto DataAdapter IfxDataAdapter allDataAdapter = new IfxDataAdapter(); IfxCommand selCmd = new IfxCommand("SELECT * FROM students", conn); allDataAdapter.SelectCommand = selCmd; //Defina el objeto CommandBuilder IfxCommandBuilder cbuild = new IfxCommandBuilder(allDataAdapter); DataSet allDataSet = new DataSet (); try
4-4
{ // Abra la conexin conn.Open(); allDataAdapter.Fill(allDataSet); // Modifique la edad de un estudiante DataRow chRow; chRow = allDataSet.Tables["Table"].Rows[5]; chRow["age"] = 24; // Utilice IfxDataAdapter.Update() para reconciliar los cambios con //la base de datos allDataAdapter.Update(allDataSet); } catch (Exception ex); { // Utilice un recuadro de mensaje para visualizar los errores MessageBox.Show (ex.Message); } // Cierre la conexin conn.Close();
Llamada de un procedimiento almacenado

Utilice el objeto IfxCommand para llamar un procedimiento almacenado. Deber establecer el objeto IfxCommand en la propiedad CommandType en StoredProcedure. El siguiente ejemplo muestra cmo ejecutar un procedimiento almacenado y leer los resultados devueltos por dicho procedimiento utilizando un objeto IfxDataReader.
// Agregue el espacio de nombres IBM Informix using System.Data; using IBM.Data.Informix; // Cree una conexin IfxConnection conn=new IfxConnection("Host=berry; Service=3500; Server=testserver; User ID=informix; password=ifxtest; Database=testdb"); conn.Open(); //Cree un objeto de comando para el procedimiento almacenado IfxCommand spCmd = new IfxCommand("testproc", conn); // Establezca la propiedad CommandType en Storedprocedure spCmd.CommandType = CommandType.StoredProcedure IfxDataReader testDataReader; try { testDataReader = spCmd.ExecuteReader(); testDataReader.Close(); } catch (Exception ex) { // Utilice un recuadro de mensaje para visualizar los errores MessageBox.Show (ex.Message); } // Cierre la conexin
4-5
conn.Close();
Uso de las transacciones distribuidas

El siguiente ejemplo utiliza pseudo-cdigos para demostrar cmo se utilizan las transacciones distribuidas.
... using System.EnterpriseServices; using IBM.Data.Informix; ... [assembly: AssemblyKeyFile("test.snk")] ... public static void Main() { ... /* La construccin using que aparece a continuacin tiene como resultado la llamada a Dispose al salir de las llaves. Es importante disponer de los objetos COM+ cuanto antes, para que los servicios COM+, como la agrupacin de objetos, funcionen correctamente */ using (TwoPhaseTxn txn = new TwoPhaseTxn) { txn.TestAutoComplete_Exception(); } using (TwoPhaseTxn txn = new TwoPhaseTxn) { txn.TestAutoComplete_TransactionVote(); } ... } //Los atributos de la transaccin especifican el tipo de transaccin solicitada [Transaction(TransactionOption.RequiresNew)] public class TwoPhaseTxn : ServicedComponent { [AutoComplete] public void TestAutoComplete_Exception() { IfxConnection ifxConn1 = new IfxConnection(db=db1;server=srv1; enlist=true;); IfxConnection ifxConn2 = new IfxConnection(db=db2;server=srv2; enlist=true;); try { // operacin de bd en ifxConn1 } catch { // emite una excepcin } try { // operacin de bd en ifxConn2 } catch { // emite una excepcin } } [AutoComplete] public void TestAutoComplete_TransactionVote()
4-6
{ IfxConnection ifxConn1 = new IfxConnection(db=db1;server=srv1; enlist=true;); IfxConnection ifxConn2 = new IfxConnection(db=db2;server=srv2; enlist=true;); try { // operacin de bd en ifxConn1 } catch { // En caso de fallo, abortar distintivo ContextUtil.MyTransactionVote = TransactionVote.Abort } try { // operacin de bd en ifxConn2 } catch { // En caso de fallo, abortar distintivo ContextUtil.MyTransactionVote = TransactionVote.Abort } }
Grabar CLOBs en archivos

Este ejemplo se conecta con la base de datos superstores_demo y graba todos los CLOBs en la tabla catalog en los archivos del directorio C:\tmp. Se utiliza la misma tcnica para grabar BLOBs en los archivos. Tenga en cuenta que la instancia IfxClob debe abrirse antes de acceder a ella.
try { // Abra una conexin IfxConnection conn = new IfxConnection( "Host=myhost;" + "Service=1576;" + "Server=mydbserver;"+ "Database=superstores_demo;" + "User ID=mylogin;password=mypassword" ); conn.Open(); // Cree un mandato SQL IfxCommand cmd = new IfxCommand( "SELECT advert_descr, catalog_num FROM catalog", conn ); IfxDataReader dr = cmd.ExecuteReader(); // Grabe los CLOBs en los archivos bajo C:\tmp while (dr.Read()) { if(!dr.IsDBNull(0)){ IfxClob c = dr.GetIfxClob(0); long num = dr.GetInt64(1); c.Open(IBM.Data.Informix.IfxSmartLOBOpenMode.ReadOnly); c.ToFile( "C:\\tmp\\" + num.ToString() + ".txt", System.IO.FileMode.Create,
4-7
IfxSmartLOBFileLocation.Client ); } } dr.Close(); // Cierre la conexin conn.Close(); } catch(Exception e) { //Se presupone que esto es una aplicacin de consola Console.WriteLine(e.ToString()); }
4-8
Apndice. Accesibilidad
IBM se esfuerza por proporcionar productos que puedan ser utilizados por todas las personas, cualquiera que sea su edad o capacidad.
Funciones de accesibilidad de IBM Informix Dynamic Server

Las funciones de accesibilidad ayudan a un usuario que tenga una minusvala fsica, tal como una movilidad restringida o una visin limitada, a utilizar satisfactoriamente productos de tecnologa de la informacin.
Funciones de accesibilidad
La lista siguiente incluye las funciones de accesibilidad principales de IBM Informix Dynamic Server. Estas funciones permiten: v Utilizacin del sistema basada en el teclado solamente. v Interfaces que son utilizadas habitualmente por lectores de pantalla. v Conexin de dispositivos alternativos de entrada y salida. Consejo: El Centro de informacin de IBM Informix Dynamic Server y sus publicaciones asociadas estn habilitados para el dispositivo IBM Home Page Reader. Puede utilizar todas las funciones mediante el teclado en lugar de utilizar el ratn.
Navegacin mediante el teclado

El presente producto utiliza teclas de navegacin estndar de Microsoft Windows.
Informacin afn sobre accesibilidad

IBM se compromete a que su documentacin sea accesible para las personas con discapacidades. Nuestras publicaciones estn disponibles en formato HTML, por lo que se puede acceder a ellas mediante tecnologa de asistencia a discapacitados, tal como software lector de pantallas. Los diagramas de sintaxis contenidos en nuestras publicaciones estn disponibles en el formato decimal con puntos. Puede visualizar las publicaciones de IBM Informix Dynamic Server en formato PDF (Portable Document Format) de Adobe, utilizando el lector Adobe Acrobat Reader.
IBM y accesibilidad
Consulte la publicacin IBM Accessibility Center en http://www.ibm.com/able para obtener ms informacin sobre el compromiso que IBM tiene con respecto al tema de la accesibilidad.
A-1
A-2
Avisos
Es posible que IBM no ofrezca en todos los pases los productos, los servicios o las caractersticas que se describen en este documento. Consulte al representante local de IBM para obtener informacin sobre los productos y servicios que actualmente estn disponibles en su rea. Las referencias a un producto, programa o servicio de IBM no pretenden indicar o implicar que solo se pueda utilizar ese producto, programa o servicio de IBM. En su lugar, se puede utilizar cualquier producto, programa o servicio funcionalmente equivalente que no infrinja ninguno de los derechos de propiedad intelectual de IBM. No obstante, es responsabilidad del usuario evaluar y verificar el funcionamiento de cualquier producto, programa o servicio que no sea de IBM. IBM puede tener patentes o solicitudes de patentes pendientes que cubran temas tratados en este documento. El suministro de este documento no le confiere ninguna licencia sobre dichas patentes. Puede enviar consultas acerca de licencias, por escrito, a la direccin siguiente: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 EE.UU. Para formular consultas acerca de licencias referentes a informacin de doble byte (DBCS), pngase en contacto con el Departamento de la Propiedad Intelectual de IBM de su pas o enve las consultas, por escrito, a la direccin siguiente: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokio 106-0032, Japn El prrafo siguiente no es aplicable al Reino Unido ni a ningn otro pas en el que tales disposiciones sean incompatibles con la legislacin local: INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIN TAL CUAL SIN GARANTAS DE NINGUNA CLASE, NI EXPLCITAS NI IMPLCITAS, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LAS GARANTAS IMPLCITAS DE NO INFRACCIN, COMERCIABILIDAD O ADECUACIN A UN PROPSITO DETERMINADO. Algunos estados no permiten la renuncia a las garantas explcitas o implcitas en determinadas transacciones, por lo que puede que esta declaracin no le sea aplicable. Esta informacin puede contener imprecisiones tcnicas o errores tipogrficos. Peridicamente, se efectan cambios en la informacin aqu incluida; estos cambios se incorporarn en nuevas ediciones de la publicacin. En cualquier momento y sin previo aviso, IBM puede efectuar mejoras y/o cambios en los productos y/o programas descritos en esta publicacin. Las referencias hechas en esta informacin a sitios Web que no sean de IBM se proporcionan nicamente por comodidad y de ningn modo suponen un aval de dichos sitios Web. El contenido de esos sitios Web no forma parte del contenido del presente producto de IBM y la utilizacin de esos sitios Web corre a cuenta y riesgo del usuario.
B-1
IBM puede utilizar o distribuir la informacin que se le facilite del modo que IBM considere oportuno sin incurrir en ninguna obligacin con el remitente. Los licenciatarios de este programa que deseen obtener informacin sobre el mismo con el fin de permitir: (i) el intercambio de informacin entre programas creados de forma independiente y otros programas (incluido ste) y (ii) el uso mutuo de la informacin intercambiada, deben ponerse en contacto con: IBM Corporation J46A/G4 555 Bailey Avenue San Jos, CA 95141-1003 EE.UU. Esta informacin puede estar disponible, de acuerdo con los trminos y condiciones pertinentes, incluido, en algunos casos, el pago de una tarifa. IBM proporciona el programa bajo licencia descrito en esta informacin y todo el material bajo licencia disponible para el mismo segn los trminos del Acuerdo del cliente de IBM, del Acuerdo internacional de licencia de programas de IBM o de cualquier acuerdo equivalente entre ambas partes. Los datos de rendimiento que contiene esta publicacin se han determinado en un entorno controlado. Por ello, los resultados obtenidos en otros entornos operativos pueden variar significativamente. Algunas medidas pueden haberse tomado en sistemas en desarrollo y no se garantiza que tales medidas sean las mismas en los sistemas disponibles de forma generalizada. Adems, es posible que algunas medidas se hayan calculado mediante extrapolacin. Los resultados reales pueden variar. Los usuarios de este documento debern verificar los datos adecuados para su entorno especfico. La informacin concerniente a productos que no sean de IBM se ha conseguido de los suministradores de dichos productos, de sus anuncios publicados o bien de otras fuentes pblicas. IBM no ha probado esos productos y no puede confirmar con precisin el rendimiento, la compatibilidad ni otras exigencias en relacin con los productos que no son de IBM. Las preguntas sobre las prestaciones de los productos que no son de IBM deben ir dirigidas a los suministradores de dichos productos. Todas las referencias a intenciones u orientaciones futuras de IBM estn sujetas a cambios o retractacin sin previo aviso, y representan nicamente metas y objetivos. Todos los precios de IBM que se muestran en este documento son precios al por mayor recomendados por IBM, vigentes y estn sujetos a cambios sin previo aviso. Los precios de los concesionarios pueden variar. Esta informacin contiene ejemplos de datos e informes que se utilizan en las operaciones comerciales diarias. Para ilustrarlos lo ms exhaustivamente posible, los ejemplos incluyen nombres de personas, compaas, marcas y productos. Todos estos nombres son ficticios y cualquier similitud con los nombres y direcciones utilizados por una compaa comercial real es pura coincidencia. LICENCIA DE COPYRIGHT: Esta informacin contiene programas de aplicacin de ejemplo en lenguaje fuente, que ilustran tcnicas de programacin en diversas plataformas operativas. Puede
B-2
copiar, modificar y distribuir estos programas de ejemplo del modo que considere adecuado sin previo pago a IBM, con el objeto de desarrollar, utilizar, comercializar o distribuir programas de aplicacin de acuerdo con la interfaz de programacin de aplicaciones para la plataforma operativa para la cual se han escrito los programas de ejemplo. Estos ejemplos no se han probado en profundidad bajo todas las condiciones. Por lo tanto, IBM no puede garantizar ni implicar la fiabilidad, el servicio ni el funcionamiento de estos programas. Puede copiar, modificar y distribuir estos programas de ejemplo del modo que considere adecuado sin pagar a IBM con el objeto de desarrollar, utilizar, comercializar o distribuir programas de aplicacin de acuerdo con las interfaces de programacin de aplicaciones de IBM. Cada copia o fragmento de estos programas de ejemplo o de cualquier trabajo derivado debe incluir un aviso de copyright como el que se muestra a continuacin: (nombre de la compaa) (ao). Partes de este cdigo proceden de programas de ejemplo de IBM Corp. Copyright IBM Corp. (escriba el ao o aos). Reservados todos los derechos. Si est visualizando esta informacin en copia software, es posible que las fotografas y las ilustraciones en color no aparezcan.
Marcas registradas
Los trminos siguientes se utilizan en una o ms publicaciones de productos IBM Informix y los trminos son marcas registradas de International Business Machines Corporation en los Estados Unidos o en otros pases:
AIX AnalystStudio C-ISAM Cloudscape DataBlade DB2 DB2 Connect DB2 Universal Database Distributed Relational Database Architecture Domino DRDA Dynamic Connect IBM Informix Lotus Lotus Notes MQSeries NetView Notes NUMA-Q OS/2 OS/390 OS/400 Passport Advantage ProjectConsole Rational Rational Suite Rational Unified Process RedBack Red Brick RequisitePro RETAIN SQL/DS SystemBuilder Tivoli TME 10 UniData UniVerse WebSphere z/OS
Adobe, Acrobat, Portable Document Format (PDF) y PostScript son marcas registradas de Adobe Systems Incorporated en los Estados Unidos o en otros pases.
Avisos
B-3
Intel, el logotipo de Intel, Intel Inside, el logotipo de Intel Inside, Intel Centrino, el logotipo de Intel Centrino, Celeron, Intel Xeon, Intel SpeedStep, Itanium y Pentium son marcas registradas de Intel Corporation o de sus empresas filiales en los Estados Unidos y en otros pases. Java y todas las marcas registradas y logotipos basados en Java son marcas registradas de Sun Microsystems, Inc. en los Estados Unidos o en otros pases. Microsoft, Windows, Windows NT y el logotipo de Windows son marcas registradas de Microsoft Corporation en los Estados Unidos o en otros pases. UNIX es una marca registrada de The Open Group en los Estados Unidos y en otros pases. Linux es una marca registrada de Linus Torvalds en los Estados Unidos o en otros pases. Otros nombres de empresas, productos o servicios utilizados en esta publicacin pueden ser marcas registradas o marcas de servicio de terceros.
B-4
ndice Caracteres Especiales

? smbolo, parmetros 1-6 Clase IfxDataAdapter 1-5, 2-1, 3-255 ejemplo de uso 4-3 Clase IfxDataReader 3-291, 4-2 ejemplo de uso 4-2 Clase IfxDataSourceEnumerator 3-363 Clase IfxError 3-371 Clase IfxErrorCollection 3-384 Clase IfxException 3-392 Clase IfxFactory 3-402 Clase IfxFormatException 3-889 Clase IfxInfoMessageEventArgs 3-415 Clase IfxNullValueException 3-887 Clase IfxParameter 3-418 Clase IfxParameterCollection 3-453 Clase IfxPermission 3-501 Clase IfxPermissionAttribute 3-495 Clase IfxRecord 3-509 clase IfxResultSet 3-563 Clase IfxRowsCopiedEventArgs 3-697 Clase IfxRowUpdatedEventArgs 3-684 Clase IfxRowUpdatingEventArgs 3-691 Clase IfxTransaction 3-701 Clase IfxTruncateException 3-950 Clase IfxTypeException 3-953 Clase IfxUpdatableRecord 3-717 Clase System.DataSet Reconciliacin de los cambios con la base de datos ejemplo de 4-4 Clave primaria 1-5 Claves externas 1-6 Conexin a bases de datos 1-4 Constructor de IfxBinary 3-806 Constructor de IfxBulkCopyColumnMappingCollection 3-49 Constructor de IfxClob 3-814 Constructor de IfxCommand 3-104 Constructor de IfxCommand () 3-105 Constructor de IfxCommand (String) 3-106 Constructor de IfxCommand (String, IfxConnection) 3-107 Constructor de IfxCommand (String, IfxConnection, IfxTransaction) 3-108 Constructor de IfxCommandBuilder 3-74 Constructor de IfxCommandBuilder (IfxDataAdapter) 3-75 Constructor de IfxConnection 3-162 Constructor de IfxConnection () 3-163 Constructor de IfxConnection (String) 3-165 Constructor de IfxConnectionStringBuilder 3-223 Constructor de IfxDataAdapter 3-261 Constructor de IfxDataAdapter () 3-263 Constructor de IfxDataAdapter (IfxCommand) 3-265 Constructor de IfxDataAdapter (String, IfxConnection) 3-267 Constructor de IfxDataAdapter (String, String) 3-269 Constructor de IfxDate 3-825 Constructor de IfxDouble 3-850 Constructor de IfxInt16 3-861 Constructor de IfxInt32 3-871 Constructor de IfxInt64 3-881 Constructor de IfxParameter 3-422 Constructor de IfxParameter () 3-424 Constructor de IfxParameter (String, IfxType) 3-426 Constructor de IfxParameter (String, IfxType, Int32) 3-427
A
accesibilidad A-1 teclado A-1 teclas de atajo A-1 ADO.NET 1-2 Agrupacin de conexiones 1-6 Argumento IfxType 2-2 ASP.NET 1-1, 4-1 Atributo Enlist 1-7 Atributo Max Pool Size 1-6 Atributo Min Pool Size 1-6 Atributo Pooling 1-6, 1-7 Atributos, para la conexin 1-4
B
base de datos sysmaster Bases de datos conexin a 1-4 1-2
C
Campos de IfxBinary 3-805 Campos de IfxClob 3-813 Campos de IfxDataSourceEnumerator 3-365 Campos de IfxDate 3-822 Campos de IfxDecimal 3-833 Campos de IfxDouble 3-847 Campos de IfxFactory 3-404 Campos de IfxInt16 3-858 Campos de IfxInt32 3-868 Campos de IfxInt64 3-878 Campos de IfxReal 3-904 Campos de IfxReal370 3-893 Campos de IfxRowId 3-914 Campos de IfxString 3-921 Campos de IfxTime 3-929 Campos de IfxTimeStamp 3-941 Caracteres con comillas dobles 2-2 Caracteres con comillas simples 2-2 Caracteres especiales 1-6 carpeta dotnetdemo 4-1 Cierre de las conexiones 1-4 Clase IfxBulkCopy 3-5 Clase IfxBulkCopyColumnMapping 3-28 Clase IfxBulkCopyColumnMappingCollection Clase IfxClob 3-811 Clase IfxCommand 3-98 Clase IfxCommandBuilder 1-3, 1-5, 3-68 ejemplo de uso 4-4 Clase IfxConnection 3-156 conexin a una base de datos 1-4 creacin visual 1-4 mtodo Open 1-4 Clase IfxConnectionStringBuilder 3-219 Copyright IBM Corp. 2003, 2007
3-46
X-1
Constructor de IfxParameter (String, IfxType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object) 3-430 Constructor de IfxParameter (String, IfxType, Int32, String) 3-428 Constructor de IfxParameter (String, Object) 3-425 Constructor de IfxPermission 3-504 Constructor de IfxPermission () 3-505 Constructor de IfxPermission (PermissionState) 3-506 Constructor de IfxPermissionAttribute 3-498 Constructor de IfxReal 3-907 Constructor de IfxReal370 3-896 Constructor de IfxRowUpdatedEventArgs 3-687 Constructor de IfxRowUpdatingEventArgs 3-693 Constructor de IfxString 3-922 Constructores de IfxBulkCopy 3-7 Constructores de IfxBulkCopyColumnMapping 3-30 Constructores de IfxParameter 2-2 Constructores de IfxTime 3-931 Constructores IfxTimeStamp 3-943 conversin, ejemplo de 4-1 Cursor de slo reenvo 1-3, 4-2
Estructura IfxDate 3-820 Estructura IfxDecimal 3-830 Estructura IfxDouble 3-845 Estructura IfxInt16 3-856 Estructura IfxInt32 3-866 Estructura IfxInt64 3-876 Estructura IfxReal 3-902 Estructura IfxReal370 3-891 Estructura IfxRowId 3-913 Estructura IfxString 3-919 Estructura IfxTime 3-927 Estructura IfxTimeStamp 3-939 Excepciones 1-8
F
Fuente de datos 1-2
I
IBM.Data.Informix 3-1 IBM Data Server Provider for .NET 3-1 IBM Informix .NET Provider espacio de nombres de 1-3 visin general 1-2 IBM Informix ODBC Driver 1-1 IBM Informix OLE DB Provider 1-1 IfxBinary Campo Null 3-805 Mtodo op_explicit 3-807 op_implicit 3-808 ToString 3-809 Propiedad IsNull 3-810 Value 3-810 IfxBulkCopy Constructor IfxBulkCopy(IBM.Data.DB2.IfxConnection) 3-8 IfxBulkCopy(string) 3-11 IfxBulkCopy(string, IBM.Data.DB2.IfxBulkCopyOptions) 3-12 Constructor de IfxBulkCopy(IBM.Data.Informix.IfxConnection, IBM.Data.DB2.IfxBulkCopyOptions) 3-9 Mtodo Close 3-14 Dispose 3-15 WriteToServer 3-16 WriteToServer(System.Data.DataRow[ ]) 3-16 WriteToServer(System.Data.DataTable) 3-17 WriteToServer(System.Data.DataTable, System.Data.DataRowState) 3-18 WriteToServer(System.Data.IDataReader) 3-20 Propiedad BulkCopyTimeout 3-21 ColumnMappings 3-23 DestinationTableName 3-24 Errors 3-25 NotifyAfter 3-26 Suceso IfxRowsCopied 3-27 IfxBulkCopyColumnMapping Constructor IfxBulkCopyColumnMapping() 3-31
D
Datos de slo lectura 1-3, 4-2 Delegado de IfxInfoMessageEventHandler 3-417 Delegado de IfxRowsCopiedEventHandler 3-700 Delegado de IfxRowUpdatedEventHandler 3-690 Delegado de IfxRowUpdatingEventHandler 3-696 DELETE, automtico 1-5 Delimitadores 1-6, 2-2 Direcciones IP Formato IPv6 en sqlhosts 1-2
E
Ejemplos 4-1 conversin de un tipo de datos en un tipo nuevo 4-1 Insercin de filas 4-3 llamada de procedimientos almacenados 4-5 Reconciliacin de los cambios en el DataSet con la base de datos 4-4 Recuperacin de datos en un archivo 4-3 recuperacin de mltiples columnas 4-2 recuperacin de un nico valor 4-1 uso de ExecuteNonQuery 4-3 uso de IfxCommandBuilder 4-4 uso de IfxDataAdapter 4-3 uso de la clase IfxDataReader 4-2 uso de la propiedad IfxCommand.CommandType 4-5 uso de la transaccin local 4-3 uso de las transacciones distribuidas 4-6 uso de System.DataSet 4-3 uso del mtodo ExecuteScalar 4-1 Enumeracin IfxBulkCopyOptions 3-67 Enumeracin IfxCursorType 3-254 Enumeracin IfxResultSetOptions 3-683 Enumeracin IfxType 3-714 Espacio de nombres de IBM Informix .NET Provider 1-3 importacin 1-3 Espacio de nombres IBM.Data.IfxTypes 3-802 Espacio de nombres IBM.Data.Informix 1-3 Especificacin Microsoft .NET vii Estructura IfxBinary 3-803
X-2
IfxBulkCopyColumnMapping (continuacin) Constructor (continuacin) IfxBulkCopyColumnMapping(int, int) 3-33 IfxBulkCopyColumnMapping(int, string) 3-34 IfxBulkCopyColumnMapping(string, int) 3-36 IfxBulkCopyColumnMapping(string, string) 3-37 Propiedad DestinationColumn 3-40 DestinationOrdinal 3-41 SourceColumn 3-43 SourceOrdinal 3-45 IfxBulkCopyColumnMappingCollection Mtodo Add 3-51 Add(IBM.Data.DB2.IfxBulkCopyColumnMapping) 3-52 Add(int, int) 3-53 Add(int, string) 3-55 Add(string, int) 3-56 Add(string, string) 3-58 Clear 3-59 Contains 3-60 CopyTo 3-62 IndexOf 3-63 Insert 3-64 Remove 3-66 RemoveAt 3-65 IfxClob Campo Null 3-813 Mtodo GetChars 3-815 ToString 3-817 Propiedad CacheData 3-818 IsNull 3-819 Value 3-819 IfxCommand Mtodo Cancel 3-112 CreateDbParameter 3-113 CreateParameter 3-114 Dispose 3-115 Dispose (Boolean) 3-115 ExecuteDbDataReader 3-117 ExecuteNonQuery 3-117 ExecutePageReader 3-119 ExecuteReader 3-120 ExecuteReader () 3-121 ExecuteReader (CommandBehavior) 3-123 ExecuteResultSet 3-125 ExecuteResultSet(IBM.Data.DB2.IfxCursorType) 3-125 ExecuteResultSet(IBM.Data.DB2.IfxResultSetOptions) 3-127 ExecuteResultSet(System.Data.CommandBehavior, IBM.Data.DB2.IfxCursorType) 3-128 ExecuteResultSet(System.Data.CommandBehavior, IBM.Data.DB2.IfxCursorType, bool) 3-130 ExecuteResultSet(System.Data.CommandBehavior, IBM.Data.DB2.IfxResultSetOptions) 3-131 ExecuteResultSet(System.Data.CommandBehavior, IBM.Data.DB2.IfxResultSetOptions, bool) 3-133 ExecuteRow 3-135 ExecuteScalar 3-136 Prepare 3-137 ResetCommandTimeout 3-138 Propiedad CommandText 3-141 CommandTimeout 3-143
IfxCommand (continuacin) Propiedad (continuacin) CommandType 3-145 Connection 3-146 DbConnection 3-149 DbParameterCollection 3-149 DbTransaction 3-150 DesignTimeVisible 3-151 IfxTypeOutput 3-148 Parmetros 3-152 Transaction 3-154 UpdatedRowSource 3-155 IfxCommandBuilder Mtodo ApplyParameterInfo 3-77 DeriveParameters 3-78 Dispose 3-80 Dispose (Boolean) 3-81 GetDeleteCommand 3-82 GetInsertCommand 3-83 GetParameterName 3-84 GetParameterName(int) 3-85 GetParameterName(string) 3-86 GetParameterPlaceholder 3-86 GetUpdateCommand 3-87 QuoteIdentifier 3-88 RefreshSchema 3-89 SetRowUpdatingHandler 3-90 UnquoteIdentifier 3-91 Propiedad CatalogLocation 3-92 CatalogSeparator 3-93 DataAdapter 3-94 QuotePrefix 3-95 QuoteSuffix 3-96 SchemaSeparator 3-97 IfxConnection Mtodo BeginChain 3-168 BeginTransaction 3-171 BeginTransaction () 3-173 BeginTransaction (IsolationLevel) 3-175 ChangeDatabase 3-177 Close 3-179 CreateCommand 3-180 Dispose 3-181 Dispose (Boolean) 3-181 DropDTD 3-183 EndChain 3-184 EnlistDistributedTransaction 3-186 GetDTD 3-187 GetSchema 3-187, 3-188 GetSchema (String) 3-189 GetSchema (String, String[]) 3-191 Open 3-193 RegisterDTD 3-195 ReleaseObjectPool 3-195 Propiedad CacheData 3-198 Chaining 3-199 ClientAccountingInformation 3-201 ClientApplicationInformation 3-202 ClientUser 3-202 ClientWorkStation 3-203 ConnectionString 3-203 ConnectionTimeout 3-206 Database 3-209 ndice
X-3
IfxConnection (continuacin) Propiedad (continuacin) DataSource 3-208 ServerBuildVersion 3-210 ServerMajorVersion 3-211 ServerMinorVersion 3-211 ServerRevisionVersion 3-212 ServerType 3-213 ServerVersion 3-214 State 3-215 Suceso InfoMessage 3-217 StateChange 3-218 IfxConnectionStringBuilder Constructor IfxConnectionStringBuilder() 3-223 IfxConnectionStringBuilder(string) 3-224 Graphic Propiedad 3-239 Mtodo Clear 3-227 ContainsKey 3-227 Remove 3-228 ShouldSerialize 3-228 TryGetValue 3-229 Propiedad Authentication 3-232 CLISchema 3-233 Connect_Timeout 3-234 ConnectionLifeTime 3-235 ConnectionReset 3-235 ConvertToLong 3-236 CurrentSchema 3-237 Database 3-237 Enlist 3-238 IsFixedSize 3-240 IsolationLevel 3-240 Keys 3-241 MapDate 3-242 MapTime 3-242 MapTimestamp 3-243 MaxPoolSize 3-244 MinPoolSize 3-244 Password 3-245 PersistSecurityInfo 3-246 Pooling 3-246 QueryTimeout 3-247 SchemaList 3-248 Server 3-248 ServerType 3-249 StaticLatch 3-250 SysSchema 3-251 TableType 3-251 UserID 3-252 Values 3-253 IfxDataAdapter Mtodo CreateRowUpdatedEvent 3-274 CreateRowUpdatingEvent 3-275 OnRowUpdated 3-276 OnRowUpdating 3-277 Propiedad DeleteCommand 3-280 InsertCommand 3-281 SelectCommand 3-283 UpdateBatchSize 3-284 UpdateCommand 3-286
IfxDataAdapter (continuacin) Suceso RowUpdated 3-288 RowUpdating 3-289 IfxDataReader Mtodo Close 3-299 GetBoolean 3-301 GetByte 3-302 GetBytes 3-303 GetChar 3-305 GetChars 3-306 GetDataTypeName 3-328 GetDate 3-329 GetDateTime 3-330 GetDecimal 3-331 GetDouble 3-332 GetEnumerator 3-334 GetFieldType 3-334 GetFloat 3-335 GetGuid 3-336 GetIfxBinary 3-308 GetIfxBlob 3-309 GetIfxClob 3-310 GetIfxDate 3-312 GetIfxDecimal 3-313 GetIfxDouble 3-314 GetIfxInt16 3-315 GetIfxInt32 3-316 GetIfxInt64 3-318 GetIfxReal 3-320 GetIfxReal370 3-319 GetIfxRowId 3-321 GetIfxString 3-322 GetIfxTime 3-324 GetIfxTimeStamp 3-325 GetIfxValue 3-326 GetIfxValues 3-327 GetInt16 3-337 GetInt32 3-339 GetInt64 3-340 GetName 3-341 GetOrdinal 3-342 GetSchemaTable 3-343 GetStream 3-346 GetString 3-347 GetTime 3-349 GetTimeSpan 3-350 GetValue 3-351 GetValues 3-352 IsDBNull 3-353 NextResult 3-354 Read 3-354 Propiedad CacheData 3-357 Depth 3-357 FieldCount 3-358 HasRows 3-359 IsClosed 3-360 RecordsAffected 3-360 this 3-361 this (Int32) 3-362 this (String) 3-362 IfxDataSourceEnumerator Campo Instance 3-366
X-4
IfxDataSourceEnumerator (continuacin) Mtodo GetDataSources 3-367, 3-368 GetDataSources (Boolean) 3-369 IfxDate Campo MaxValue 3-823 MinValue 3-824 Null 3-824 Mtodo op_explicit 3-826 op_implicit 3-827 Parse 3-827 ToString 3-828 Propiedad IsNull 3-829 Value 3-830 IfxDecimal Campo MaxPrecision 3-833 MaxScale 3-834 MaxValue 3-834 MinValue 3-835 Null 3-836 Constructor IfxDecimal(decimal) 3-836 Mtodo op_explicit 3-838 op_implicit 3-839 Parse 3-839 ToString 3-840 Propiedad IsNull 3-841 Precision 3-842 Scale 3-843 Value 3-844 ValueApproximate 3-843 IfxDouble Campo MaxValue 3-848 MinValue 3-848 Null 3-849 Zero 3-850 Mtodo op_explicit 3-851 op_implicit 3-852 Parse 3-853 ToString 3-853 Propiedad IsNull 3-854 Value 3-855 IfxError Mtodo ToString 3-375 Propiedad Message 3-377 NativeError 3-378 RowNumber 3-379 Source 3-383 SQLState 3-382 IfxErrorCollection Mtodo CopyTo 3-387 GetEnumerator 3-389 Propiedad Count 3-390 Item 3-391
IfxException Mtodo GetObjectData 3-397 Propiedad Errors 3-398 Message 3-400 Source 3-401 IfxFactory Campo Instance 3-404 Mtodo CreateCommand 3-407 CreateCommandBuilder 3-406 CreateConnection 3-407 CreateConnectionStringBuilder 3-408 CreateDataAdapter 3-409 CreateDataSourceEnumerator 3-410 CreateParameter 3-411 CreatePermission (System.Security.Permissions.PermissionState) Propiedad CanCreateDataSourceEnumerator 3-414 IfxInfoMessageEventArgs Propiedad Errors 3-417 IfxInt16 Campo MaxValue 3-858 MinValue 3-859 Null 3-859 Zero 3-860 Mtodo op_explicit 3-862 op_implicit 3-862 Parse 3-863 ToString 3-864 Propiedad IsNull 3-865 Value 3-866 IfxInt32 Campo MaxValue 3-869 MinValue 3-869 Null 3-870 Zero 3-870 Mtodo op_explicit 3-872 op_implicit 3-873 Parse 3-873 ToString 3-874 Propiedad IsNull 3-875 Value 3-876 IfxInt64 Campo MaxValue 3-879 MinValue 3-879 Null 3-880 Zero 3-881 Mtodo op_explicit 3-882 op_implicit 3-883 Parse 3-884 ToString 3-884 Propiedad IsNull 3-885 Value 3-886 ndice
3-412
X-5
IfxParameter Mtodo ICloneable.Clone 3-433 ResetDbType 3-434 ToString 3-435 Propiedad DbType 3-438 Direction 3-440 IfxType 3-437 IfxTypeOutput 3-436 IsNullable 3-441 ParameterName 3-442 Precision 3-444 Scale 3-445 Size 3-447 SourceColumn 3-449 SourceColumnNullMapping 3-448 SourceVersion 3-450 Value 3-452 IfxParameterCollection Mtodo Add 3-459 Add (IfxParameter) 3-461 Add (Object) 3-460 Add (String, IfxType) 3-463 Add (String, IfxType, Int32) 3-465 Add (String, IfxType, Int32, String) 3-466 Add (String, Object) 3-462 AddRange 3-468 Clear 3-469 Contains 3-470 Contains (Object) 3-471 Contains (String) 3-473 CopyTo 3-474 GetEnumerator 3-475 GetParameter 3-476 GetParameter(int) 3-477 GetParameter(string) 3-477 Insert 3-478 Remove 3-483 RemoveAt 3-479 RemoveAt (Int32) 3-480 RemoveAt (String) 3-482 SetParameter 3-484 SetParameter(int, System.Data.Common.DbParameter) 3-485 SetParameter(string, System.Data.Common.DbParameter) 3-485 Propiedad Count 3-487 IsFixedSize 3-488 IsReadOnly 3-488 IsSynchronized 3-489 SyncRoot 3-490 this 3-491 this (Int32) 3-493 This (String) 3-492 IfxPermission Mtodo Add 3-508 IfxPermissionAttribute Mtodo CreatePermission 3-500 IfxReal Campo MaxValue 3-905 MinValue 3-905
IfxReal (continuacin) Campo (continuacin) Null 3-906 Zero 3-907 Mtodo op_explicit 3-908, 3-934 op_implicit 3-909 Parse 3-910 ToString 3-910 Propiedad IsNull 3-911 Value 3-912 IfxReal370 Campo MaxValue 3-894 MinValue 3-894 Null 3-895 Zero 3-896 Mtodo op_explicit 3-898 op_implicit 3-898 Parse 3-899 ToString 3-900 Propiedad IsNull 3-901 Value 3-901 IfxRecord Mtodo Dispose 3-515 GetBoolean 3-516 GetByte 3-516 GetBytes 3-517 GetChar 3-519 GetChars 3-521 GetDataTypeName 3-539 GetDate 3-540 GetDateTime 3-541 GetDecimal 3-542 GetDouble 3-543 GetFieldType 3-545 GetFloat 3-545 GetGuid 3-547 GetIfxBinary 3-522 GetIfxBlob 3-523 GetIfxClob 3-525 GetIfxDate 3-526 GetIfxDecimal 3-527 GetIfxDouble 3-528 GetIfxInt16 3-529 GetIfxInt32 3-530 GetIfxInt64 3-531 GetIfxReal 3-534 GetIfxReal370 3-532 GetIfxRowId 3-535 GetIfxString 3-536 GetIfxTime 3-537 GetIfxTimeStamp 3-538 GetInt16 3-548 GetInt32 3-549 GetInt64 3-550 GetName 3-551 GetOrdinal 3-552 GetString 3-553 GetTime 3-554 GetTimeSpan 3-555 GetValue 3-556, 3-557 GetValues 3-558, 3-559
X-6
IfxRecord (continuacin) Mtodo (continuacin) IsDBNull 3-560 Propiedad FieldCount 3-561 this 3-562 this (Int32) 3-562 this (String) 3-563 IfxResultSet Mtodo Close 3-574 CreateRecord 3-575 Delete 3-576 Dispose 3-578 GetBoolean 3-578 GetByte 3-579 GetBytes 3-580 GetChar 3-582 GetChars 3-583 GetDataTypeName 3-604 GetDate 3-605 GetDateTime 3-606 GetDecimal 3-608 GetDouble 3-609 GetFieldType 3-610 GetFloat 3-611 GetGuid 3-612 GetIfxBinary 3-585 GetIfxBlob 3-586 GetIfxClob 3-588 GetIfxDate 3-589 GetIfxDecimal 3-590 GetIfxDouble 3-591 GetIfxInt16 3-592 GetIfxInt32 3-593 GetIfxInt64 3-595 GetIfxReal 3-597 GetIfxReal370 3-596 GetIfxRowId 3-598 GetIfxString 3-599 GetIfxTime 3-600 GetIfxTimeStamp 3-601 GetIfxValue 3-603 GetIfxValues 3-604 GetInt16 3-613 GetInt32 3-614 GetInt64 3-615 GetName 3-617 GetOrdinal 3-617 GetSchemaTable 3-618 GetString 3-621 GetTime 3-623 GetTimeSpan 3-624 GetValue 3-625 GetValues 3-626 Insert 3-627 IsDBNull 3-628 IsSetAsDefault 3-629 NextResult 3-630 Read 3-634 ReadAbsolute 3-630 ReadFirst 3-632 ReadLast 3-633 ReadPrevious 3-636 ReadRelative 3-637 SetBoolean 3-638 SetByte 3-639
IfxResultSet (continuacin) Mtodo (continuacin) SetBytes 3-640 SetChar 3-641 SetChars 3-642 SetDate 3-653 SetDateTime 3-654 SetDecimal 3-655 SetDefault 3-656 SetDouble 3-657 SetFloat 3-658 SetGuid 3-659 SetIfxBinary 3-643 SetIfxDate 3-644 SetIfxDecimal 3-645 SetIfxDouble 3-645 SetIfxInt16 3-646 SetIfxInt32 3-647 SetIfxInt64 3-648 SetIfxReal 3-650 SetIfxReal370 3-649 SetIfxString 3-651 SetIfxTime 3-652 SetIfxTimeStamp 3-652 SetInt16 3-659 SetInt32 3-660 SetInt64 3-661 SetNull 3-662 SetString 3-663 SetTime 3-664 SetTimeSpan 3-665 SetValue 3-666 SetValues 3-666 Update 3-667 Propiedad CacheData 3-670 CursorType 3-670 Depth 3-672 FieldCount 3-672 HasRows 3-673 IsClosed 3-674 IsDeleted 3-674 RecordsAffected 3-675 Scrollable 3-676 Sensitive 3-677 SkipDeleted 3-679 this 3-680 this (Int32) 3-681 Updatable 3-681 IfxResultSetDataReader Propiedad this (String) 3-681 IfxRowId Campo Null 3-915 Mtodo op_explicit 3-916 ToString 3-916 Propiedad IsNull 3-918 Value 3-918 IfxRowsCopiedEventArgs Propiedad Abort 3-699 RowsCopied 3-699
ndice
X-7
IfxRowUpdatedEventArgs Propiedad Command 3-689 IfxErrors 3-689 IfxRowUpdatingEventArgs Propiedad Command 3-695 IfxString Campo Null 3-921 Mtodo op_explicit 3-923 op_implicit 3-924 ToString 3-924 Propiedad IsNull 3-925 Value 3-926 IfxTime Campo MaxValue 3-929 MinValue 3-930 Null 3-930 Constructor IfxTime() 3-931 IfxTime(string) 3-933 IfxTime(TimeSpan) 3-932 Mtodo op_implicit 3-934 Parse 3-935 ToString 3-936 Propiedad IsNull 3-937 TimeSpanValue 3-937 Value 3-938 IfxTimeStamp Campo MaxValue 3-941 MinValue 3-942 Null 3-942 Constructor IfxTimeStamp(DateTime) 3-945 IfxTimeStamp(int, int, int, int, int, int, int) Mtodo op_explicit 3-946 op_implicit 3-946 Parse 3-947 ToString 3-948 Propiedad IsNull 3-949 Value 3-950 IfxTransaction Mtodo Commit 3-706 Dispose 3-708 Rollback 3-709 Propiedad Connection 3-712 DbConnection 3-713 IsolationLevel 3-713 IfxUpdatableRecord Mtodo Dispose 3-726 GetBoolean 3-726 GetByte 3-727 GetBytes 3-728 GetChar 3-730 GetChars 3-731
3-944
IfxUpdatableRecord (continuacin) Mtodo (continuacin) GetDataTypeName 3-752 GetDate 3-752 GetDateTime 3-754 GetDecimal 3-755 GetDouble 3-756 GetFieldType 3-757 GetFloat 3-758 GetGuid 3-759 GetIfxBinary 3-733 GetIfxBlob 3-734 GetIfxClob 3-735 GetIfxDate 3-737 GetIfxDecimal 3-738 GetIfxDouble 3-739 GetIfxInt16 3-740 GetIfxInt32 3-741 GetIfxInt64 3-742 GetIfxReal 3-744 GetIfxReal370 3-743 GetIfxRowId 3-746 GetIfxString 3-747 GetIfxTime 3-748 GetIfxTimeStamp 3-749 GetIfxValue 3-750 GetIfxValues 3-751 GetInt16 3-760 GetInt32 3-761 GetInt64 3-762 GetName 3-763 GetOrdinal 3-764 GetString 3-765 GetTime 3-767 GetTimeSpan 3-768 GetValue 3-769 GetValues 3-769 IsDBNull 3-770 IsSetAsDefault 3-771 SetBoolean 3-772 SetByte 3-773 SetBytes 3-774 SetChar 3-775 SetChars 3-775 SetDate 3-786 SetDateTime 3-787 SetDecimal 3-788 SetDefault 3-789 SetDouble 3-790 SetFloat 3-790 SetGuid 3-791 SetIfxBinary 3-776 SetIfxDate 3-777 SetIfxDecimal 3-778 SetIfxDouble 3-779 SetIfxInt16 3-780 SetIfxInt32 3-780 SetIfxInt64 3-781 SetIfxReal 3-783 SetIfxReal370 3-782 SetIfxString 3-784 SetIfxTime 3-785 SetIfxTimeStamp 3-785 SetInt16 3-792 SetInt32 3-793 SetInt64 3-794 SetNull 3-795
X-8
IfxUpdatableRecord (continuacin) Mtodo (continuacin) SetString 3-795 SetTime 3-796 SetTimeSpan 3-797 SetValue 3-798 SetValues 3-799 Propiedad FieldCount 3-800 this 3-801 this (Int32) 3-801 this (String) 3-802 Importacin de un espacio de nombres 1-3 Independencia del proveedor 1-3 Informix ODBC Driver 1-1 Informix OLE DB Provider 1-1 Insercin de filas, ejemplo de 4-3 INSERT, automtico 1-5 INSERT, DELETE y UPDATE automticos 1-5 Instalacin IBM Informix .NET Provider Add-in for Microsoft Visual Studio 1-2 Interfaces pblicas, objetos 1-2 Interfaz DataColumn 1-2 Interfaz DataRelation 1-2 Interfaz DataTable 1-2 Internet protocol version 6 (IPv6) 1-2 IPv6. Vase Internet protocol version 6.
L
Literales de serie 2-2 Literales de serie anidados 2-2 Llamada de procedimientos almacenados ejemplo de 4-5
M
Matrices 1-7 Matrices de parmetros 1-7 Mensajes de error 1-8 Mtodo DeriveParameters 1-7 Mtodo Dispose 1-5 Mtodo ExecuteNonQuery ejemplo de uso 4-3 Mtodo ExecuteNonQuery() 4-3 Mtodo ExecuteScalar, ejemplo de uso 4-1 Mtodo GetDeleteCommand 1-5 Mtodo GetInsertCommand 1-5 Mtodo GetString() 2-2 Mtodo GetUpdateCommand 1-5 Mtodo IfxCommand.ExecuteNonQuery() 4-3 Mtodo IfxDataReader.GetString() 2-2 Mtodo ParameterCollection.Add 1-6 Mtodo RefreshSchema 1-5 Mtodos de IfxBinary 3-807 Mtodos de IfxBulkCopy 3-13 Mtodos de IfxBulkCopyColumnMapping 3-39 Mtodos de IfxBulkCopyColumnMappingCollection Mtodos de IfxClob 3-814 Mtodos de IfxCommand 3-110 Mtodos de IfxCommandBuilder 3-76 Mtodos de IfxConnection 3-166 Mtodos de IfxConnectionStringBuilder 3-226 Mtodos de IfxDataAdapter 3-271
3-50
Mtodos de IfxDataReader 3-296 Mtodos de IfxDataSourceEnumerator 3-366 Mtodos de IfxDate 3-825 Mtodos de IfxDecimal 3-837 Mtodos de IfxDouble 3-851 Mtodos de IfxError 3-374 Mtodos de IfxErrorCollection 3-387 Mtodos de IfxException 3-396 Mtodos de IfxFactory 3-405 Mtodos de IfxInt16 3-861 Mtodos de IfxInt32 3-872 Mtodos de IfxInt64 3-882 Mtodos de IfxParameter 3-432 Mtodos de IfxParameterCollection 3-457 Mtodos de IfxPermission 3-507 Mtodos de IfxPermissionAttribute 3-499 Mtodos de IfxReal 3-908 Mtodos de IfxReal370 3-897 Mtodos de IfxRecord 3-513 Mtodos de IfxResultSet 3-569 Mtodos de IfxRowId 3-915 Mtodos de IfxString 3-922 Mtodos de IfxTime 3-933 Mtodos de IfxTimeStamp 3-945 Mtodos de IfxTransaction 3-705 Mtodos de IfxUpdatableRecord 3-722 Microsoft ODBC .NET 1-1 Microsoft OLE DB .NET 1-1 Miembros de IfxBinary 3-804 miembros de IfxBulkCopy 3-6 Miembros de IfxBulkCopyColumnMapping 3-29 Miembros de IfxBulkCopyColumnMappingCollection Miembros de IfxClob 3-812 Miembros de IfxCommand 3-101 Miembros de IfxCommandBuilder 3-71 Miembros de IfxConnectionStringBuilder 3-220 Miembros de IfxDataReader 3-293 Miembros de IfxDataSourceEnumerator 3-365 Miembros de IfxDate 3-822 Miembros de IfxDecimal 3-831 Miembros de IfxDouble 3-846 Miembros de IfxError 3-373 Miembros de IfxErrorCollection 3-385 Miembros de IfxException 3-394 Miembros de IfxFactory 3-403 Miembros de IfxFormatException 3-890 Miembros de IfxInfoMessageEventArgs 3-416 Miembros de IfxInt16 3-857 Miembros de IfxInt32 3-867 Miembros de IfxInt64 3-877 Miembros de IfxNullValueException 3-888 Miembros de IfxParameter 3-420 Miembros de IfxParameterCollection 3-456 Miembros de IfxPermission 3-502 Miembros de IfxPermissionAttribute 3-497 Miembros de IfxReal 3-903 Miembros de IfxReal370 3-892 Miembros de IfxRecord 3-511 Miembros de IfxRowId 3-914 Miembros de IfxRowsCopiedEventArgs 3-698 Miembros de IfxRowUpdatedEventArgs 3-685 Miembros de IfxRowUpdatingEventArgs 3-692 Miembros de IfxString 3-920 Miembros de IfxTime 3-928 Miembros de IfxTimeStamp 3-940 Miembros de IfxTransaction 3-704 Miembros de IfxTruncateException 3-951 ndice
3-48
X-9
Miembros de IfxTypeException 3-954 minusvala fsica A-1 Mdulo adicional de Microsoft Visual Studio Instalacin 1-2
N
Nombres de sistema principal uso en sqlhosts 1-2
O
Objeto DataReader 1-3 Objeto DataSet 1-2, 2-1 ejemplo de uso 4-3 Objeto IfxConnection Propiedad Close uso de 1-4 Propiedad ConnectionString definicin visual 1-4 uso de 1-4 ODBC .NET 1-1 ODBC Driver 1-1 OLE DB .NET 1-1 OLE DB Provider 1-1 Operadores JOIN 1-6
P
Parmetro MAX ROWS 1-2 Parmetros de entrada 1-7 Parmetros de salida 1-6 Permiso FullTrust 1-6 Plataformas 1-1 Procedimientos almacenados 1-7, 4-5 Programa de utilidad Setnet 1-4 Programas de demostracin 4-1 Programas de ejemplo 4-1 Propiedad Close de IfxConnection uso de 1-4 Propiedad CommandText 1-7 Propiedad CommandTimeout 1-5 Propiedad CommandType 1-7 de la clase IfxCommand ejemplo de uso 4-5 Propiedad Connection 1-5 Propiedad ConnectionString de IfxConnection uso de 1-4 Propiedad ConnectionString de IfxConnection definicin visual 1-4 Propiedad DeleteCommand 1-5 Propiedad InsertCommand 1-5 Propiedad QuotePrefix 1-6 Propiedad QuoteSuffix 1-6 Propiedad SelectCommand 1-5 Propiedad Transaction 1-5 Propiedad UpdateCommand 1-5 Propiedades de IfxBinary 3-809 Propiedades de IfxBulkCopy 3-21 Propiedades de IfxBulkCopyColumnMapping 3-39 Propiedades de IfxClob 3-818 Propiedades de IfxCommand 3-140 Propiedades de IfxCommandBuilder 3-91 Propiedades de IfxConnection 3-196
Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades Propiedades
de de de de de de de de de de de de de de de de de de de de de de de de de de de de de
IfxConnectionStringBuilder 3-230 IfxDataAdapter 3-278 IfxDataReader 3-356 IfxDate 3-829 IfxDecimal 3-841 IfxDouble 3-854 IfxError 3-376 IfxErrorCollection 3-389 IfxException 3-398 IfxFactory 3-413 IfxInfoMessageEventArgs 3-417 IfxInt16 3-864 IfxInt32 3-875 IfxInt64 3-885 IfxParameter 3-435 IfxParameterCollection 3-486 IfxReal 3-911 IfxReal370 3-900 IfxRecord 3-561 IfxResultSet 3-669 IfxRowId 3-917 IfxRowsCopiedEventArgs 3-698 IfxRowUpdatedEventArgs 3-688 IfxRowUpdatingEventArgs 3-694 IfxString 3-925 IfxTime 3-936 IfxTimeStamp 3-949 IfxTransaction 3-712 IfxUpdatableRecord 3-800
R
Rastreo 1-8 Reconciliacin de los datos modificados 1-3, 1-5, 4-4 Recuperacin de datos 4-2 Recuperacin de datos en un archivo ejemplo de 4-3 Recuperacin de mltiples columnas ejemplo de 4-2 Recuperacin de un nico valor, ejemplo de 4-1 Registro 1-4 Relaciones 1-2
S
script cdotnet.sql 1-2 Seguridad de las hebras del proveedor 1-3 Sentencias SELECT 1-2 Sentencias SQL eficientes 1-5 Serie de conexin 1-4 definicin visual 1-4 Smbolos de retencin de posicin 1-6 SQL dinmico 1-6 sqlhosts Direcciones IP IPv6 en 1-2 uso de nombres de sistema principal en 1-2 Sucesos de IfxBulkCopy 3-27 Sucesos de IfxConnection 3-217 Sucesos de IfxDataAdapter 3-287
T
teclas de atajo teclado A-1 Tipo AnsiString 2-2 Tipo BLOB 2-1
X-10
Tipo BOOLEAN 2-1 Tipo BYTE 2-1 Tipo CHAR 2-1 Tipo CHAR(1) 2-1 Tipo CLOB 2-1 Tipo COLLECTION 2-2 Tipo DATE 2-1 Tipo DATETIME 2-1 Tipo DECIMAL 2-1 Tipo DOUBLE 2-1 Tipo FLOAT 2-1 Tipo GUID 2-2 Tipo IDSSECURITYLABEL 2-1 Tipo Int32 2-1 Tipo Int64 2-2 Tipo Int64[] 2-1 Tipo INT8 2-2 Tipo INTEGER 2-1 Tipo INTERVAL 2-2 Tipo LIST 2-2 Tipo LVARCHAR 2-2 Tipo MONEY 2-2 Tipo MULTISET 2-2 Tipo NCHAR 2-2 Tipo REAL 2-2 Tipo SERIAL 2-2 Tipo SET 2-2 Tipo SMALLFLOAT 2-2 Tipo String 2-1 Tipo TEXT 2-2 Tipo VARCHAR 2-2 Tipos .NET DbType 2-2 Tipos de parmetro 2-2 Transacciones distribuidas 1-7, 4-6 locales ejemplo de uso 4-3 Transacciones distribuidas 4-6 ejemplo de uso 4-6 Transacciones locales ejemplo de uso 4-3
U
UPDATE, automtico 1-5
V
Variable de entorno DELIMIDENT 1-4 valor por omisin de 1-4 Variable de entorno IFXDOTNETTRACE 1-8 Variable de entorno IFXDOTNETTRACEFILE 1-9 Variable de entorno OPTOFC 1-4 Visual BASIC .NET 1-1 Visual C# .NET 1-1 Visual J# .NET 1-1
ndice
X-11
X-12
SC11-3674-00
Spine information:
IBM
Versin 9.5

Informix Vbnet Drivers 9

Cargado por

Información del documento

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Informix Vbnet Drivers 9

Cargado por

Copyright:

Formatos disponibles

IBM

Data Server Provider for .NET para Informix Dynamic Server

Data Server Provider for .NET para Informix Dynamic Server

Captulo 2. Correlacin de tipos de datos . . . . . . . . . . . . . . . . . . . . 2-1

Captulo 3. IBM Data Server Provider for .NET . . . . . . . . . . . . . . . . . . 3-1

Captulo 4. Programas de ejemplo

Apndice. Accesibilidad . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Acerca de este manual

Copyright IBM Corp. 2003, 2007

monoespaciado PULSACIN >

Sealizacin para funciones, productos y plataformas

Convenios para cdigo de ejemplo

... COMMIT WORK DISCONNECT CURRENT

Cumplimiento de los estndares industriales

IBM agradece sus comentarios

Qu es el IBM Data Server Provider for.NET?

Entornos de programacin soportados

Soporte al acceso a datos con Visual Studio

Soporte para IPv6

Preparacin del servidor de la base de datos

Seguridad de las hebras de los tipos de proveedor

Requisitos de los espacios de nombres

Conexin a una base de datos

Modalidades de base de datos con .NET

Reconciliacin de los cambios de DataSet con la base de datos

Establecimiento del permiso FullTrust

Utilizacin de marcadores de parmetro ?

Llamada de los procedimientos almacenados

Uso de las transacciones distribuidas

Codificacin genrica con ADO.NET Common Base Classes

Migracin desde IBM Informix .NET Provider

Captulo 2. Correlacin de tipos de datos

Copyright IBM Corp. 2003, 2007

Establecimiento de los tipos de datos de los parmetros

Formato de visualizacin de los tipos de datos FLOAT, DECIMAL o MONEY

Captulo 2. Correlacin de tipos de datos

Captulo 3. IBM Data Server Provider for .NET

Espacio de nombres IBM.Data.Informix

Desarrollo de aplicaciones en IBM Data Server Provider for .NET

v IfxCommand v IfxConnection v IfxDataReader

IfxDataReader IfxDataSourceEnumerator IfxError

Captulo 3. IBM Data Server Provider for .NET

Clase IfxPermissionAttribute IfxRecord IfxResultSet

Captulo 3. IBM Data Server Provider for .NET

IfxBulkCopy(IBM.Data.DB2.IfxConnection, IBM.Data.DB2.IfxBulkCopyOptions) IfxBulkCopy(string)

Captulo 3. IBM Data Server Provider for .NET

); [JScript] public function IfxBulkCopy( connection : IfxConnection, options : IfxBulkCopyOptions );

Captulo 3. IBM Data Server Provider for .NET

Captulo 3. IBM Data Server Provider for .NET

salesCopy.Close(); } catch (Exception ex) { MessageBox.Show(ex.ToString(), "Exception"); } }

Captulo 3. IBM Data Server Provider for .NET

Captulo 3. IBM Data Server Provider for .NET

Captulo 3. IBM Data Server Provider for .NET

Conjunto: IBM.Data.Informix (en IBM.Data.Informix.dll) Sintaxis

salesCopy.WriteToServer(reader); salesCopy.Close(); } catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }

Captulo 3. IBM Data Server Provider for .NET

Captulo 3. IBM Data Server Provider for .NET

Captulo 3. IBM Data Server Provider for .NET

colMapDeptNum.DestinationColumn colMapDeptNme.DestinationColumn colMapDeptMgr.DestinationColumn colMapDeptLoc.DestinationColumn colMapDeptNum.SourceColumn colMapDeptNme.SourceColumn colMapDeptMgr.SourceColumn colMapDeptLoc.SourceColumn = = = =

"DEPTNO"; "DEPTNAME"; "ADMRDEPT"; "LOCATION";

"DEPTNUMB"; "DEPTNAME"; "MANAGER"; "LOCATION";

salesCopy.ColumnMappings.Add(colMapDeptNum); salesCopy.ColumnMappings.Add(colMapDeptNme); salesCopy.ColumnMappings.Add(colMapDeptMgr); salesCopy.ColumnMappings.Add(colMapDeptLoc); try { salesCopy.WriteToServer(reader);

salesCopy.Close(); } catch (IfxException ex) { MessageBox.Show(ex.ToString(), "Exception"); } }

Captulo 3. IBM Data Server Provider for .NET