DataTableReader.Item[] Propiedad

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Obtiene el valor de la columna especificada en su formato nativo.

Sobrecargas

Item[Int32]	Obtiene el valor de la columna especificada en su formato nativo si se da el índice de columna.
Item[String]	Obtiene el valor de la columna especificada en su formato nativo si se da el nombre de la columna.

Item[Int32]

Source:

DataTableReader.cs

Obtiene el valor de la columna especificada en su formato nativo si se da el índice de columna.

public:
 virtual property System::Object ^ default[int] { System::Object ^ get(int ordinal); };

public override object this[int ordinal] { get; }

member this.Item(int) : obj

Default Public Overrides ReadOnly Property Item(ordinal As Integer) As Object

Parámetros

ordinal

Int32

Índice de la columna de base cero.

Valor de propiedad

Object

Valor de la columna especificada en su formato nativo.

Excepciones

IndexOutOfRangeException

El índice que se ha pasado se encontraba fuera del intervalo entre 0 y FieldCount - 1.

Ejemplos

En el ejemplo siguiente se muestra el contenido de todas las columnas, en todas las filas de la clase proporcionada DataTableReader. El código usa el Item[] método (el indexador, en Microsoft C#) para recuperar el valor contenido en cada columna.

private static void DisplayItems(DataTableReader reader)
{
    int rowNumber = 0;
    while (reader.Read())
    {
        Console.WriteLine("Row " + rowNumber);
        for (int i = 0; i < reader.FieldCount; i++)
        {
            Console.WriteLine("{0}: {1}", reader.GetName(i), reader[i]);
        }
        rowNumber++;
    }
}

Private Sub DisplayItems(ByVal reader As DataTableReader)
   Dim rowNumber As Integer
   While reader.Read()
      Console.WriteLine("Row " & rowNumber)
      For i As Integer = 0 To reader.FieldCount - 1
         Console.WriteLine("{0}: {1}", reader.GetName(i), reader.Item(i))
      Next
      rowNumber += 1
   End While
End Sub

Comentarios

Esta sobrecarga para Item[] se comporta de forma idéntica al GetValue método .

Consulte también

• GetValue(Int32)

Item[String]

Source:

DataTableReader.cs

Obtiene el valor de la columna especificada en su formato nativo si se da el nombre de la columna.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ name); };

public override object this[string name] { get; }

member this.Item(string) : obj

Default Public Overrides ReadOnly Property Item(name As String) As Object

Parámetros

name

String

El nombre de la columna.

Valor de propiedad

Object

Valor de la columna especificada en su formato nativo.

Excepciones

ArgumentException

El nombre especificado no es un nombre de columna válido.

DeletedRowInaccessibleException

Se ha intentado recuperar los datos de una fila eliminada.

InvalidOperationException

Se ha intentado la lectura o el acceso a una columna en un objeto DataTableReader cerrado.

Ejemplos

Dado un DataTableReader nombre de columna y , el procedimiento GetValueByName devuelve el valor de la columna especificada. Antes de llamar a este procedimiento, debe crear una nueva DataTableReader instancia y llamar a su método Read al menos una vez para colocar el puntero de fila en una fila de datos.

private static object GetValueByName(
    DataTableReader reader, string columnName)
{
    // Consider when to use a procedure like this one carefully:
    // if  you're going to retrieve information from a column
    // in a loop, it would be better to retrieve the column
    // ordinal once, store the value, and use the methods
    // of the DataTableReader class directly.
    // Use this string-based indexer sparingly.
    object columnValue = null;

    try
    {
        columnValue = reader[columnName];
    }
    catch (ArgumentException ex)
    {
        // Throw all other errors back out to the caller.
        columnValue = null;
    }
    return columnValue;
}

Private Function GetValueByName( _
   ByVal reader As DataTableReader, _
   ByVal columnName As String) As Object

   ' Consider when to use a procedure like this one carefully:
   ' If you're going to retrieve information from a column
   ' in a loop, it would be better to retrieve the column
   ' ordinal once, store the value, and use the methods
   ' of the DataTableReader class directly. 
   ' Use Item(columnName) sparingly.
   Dim columnValue As Object

   Try
      columnValue = reader.Item(columnName)
   Catch ex As ArgumentException
      ' Throw all other errors back out to the caller.
      columnValue = Nothing
   End Try
   Return columnValue
End Function

Comentarios

Primero se realiza una búsqueda con distinción entre mayúsculas y minúsculas. Si se produce un error, se realiza una segunda búsqueda sin distinción entre mayúsculas y minúsculas.

Este método no distingue el ancho kana.

Esta versión sobrecargada de Item[] corresponde a llamar al GetOrdinal método y, a continuación, llamar al GetValue método .