DataTableReader.GetGuid メソッド

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

DataTableReader.GetGuid メソッド

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

指定した列の値をグローバル一意識別子 (GUID) として取得します。

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

Visual Basic (宣言)

Public Overrides Function
 GetGuid ( _
    ordinal As Integer _
) As Guid

Visual Basic (使用法)

Dim instance As DataTableReader
Dim ordinal As Integer
Dim returnValue As Guid

returnValue = instance.GetGuid(ordinal)

C#

public override Guid GetGuid (
    int ordinal
)

C++

public:
virtual Guid GetGuid (
    int ordinal
) override

J#

public Guid GetGuid (
    int ordinal
)

JScript

public override function GetGuid (
    ordinal : int
) : Guid

パラメータ

ordinal

列の 0 から始まる序数。

戻り値
指定した列の値。

例外

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

解説

変換は実行されません。そのため、取得するデータは Guid であるか、Guid に強制変換できる必要があります。

このメソッドを呼び出す前に、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.GetGuid(2))
         Catch ex As InvalidCastException
            Console.Write("Invalid data type.")
         End Try
      End If
      Console.WriteLine()
   End While
End Sub

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
DataTableReader クラス
DataTableReader メンバ
System.Data 名前空間