DataTableReader.Item[] Propiedad

Definición

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

Sobrecargas

Nombre Description
Item[Int32]

Obtiene el valor de la columna especificada en su formato nativo según el ordinal de columna.

Item[String]

Obtiene el valor de la columna especificada en su formato nativo según el nombre de columna.

Item[Int32]

Obtiene el valor de la columna especificada en su formato nativo según el ordinal 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

Ordinal de columna de base cero.

Valor de propiedad

Valor de la columna especificada en su formato nativo.

Excepciones

El índice pasado estaba fuera del intervalo de 0 a FieldCount - 1.

Ejemplos

En el ejemplo siguiente se muestra el contenido de todas las columnas, en todas las filas del proporcionado DataTableReader. El código usa el método Item[] (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

Se aplica a

Item[String]

Obtiene el valor de la columna especificada en su formato nativo según el nombre de 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

Nombre de la columna.

Valor de propiedad

Valor de la columna especificada en su formato nativo.

Excepciones

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

Se intentó recuperar datos de una fila eliminada.

Se intentó leer o tener acceso a una columna en un objeto cerrado DataTableReader.

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 que distingue mayúsculas de 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 .

Se aplica a