DataTableReader.Item[] Propriété

Définition

Espace de noms:

System.Data

Assembly:

System.Data.Common.dll

Obtient la valeur de la colonne spécifiée dans son format natif.

Surcharges

Item[Int32]	Obtient la valeur de la colonne spécifiée dans son format natif en fonction du numéro de la colonne.
Item[String]	Obtient la valeur de la colonne spécifiée dans son format natif en fonction du nom de la colonne.

Item[Int32]

Source:

DataTableReader.cs

Obtient la valeur de la colonne spécifiée dans son format natif en fonction du numéro de la colonne.

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

Paramètres

ordinal

Int32

Numéro de colonne de base zéro.

Valeur de propriété

Object

Valeur de la colonne spécifiée dans son format natif.

Exceptions

IndexOutOfRangeException

L'index passé était en dehors de la plage comprise entre 0 et FieldCount - 1.

Exemples

L’exemple suivant affiche le contenu de toutes les colonnes, dans toutes les lignes du fourni DataTableReader. Le code utilise la Item[] méthode (l’indexeur, dans Microsoft C#) pour récupérer la valeur contenue dans chaque colonne.

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

Remarques

Cette surcharge pour Item[] se comporte de façon identique à la GetValue méthode .

Voir aussi

• GetValue(Int32)

Item[String]

Source:

DataTableReader.cs

Obtient la valeur de la colonne spécifiée dans son format natif en fonction du nom de la colonne.

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

Paramètres

name

String

Nom de la colonne.

Valeur de propriété

Object

Valeur de la colonne spécifiée dans son format natif.

Exceptions

ArgumentException

Le nom spécifié n'est pas un nom de colonne valide.

DeletedRowInaccessibleException

Une tentative a été effectuée pour récupérer des données à partir d'une ligne supprimée.

InvalidOperationException

Une tentative a été effectuée pour lire une colonne ou y accéder dans un DataTableReader fermé.

Exemples

En fonction d’un DataTableReader et d’un nom de colonne, la procédure GetValueByName retourne la valeur de la colonne spécifiée. Avant d’appeler cette procédure, vous devez créer une instance DataTableReader et appeler sa méthode Read au moins une fois pour positionner le pointeur de ligne sur une ligne de données.

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

Remarques

Une recherche respectant la casse est effectuée en premier. En cas d’échec, une deuxième recherche ne respectant pas la casse est effectuée.

Cette méthode ne tient pas compte de la largeur des caractères kana.

Cette version surchargée de correspond à l’appel de Item[] la GetOrdinal méthode, puis à l’appel de la méthode par la GetValue suite.