Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

IDataRecord (Interfaz)

Proporciona acceso a los valores de columna de cada fila para un DataReader. La implementan los proveedores de datos de .NET Framework que tienen acceso a bases de datos relacionales.

Espacio de nombres:  System.Data
Ensamblado:  System.Data (en System.Data.dll)

public interface IDataRecord

El tipo IDataRecord expone los siguientes miembros.

  NombreDescripción
Propiedad públicaCompatible con XNA FrameworkFieldCountObtiene el número de columnas de la fila actual.
Propiedad públicaCompatible con XNA FrameworkItem[Int32]Obtiene la columna situada en el índice especificado.
Propiedad públicaCompatible con XNA FrameworkItem[String]Obtiene la columna con el nombre especificado.
Arriba

  NombreDescripción
Método públicoCompatible con XNA FrameworkGetBooleanObtiene el valor de la columna especificada como tipo Boolean.
Método públicoCompatible con XNA FrameworkGetByteObtiene el valor entero de 8 bits sin signo de la columna especificada.
Método públicoCompatible con XNA FrameworkGetBytesLee una secuencia de bytes del desplazamiento de la columna especificada en el búfer como matriz, comenzando en el desplazamiento de búfer dado.
Método públicoCompatible con XNA FrameworkGetCharObtiene el valor de carácter de la columna especificada.
Método públicoCompatible con XNA FrameworkGetCharsLee una secuencia de caracteres del desplazamiento de la columna especificada en el búfer como matriz, comenzando en el desplazamiento de búfer dado.
Método públicoCompatible con XNA FrameworkGetDataDevuelve una interfaz IDataReader para el índice de columna especificado.
Método públicoCompatible con XNA FrameworkGetDataTypeNameObtiene la información de tipo de datos para el campo especificado.
Método públicoCompatible con XNA FrameworkGetDateTimeObtiene el valor de los datos de fecha y hora del campo especificado.
Método públicoCompatible con XNA FrameworkGetDecimalObtiene el valor numérico de posición fija del campo especificado.
Método públicoCompatible con XNA FrameworkGetDoubleObtiene el número de punto flotante de precisión doble del campo especificado.
Método públicoCompatible con XNA FrameworkGetFieldTypeObtiene la información de Type correspondiente al tipo de Object que se devolverá desde GetValue.
Método públicoCompatible con XNA FrameworkGetFloatObtiene el número de punto flotante de precisión sencilla del campo especificado.
Método públicoCompatible con XNA FrameworkGetGuidDevuelve el valor GUID del campo especificado.
Método públicoCompatible con XNA FrameworkGetInt16Obtiene el valor entero de 16 bits con signo del campo especificado.
Método públicoCompatible con XNA FrameworkGetInt32Obtiene el valor entero de 32 bits con signo del campo especificado.
Método públicoCompatible con XNA FrameworkGetInt64Obtiene el valor entero de 64 bits con signo del campo especificado.
Método públicoCompatible con XNA FrameworkGetNameObtiene el nombre del campo que se va a buscar.
Método públicoCompatible con XNA FrameworkGetOrdinalDevuelve el índice del campo con nombre.
Método públicoCompatible con XNA FrameworkGetStringObtiene el valor de cadena del campo especificado.
Método públicoCompatible con XNA FrameworkGetValueDevuelve el valor del campo especificado.
Método públicoCompatible con XNA FrameworkGetValuesRellena una matriz de objetos con los valores de columna del registro actual.
Método públicoCompatible con XNA FrameworkIsDBNullDevuelve si el campo especificado se establece en un valor nulo.
Arriba

Las interfaces IDataReader y IDataRecord permiten que una clase heredera implemente una clase DataReader. Esto proporciona una manera de leer una o varias secuencias de tipo sólo hacia delante de los conjuntos de resultados. Para obtener más información sobre las clases DataReader, vea Recuperar datos mediante DataReader.

Una aplicación no crea una instancia de la interfaz IDataRecord directamente, sino que crea una instancia de una clase que hereda de IDataRecord. Normalmente, esto se realiza obteniendo un objeto DataReader mediante el método ExecuteReader del objeto Command.

Las clases que heredan IDataRecord deben implementar todos los miembros heredados y suelen definir miembros adicionales para agregar la funcionalidad específica de proveedor.

Los proveedores que implementan un objeto DataReader son necesarios para exponer datos en tipos de Common Language Runtime (CLR). La conversión de tipos se define para algunos tipos no incluidos en CLR. Se puede obtener acceso a estos valores como tipos alternativos que siguen los tipos CLR. Como ejemplo, en la tabla siguiente se enumeran asignaciones sugeridas de tipos de datos OLE DB a tipos CLR, con tipos alternativos entre paréntesis.

Tipo OLE DB

Tipo de CLR

DBTYPE_BOOL

Int16

DBTYPE_BSTR

string

DBTYPE_BYTES

byte[]

DBTYPE_CY

Decimal

DBTYPE_DATE

DateTime

DBTYPE_DBDATE

DateTime

DBTYPE_DBTIME

DateTime

DBTYPE_DBTIMESTAMP

DateTime

DBTYPE_DECIMAL

Decimal

DBTYPE_EMPTY

null

DBTYPE_ERROR

ExternalException

DBTYPE_FILETIME

DateTime

DBTYPE_GUID

Guid

DBTYPE_HCHAPTER

no admitido

DBTYPE_I1

SByte

DBTYPE_I2

Int16

DBTYPE_I4

Int32

DBTYPE_I8

Int64

DBTYPE_IDISPATCH

object

DBTYPE_IUNKNOWN

object

DBTYPE_NULL

DBNull.Value

DBTYPE_NUMERIC

Decimal

DBTYPE_PROPVARIANT

object

DBTYPE_R4

Single

DBTYPE_R8

Double

DBTYPE_STR

string

DBTYPE_UDT

no admitido

DBTYPE_UI1

byte (Int16)

DBTYPE_UI2

UInt16 (Int32)

DBTYPE_UI4

UInt32 (Int64)

DBTYPE_UI8

UInt64 (Decimal)

DBTYPE_VARIANT

object

DBTYPE_VARNUMERIC

no admitido

DBTYPE_WSTR

string

En el ejemplo siguiente se crean instancias de las clases derivadas SqlConnection, SqlCommand y SqlDataReader. En el ejemplo se leen los datos y se escriben en la consola. Por último, en el ejemplo se cierra el objeto SqlDataReader y, a continuación, el objeto SqlConnection.


using System;
using System.Data;
using System.Data.SqlClient;


class Program
{
    static void Main()
    {
        string str = "Data Source=(local);Initial Catalog=Northwind;"
            + "Integrated Security=SSPI";
        ReadOrderData(str);
    }

    private static void ReadOrderData(string connectionString)
    {
        string queryString =
            "SELECT OrderID, CustomerID FROM dbo.Orders;";

        using (SqlConnection connection =
                   new SqlConnection(connectionString))
        {
            SqlCommand command =
                new SqlCommand(queryString, connection);
            connection.Open();

            SqlDataReader reader = command.ExecuteReader();

            // Call Read before accessing data.
            while (reader.Read())
            {
                ReadSingleRow((IDataRecord)reader);
            }

            // Call Close when done reading.
            reader.Close();
        }
    }

    private static void ReadSingleRow(IDataRecord record)
    {
        Console.WriteLine(String.Format("{0}, {1}", record[0], record[1]));
    }

}


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft