Export (0) Print
Expand All

DataTableReader.GetChar Method

Gets the value of the specified column as a character.

Namespace:  System.Data
Assembly:  System.Data (in System.Data.dll)

'Declaration
Public Overrides Function GetChar ( _
	ordinal As Integer _
) As Char

Parameters

ordinal
Type: System.Int32

The zero-based column ordinal.

Return Value

Type: System.Char
The value of the column.

Implements

IDataRecord.GetChar(Int32)

ExceptionCondition
ArgumentOutOfRangeException

The index passed was outside the range of 0 to FieldCount - 1.

DeletedRowInaccessibleException

An attempt was made to retrieve data from a deleted row.

InvalidOperationException

An attempt was made to read or access a column in a closed DataTableReader.

InvalidCastException

The specified field does not contain a character.

No conversions are performed; therefore the data retrieved must already be a character or coercible to a character.

Call IsDBNull to see if there are null values before calling this method.

The following example displays the contents of the column numbered 2 within the passed-in DataTableReader. If the value the column within a particular row is null, the code displays the text <NULL>. If the data within the column is not of the correct type, the example displays an error message for each row.

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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0
Show:
© 2015 Microsoft