DataTableReader.GetValue(Int32) Méthode

Référence

Définition

Espace de noms:: System.Data

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Source:: DataTableReader.cs

Source:: DataTableReader.cs

Source:: DataTableReader.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

public:
 override System::Object ^ GetValue(int ordinal);

public override object GetValue (int ordinal);

override this.GetValue : int -> obj

Public Overrides Function GetValue (ordinal As Integer) As Object

Paramètres

ordinal: Int32

Numéro de colonne de base zéro.

Retours

Object

Valeur de la colonne spécifiée. Cette méthode retourne DBNull pour les colonnes ayant la valeur null.

Exceptions

ArgumentOutOfRangeException

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

DeletedRowInaccessibleException

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

InvalidOperationException

Une tentative de lecture de colonnes ou d’accès à des colonnes dans un DataTableReader fermé a été effectuée.

Exemples

L’exemple suivant effectue une itération dans toutes les colonnes de la ligne actuelle d’un DataTableReader, en affichant le contenu de chaque colonne et le nom de la colonne. En règle générale, si votre intention est de travailler avec toutes les colonnes d’une ligne récupérée par un DataTableReader, envisagez d’utiliser la méthode à la GetValues place, car elle est plus efficace.

private static void GetAllValues(DataTableReader reader)
{
    // Given a DataTableReader, retrieve the value of
    // each column, and display the name, value, and type.
    // Make sure you have called reader.Read at least once before
    // calling this procedure.

    // Loop through all the columns.
    object value = null;
    for (int i = 0; i < reader.FieldCount; i++)
    {
        if (reader.IsDBNull(i))
        {
            value = "<NULL>";
        }
        else
        {
            value = reader.GetValue(i);
        }
        Console.WriteLine("{0}: {1} ({2})", reader.GetName(i),
            value, reader.GetFieldType(i).Name);
    }
}

Private Sub GetAllValues(ByVal reader As DataTableReader)

   ' Given a DataTableReader, retrieve the value of 
   ' each column, and display the name, value, and type.
   ' Make sure you've called reader.Read at least once before
   ' calling this procedure.
   ' Loop through all the columns.
   Dim value As Object
   For i As Integer = 0 To reader.FieldCount - 1
      If reader.IsDBNull(i) Then
         value = "<NULL>"
      Else
         value = reader.GetValue(i)
      End If
      Console.WriteLine("{0}: {1} ({2})", reader.GetName(i), _
         value, reader.GetFieldType(i).Name)
   Next
End Sub

Remarques

Bien que vous puissiez appeler IsDBNull pour voir s’il existe des valeurs Null avant d’appeler cette méthode, vous n’avez pas besoin de le faire.

S’applique à