DataTableReader.GetChar(Int32) Méthode

Définition

Obtient la valeur de la colonne spécifiée sous la forme d'un 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

Numéro de colonne de base zéro.

Retours

La valeur de la colonne.

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 a été effectuée pour lire une colonne ou y accéder dans un DataTableReader fermé.

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 le DataTableReader transmis. 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 contraintes à un caractère.

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

S’applique à