Partager via


DataTableReader.GetValue(Int32) Méthode

Définition

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

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

Exceptions

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

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

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 à