DataTableReader.GetChar(Int32) メソッド

定義

名前空間:
System.Data
アセンブリ:
System.Data.dll
アセンブリ:
netstandard.dll

指定した列の値を文字として取得します。

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

パラメーター

ordinal
Int32

0 から始まる列の序数。

返品

Char

列の値。

例外

ArgumentOutOfRangeException

渡されたインデックスが 0 から FieldCount - 1 の範囲外でした。

DeletedRowInaccessibleException

削除された行からデータを取得しようとしました。

InvalidOperationException

閉じた DataTableReader内の列の読み取りまたはアクセスが試行されました。

InvalidCastException

指定されたフィールドに文字が含まれていません。

例

次の使用例は、渡された DataTableReader 内の 2 という番号の列の内容を表示します。 特定の行内の列の値が null の場合、コードはテキスト <NULL>を表示します。 列内のデータが正しい型でない場合、この例では各行のエラー メッセージが表示されます。

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

注釈

変換は実行されません。したがって、取得されるデータは、既に文字であるか、文字に強制的に変換できる必要があります。

IsDBNullを呼び出して、このメソッドを呼び出す前に null 値があるかどうかを確認します。

適用対象