DataRowExtensions.Field 方法

參考

定義

命名空間:: System.Data

組件:: System.Data.DataSetExtensions.dll

組件:: System.Data.Common.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

提供強型別存取 DataRow 中每個資料行的值。

多載

Field<T>(DataRow, DataColumn)	提供強型別的權限以存取指定之資料列中每一個資料行的值。 Field<T>(DataRow, DataColumn) 方法也支援可為 null 的型別。
Field<T>(DataRow, Int32)	提供強型別的權限以存取指定之資料列中每一個資料行的值。 Field<T>(DataRow, Int32) 方法也支援可為 null 的型別。
Field<T>(DataRow, String)	提供強型別的權限以存取指定之資料列中每一個資料行的值。 Field<T>(DataRow, String) 方法也支援可為 null 的型別。
Field<T>(DataRow, DataColumn, DataRowVersion)	提供強型別的權限以存取指定之資料列中每一個資料行的值。 Field<T>(DataRow, DataColumn, DataRowVersion) 方法也支援可為 null 的型別。
Field<T>(DataRow, Int32, DataRowVersion)	提供強型別的權限以存取指定之資料列中每一個資料行的值。 Field<T>(DataRow, Int32, DataRowVersion) 方法也支援可為 null 的型別。
Field<T>(DataRow, String, DataRowVersion)	提供強型別的權限以存取指定之資料列中每一個資料行的值。 Field<T>(DataRow, String, DataRowVersion) 方法也支援可為 null 的型別。

Field<T>(DataRow, DataColumn)

來源:: DataRowExtensions.cs

來源:: DataRowExtensions.cs

來源:: DataRowExtensions.cs

提供強型別的權限以存取指定之資料列中每一個資料行的值。 Field<T>(DataRow, DataColumn) 方法也支援可為 null 的型別。

public:
generic <typename T>
[System::Runtime::CompilerServices::Extension]
 static T Field(System::Data::DataRow ^ row, System::Data::DataColumn ^ column);

public static T Field<T> (this System.Data.DataRow row, System.Data.DataColumn column);

public static T? Field<T> (this System.Data.DataRow row, System.Data.DataColumn column);

static member Field : System.Data.DataRow * System.Data.DataColumn -> 'T

<Extension()>
Public Function Field(Of T) (row As DataRow, column As DataColumn) As T

類型參數

T

泛型參數，會指定資料行的傳回型別。

參數

row: DataRow

輸入 DataRow，作用為擴充方法的 this 執行個體。

column: DataColumn

輸入 DataColumn 物件，指定要傳回其值的資料行。

傳回

T 指定之 DataColumn 的 column 型別值。

例外狀況

InvalidCastException

基礎資料行的實值型別不能轉換成泛型參數 T 所指定的型別。

IndexOutOfRangeException

column 所指定的資料行不會出現在 DataTable 所屬的 DataRow。

NullReferenceException

null 值已指派給不可為 Null 的類型。

備註

類別DataSet代表具有類別實例的 DBNullNull 值Value。 Language-Integrated 查詢 (LINQ) 表示式，存取具有 Null 值的數據行會在執行時間產生 InvalidCastException 。此外， DataSet 和 DataTable 不支援可為 Null 的類型。方法 Field 支援以可為 Null 的類型存取資料行。如果中DataSet DBNull.Value的基礎值為，則傳回的可為 Null 的類型會有 null 值。

如果指定的 DataColumn DBNull.Value 值為，而且 T 是參考型別或可為 Null 的型別，則傳回型別會是 Null。方法 Field 不會傳回 DBNull.Value。

方法 Field 不會執行類型轉換。如果需要類型轉換，您應該先使用 Field 方法來取得數據行值。然後，數據行值應該轉換成另一個類型。

適用於

Field<T>(DataRow, Int32)

來源:: DataRowExtensions.cs

來源:: DataRowExtensions.cs

來源:: DataRowExtensions.cs

提供強型別的權限以存取指定之資料列中每一個資料行的值。 Field<T>(DataRow, Int32) 方法也支援可為 null 的型別。

public:
generic <typename T>
[System::Runtime::CompilerServices::Extension]
 static T Field(System::Data::DataRow ^ row, int columnIndex);

public static T Field<T> (this System.Data.DataRow row, int columnIndex);

public static T? Field<T> (this System.Data.DataRow row, int columnIndex);

static member Field : System.Data.DataRow * int -> 'T

<Extension()>
Public Function Field(Of T) (row As DataRow, columnIndex As Integer) As T

類型參數

T

泛型參數，會指定資料行的傳回型別。

參數

row: DataRow

輸入 DataRow，作用為擴充方法的 this 執行個體。

columnIndex: Int32

資料行索引。

傳回

T 指定之 DataColumn 的 columnIndex 型別值。

例外狀況

InvalidCastException

基礎資料行的實值型別不能轉換成泛型參數 T 所指定的型別。

IndexOutOfRangeException

ordinal 所指定的資料行不會存在於 DataTable 所屬的 DataRow。

NullReferenceException

null 值已指派給不可為 Null 的類型。

備註

類別DataSet代表具有類別實例的 DBNullNull 值Value。 Language-Integrated 查詢 (LINQ) 表示式，存取具有 Null 值的數據行會在執行時間產生 InvalidCastException 。此外， DataSet 不支援可為 Null 的類型。方法 Field 支援以可為 Null 的類型存取資料行。如果中DataSet DBNull.Value的基礎值為，則傳回的可為 Null 的類型會有 null 值。

如果指定的 DataColumn 值為 null ，而且 T 是參考型別或可為 Null 的型別，則傳回型別會是 Null。方法 Field 不會傳回 DBNull.Value。

方法 Field 不會執行類型轉換。如果需要類型轉換，您應該先使用 Field 方法來取得數據行值。然後，數據行值應該轉換成另一個類型。

適用於

Field<T>(DataRow, String)

來源:: DataRowExtensions.cs

來源:: DataRowExtensions.cs

來源:: DataRowExtensions.cs

提供強型別的權限以存取指定之資料列中每一個資料行的值。 Field<T>(DataRow, String) 方法也支援可為 null 的型別。

public:
generic <typename T>
[System::Runtime::CompilerServices::Extension]
 static T Field(System::Data::DataRow ^ row, System::String ^ columnName);

public static T Field<T> (this System.Data.DataRow row, string columnName);

public static T? Field<T> (this System.Data.DataRow row, string columnName);

static member Field : System.Data.DataRow * string -> 'T

<Extension()>
Public Function Field(Of T) (row As DataRow, columnName As String) As T

類型參數

T

泛型參數，會指定資料行的傳回型別。

參數

row: DataRow

輸入 DataRow，作用為擴充方法的 this 執行個體。

columnName: String

要傳回其值的資料行名稱。

傳回

T 指定之 DataColumn 的 columnName 型別值。

例外狀況

InvalidCastException

基礎資料行的實值型別不能轉換成泛型參數 T 所指定的型別。

IndexOutOfRangeException

columnName 所指定的資料行不會出現在 DataTable 所屬的 DataRow。

NullReferenceException

null 值已指派給不可為 null 的型別。

備註

如果指定的 DataColumn 值為 null ，而且 T 是參考型別或可為 Null 的類型，則傳回型別會是 Null。方法 Field 不會傳回 DBNull.Value。

方法 Field 不會執行類型轉換。如果需要類型轉換，您應該先使用 Field 方法來取得數據行值。然後，數據行值應該轉換成另一個類型。

適用於

Field<T>(DataRow, DataColumn, DataRowVersion)

來源:: DataRowExtensions.cs

來源:: DataRowExtensions.cs

來源:: DataRowExtensions.cs

提供強型別的權限以存取指定之資料列中每一個資料行的值。 Field<T>(DataRow, DataColumn, DataRowVersion) 方法也支援可為 null 的型別。

public:
generic <typename T>
[System::Runtime::CompilerServices::Extension]
 static T Field(System::Data::DataRow ^ row, System::Data::DataColumn ^ column, System::Data::DataRowVersion version);

public static T Field<T> (this System.Data.DataRow row, System.Data.DataColumn column, System.Data.DataRowVersion version);

public static T? Field<T> (this System.Data.DataRow row, System.Data.DataColumn column, System.Data.DataRowVersion version);

static member Field : System.Data.DataRow * System.Data.DataColumn * System.Data.DataRowVersion -> 'T

<Extension()>
Public Function Field(Of T) (row As DataRow, column As DataColumn, version As DataRowVersion) As T

類型參數

T

泛型參數，會指定資料行的傳回型別。

參數

row: DataRow

輸入 DataRow，作用為擴充方法的 this 執行個體。

column: DataColumn

輸入 DataColumn 物件，指定要傳回其值的資料行。

version: DataRowVersion

DataRowVersion 列舉，會指定要傳回之資料行值的版本，例如 Current 或 Original 版本。

傳回

T 和 column 指定之 DataColumn 的 version 型別值。

例外狀況

InvalidCastException

基礎資料行的實值型別不能轉換成泛型參數 T 所指定的型別。

IndexOutOfRangeException

column 所指定的資料行不會存在於 DataTable 所屬的 DataRow。

NullReferenceException

null 值已指派給不可為 Null 的類型。

備註

如果指定的 DataColumn 值為 null，而且 T 是參考型別或可為 Null 的型別，則傳回型別會是 Null。方法 Field 不會傳回 DBNull.Value。

方法 Field 不會執行類型轉換。如果需要類型轉換，您應該先使用 Field 方法來取得數據行值。然後，數據行值應該轉換成另一種類型。

適用於

Field<T>(DataRow, Int32, DataRowVersion)

來源:: DataRowExtensions.cs

來源:: DataRowExtensions.cs

來源:: DataRowExtensions.cs

提供強型別的權限以存取指定之資料列中每一個資料行的值。 Field<T>(DataRow, Int32, DataRowVersion) 方法也支援可為 null 的型別。

public:
generic <typename T>
[System::Runtime::CompilerServices::Extension]
 static T Field(System::Data::DataRow ^ row, int columnIndex, System::Data::DataRowVersion version);

public static T Field<T> (this System.Data.DataRow row, int columnIndex, System.Data.DataRowVersion version);

public static T? Field<T> (this System.Data.DataRow row, int columnIndex, System.Data.DataRowVersion version);

static member Field : System.Data.DataRow * int * System.Data.DataRowVersion -> 'T

<Extension()>
Public Function Field(Of T) (row As DataRow, columnIndex As Integer, version As DataRowVersion) As T

類型參數

T

泛型參數，會指定資料行的傳回型別。

參數

row: DataRow

輸入 DataRow，作用為擴充方法的 this 執行個體。

columnIndex: Int32

要傳回其值的資料行之以零起始的序數。

version: DataRowVersion

DataRowVersion 列舉，會指定要傳回之資料行值的版本，例如 Current 或 Original 版本。

傳回

T 和 ordinal 指定之 DataColumn 的 version 型別值。

例外狀況

InvalidCastException

基礎資料行的實值型別不能轉換成泛型參數 T 所指定的型別。

IndexOutOfRangeException

ordinal 所指定的資料行不會存在於 DataTable 所屬的 DataRow。

NullReferenceException

null 值已指派給不可為 Null 的類型。

備註

類別 DataSet 代表具有Value 類別實例的 DBNull Null 值。 Language-Integrated 查詢 (LINQ) 表示式，存取具有 Null 值的數據行會在執行時間產生 InvalidCastException 。此外， DataSet 不支援可為 Null 的型別。方法 Field 支援以可為 Null 的類型存取資料行。如果中DataSet DBNull.Value的基礎值為，則傳回的可為 Null 類型會有 null 值。

如果指定的 DataColumn 值為 null，而且 T 是引用類型或可為 Null 的型別，則傳回型別會是 Null。方法 Field 不會傳回 DBNull.Value。

方法 Field 不會執行類型轉換。如果需要類型轉換，您應該先使用 Field 方法來取得數據行值。然後，數據行值應該轉換成另一種類型。

適用於

Field<T>(DataRow, String, DataRowVersion)

來源:: DataRowExtensions.cs

來源:: DataRowExtensions.cs

來源:: DataRowExtensions.cs

提供強型別的權限以存取指定之資料列中每一個資料行的值。 Field<T>(DataRow, String, DataRowVersion) 方法也支援可為 null 的型別。

public:
generic <typename T>
[System::Runtime::CompilerServices::Extension]
 static T Field(System::Data::DataRow ^ row, System::String ^ columnName, System::Data::DataRowVersion version);

public static T Field<T> (this System.Data.DataRow row, string columnName, System.Data.DataRowVersion version);

public static T? Field<T> (this System.Data.DataRow row, string columnName, System.Data.DataRowVersion version);

static member Field : System.Data.DataRow * string * System.Data.DataRowVersion -> 'T

<Extension()>
Public Function Field(Of T) (row As DataRow, columnName As String, version As DataRowVersion) As T

類型參數

T

泛型參數，會指定資料行的傳回型別。

參數

row: DataRow

輸入 DataRow，作用為擴充方法的 this 執行個體。

columnName: String

要傳回其值的資料行名稱。

version: DataRowVersion

DataRowVersion 列舉，會指定要傳回之資料行值的版本，例如 Current 或 Original 版本。

傳回

T 和 columnName 指定之 DataColumn 的 version 型別值。

例外狀況

InvalidCastException

基礎資料行的實值型別不能轉換成泛型參數 T 所指定的型別。

IndexOutOfRangeException

columnName 所指定的資料行不會存在於 DataTable 所屬的 DataRow。

NullReferenceException

null 值已指派給不可為 Null 的類型。

備註

如果指定的 DataColumn 值為 null，而且 T 是引用類型或可為 Null 的型別，則傳回型別會是 Null。方法 Field 不會傳回 DBNull.Value。

方法 Field 不會執行類型轉換。如果需要類型轉換，您應該先使用 Field 方法來取得數據行值。然後，數據行值應該轉換成另一種類型。

適用於

共用方式為

DataRowExtensions.Field 方法

定義

多載

Field<T>(DataRow, DataColumn)

類型參數

參數

傳回

例外狀況

備註

適用於

Field<T>(DataRow, Int32)

類型參數

參數

傳回

例外狀況

備註

適用於

Field<T>(DataRow, String)

類型參數

參數

傳回

例外狀況

備註

適用於

Field<T>(DataRow, DataColumn, DataRowVersion)

類型參數

參數

傳回

例外狀況

備註

適用於

Field<T>(DataRow, Int32, DataRowVersion)

類型參數

參數

傳回

例外狀況

備註

適用於

Field<T>(DataRow, String, DataRowVersion)

類型參數

參數

傳回

例外狀況

備註

適用於

其他資源