DataTableReader.GetChar(Int32) Metodo

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Origine:

DataTableReader.cs

Ottiene il valore della colonna specificata sotto forma di carattere.

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

Parametri

ordinal

Int32

Ordinale di colonna in base zero.

Restituisce

Char

Valore della colonna.

Eccezioni

ArgumentOutOfRangeException

L'indice passato non rientrava nell'intervallo compreso tra 0 e FieldCount -1.

DeletedRowInaccessibleException

Si è tentato di recuperare dati da una riga eliminata.

InvalidOperationException

È stato effettuato un tentativo di lettura o di accesso a una colonna in una classe DataTableReader chiusa.

InvalidCastException

Il campo specificato non contiene un carattere.

Esempio

Nell'esempio seguente viene visualizzato il contenuto della colonna numerata 2 all'interno dell'oggetto DataTableReader passato. Se il valore della colonna all'interno di una determinata riga è Null, il codice visualizza il testo <NULL>. Se i dati all'interno della colonna non sono del tipo corretto, nell'esempio viene visualizzato un messaggio di errore per ogni riga.

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

Commenti

Non vengono eseguite conversioni; pertanto i dati recuperati devono essere già un carattere o coercibile a un carattere.

Chiamare IsDBNull per verificare se sono presenti valori Null prima di chiamare questo metodo.