Partilhar via


DataTableReader.Item[] Propriedade

Definição

Obtém o valor da coluna especificada em seu formato nativo.

Sobrecargas

Item[Int32]

Obtém o valor da coluna especificada em seu formato nativo de acordo com o ordinal da coluna.

Item[String]

Obtém o valor da coluna especificada em seu formato nativo de acordo com o nome da coluna.

Item[Int32]

Origem:
DataTableReader.cs
Origem:
DataTableReader.cs
Origem:
DataTableReader.cs

Obtém o valor da coluna especificada em seu formato nativo de acordo com o ordinal da coluna.

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

O ordinal da coluna baseado em zero.

Valor da propriedade

O valor da coluna especificada em seu formato nativo.

Exceções

O índice passado estava fora do intervalo de 0 a FieldCount -1.

Exemplos

O exemplo a seguir exibe o conteúdo de todas as colunas, em todas as linhas do fornecido DataTableReader. O código usa o Item[] método (o indexador, no Microsoft C#) para recuperar o valor contido em cada coluna.

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

Comentários

Essa sobrecarga para Item[] se comporta de forma idêntica ao GetValue método .

Confira também

Aplica-se a

Item[String]

Origem:
DataTableReader.cs
Origem:
DataTableReader.cs
Origem:
DataTableReader.cs

Obtém o valor da coluna especificada em seu formato nativo de acordo com o nome da coluna.

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

O nome da coluna.

Valor da propriedade

O valor da coluna especificada em seu formato nativo.

Exceções

O nome especificado não é um nome de coluna válido.

Foi feita uma tentativa de recuperar dados de uma linha excluída.

Foi feita uma tentativa de ler ou acessar uma coluna em um DataTableReader fechado.

Exemplos

Dado um DataTableReader nome de coluna e , o procedimento GetValueByName retorna o valor da coluna especificada. Antes de chamar esse procedimento, você deve criar uma nova DataTableReader instância e chamar seu método Read pelo menos uma vez para posicionar o ponteiro de linha em uma linha de dados.

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

Comentários

Uma pesquisa que diferencia maiúsculas de minúsculas é executada primeiro. Se falhar, uma segunda pesquisa que não diferencia maiúsculas de minúsculas será feita.

Esse método não diferencia a largura kana.

Essa versão sobrecarregada de Item[] corresponde a chamar o GetOrdinal método e, em seguida, chamar o GetValue método.

Aplica-se a