DataTableReader.GetGuid(Int32) 方法

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

來源:

DataTableReader.cs

取得指定資料行的值做為全域唯一識別項 (GUID)。

public:
 override Guid GetGuid(int ordinal);

public override Guid GetGuid (int ordinal);

override this.GetGuid : int -> Guid

Public Overrides Function GetGuid (ordinal As Integer) As Guid

參數

ordinal

Int32

以零為基底的資料行序數。

傳回

Guid

指定的資料行值。

例外狀況

ArgumentOutOfRangeException

傳遞的索引超出 0 到 FieldCount - 1 的範圍。

DeletedRowInaccessibleException

嘗試從已刪除的資料列擷取資料。

InvalidOperationException

嘗試在關閉的 DataTableReader 中讀取或存取資料行。

InvalidCastException

指定的資料行不包含 GUID。

範例

下列範例會顯示傳入 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.GetGuid(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.GetGuid(2))
         Catch ex As InvalidCastException
            Console.Write("Invalid data type.")
         End Try
      End If
      Console.WriteLine()
   End While
End Sub

備註

不會執行轉換;因此，擷取的數據必須已經是 Guid 或可強制轉換為 Guid。

呼叫 IsDBNull 以查看在呼叫這個方法之前是否有 Null 值。