DataTableReader.GetChar(Int32) Méthode

Définition

Espace de noms:

System.Data

Assembly:

System.Data.dll

Obtient la valeur de la colonne spécifiée en tant que caractère.

public:
 override char GetChar(int ordinal);

public override char GetChar(int ordinal);

override this.GetChar : int -> char

Public Overrides Function GetChar (ordinal As Integer) As Char

Paramètres

ordinal

Int32

Ordinal de colonne de base zéro.

Retours

Char

Valeur de la colonne.

Exceptions

ArgumentOutOfRangeException

L’index passé était en dehors de la plage de 0 à 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 a été effectuée pour lire ou accéder à une colonne dans une colonne fermée DataTableReader.

InvalidCastException

Le champ spécifié ne contient pas de caractère.

Exemples

L’exemple suivant affiche le contenu de la colonne numérotée 2 dans dataTableReader passé. Si la valeur de la colonne dans une ligne particulière est Null, le code affiche le texte <NULL>. Si les données de la colonne ne sont pas du type correct, l’exemple affiche un message d’erreur pour chaque ligne.

private static void PrintColumn(DataTableReader reader)
{
    // Loop through all the rows in the DataTableReader
    while (reader.Read())
    {
        if (reader.IsDBNull(2))
        {
            Console.Write("<NULL>");
        }
        else
        {
            try
            {
                Console.Write(reader.GetChar(2));
            }
            catch (InvalidCastException)
            {
                Console.Write("Invalid data type.");
            }
        }
        Console.WriteLine();
    }
}

Private Sub PrintColumn(ByVal reader As DataTableReader)
   ' Loop through all the rows in the DataTableReader
   While reader.Read()
      If reader.IsDBNull(2) Then
         Console.Write("<NULL>")
      Else
         Try
            Console.Write(reader.GetChar(2))
         Catch ex As InvalidCastException
            Console.Write("Invalid data type.")
         End Try
      End If
      Console.WriteLine()
   End While
End Sub

Remarques

Aucune conversion n’est effectuée ; par conséquent, les données récupérées doivent déjà être un caractère ou être coercibles à un caractère.

Appelez IsDBNull pour voir s’il existe des valeurs Null avant d’appeler cette méthode.