DataTableReader.GetString メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataTableReader.GetString メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 GetString ( _
    ordinal As Integer _
) As String

Visual Basic (使用法)

Dim instance As DataTableReader
Dim ordinal As Integer
Dim returnValue As String

returnValue = instance.GetString(ordinal)

public override string GetString (
    int ordinal
)

C++

public:
virtual String^ GetString (
    int ordinal
) override

public String GetString (
    int ordinal
)

JScript

public override function GetString (
    ordinal : int
) : String

パラメータ

ordinal: 列の 0 から始まる序数。

戻り値
指定した列の値。

例外

例外の種類	条件
ArgumentOutOfRangeException	渡されたインデックスが 0 から FieldCount - 1 の範囲にありません。
DeletedRowInaccessibleException	削除した行からデータを取得しようとしました。
InvalidOperationException	閉じている DataTableReader の列を読み取るかアクセスしようとしました。
InvalidCastException	指定した列に文字列が含まれていません。

解説

このメソッドを呼び出す前に、IsDbNull を呼び出して、null 値があるかどうかを確認してください。

使用例

渡された DataTableReader の中から 2 番目の列の内容を表示する例を次に示します。特定の行内にある列の値が null の場合、"<NULL>" というテキストが表示されます。この例では、列に格納されたデータの型が適切な場合、各行についてエラーメッセージが表示されます。

Visual Basic

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.GetString(2))
         Catch ex As InvalidCastException
            Console.Write("Invalid data type.")
         End Try
      End If
      Console.WriteLine()
   End While
End Sub

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.GetString(2));
            }
            catch (InvalidCastException)
            {
                Console.Write("Invalid data type.");
            }
        }
        Console.WriteLine();
    }
}