DataRowExtensions.Field メソッド

定義

DataRow の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the DataRow.

オーバーロード

Field<T>(DataRow, DataColumn)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, DataColumn) method also supports nullable types.

Field<T>(DataRow, Int32)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, Int32) method also supports nullable types.

Field<T>(DataRow, String)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, String) method also supports nullable types.

Field<T>(DataRow, DataColumn, DataRowVersion)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn, DataRowVersion) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, Int32, DataRowVersion)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32, DataRowVersion) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, String, DataRowVersion)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String, DataRowVersion) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, DataColumn)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, DataColumn) method also supports nullable types.

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);
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

列の戻り値の型を指定するジェネリック パラメーター。A generic parameter that specifies the return type of the column.

パラメーター

row
DataRow

拡張メソッドの this インスタンスとして機能する入力 DataRowThe input DataRow, which acts as the this instance for the extension method.

column
DataColumn

どの列の値を取得するかを指定する入力 DataColumn オブジェクト。The input DataColumn object that specifies the column to return the value of.

戻り値

T

T で指定された DataColumncolumn 型の値。The value, of type T, of the DataColumn specified by column.

例外

基になる列値の型を、ジェネリック パラメーター T で指定された型にキャストできませんでした。The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

column で指定された列は、DataTable が属している DataRow には存在しません。The column specified by column does not occur in the DataTable that the DataRow is a part of.

Null 非許容型に null 値が割り当てられました。A null value was assigned to a non-nullable type.

注釈

クラスは、 DataSet クラスのインスタンスを使用してnull値を表し Value DBNull ます。The DataSet class represents null values with the Value instance of the DBNull class. 統合言語クエリ (LINQ: Language-Integrated Query)Language-Integrated Query (LINQ) Null値を持つ列にアクセスした式では、実行時にが生成さ InvalidCastException れます。A 統合言語クエリ (LINQ: Language-Integrated Query)Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. また、 DataSet は null 許容型をサポートしていません。Additionally, DataSet does not support nullable types. メソッドは、 Field null 許容型として列にアクセスするためのサポートを提供します。The Field method provides support for accessing columns as nullable types. の基になる値がの場合 DataSet Value 、返される null 許容型の値はnullになります。If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

指定したの値 DataColumn がであり、 Value T 参照型または null 許容型である場合、戻り値の型はnullになります。If the value of the specified DataColumn is Value and T is a reference type or nullable type, the return type will be null. メソッドはを Field 返しません ValueThe Field method will not return Value.

メソッドは、 Field 型変換を実行しません。The Field method does not perform type conversions. 型変換が必要な場合は、最初にメソッドを使用して列の値を取得する必要があり Field ます。If type conversion is required, you should first obtain the column value by using the Field method. その後、列の値を別の型に変換する必要があります。The column value should then be converted to another type.

Field<T>(DataRow, Int32)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, Int32) method also supports nullable types.

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);
static member Field : System.Data.DataRow * int -> 'T
<Extension()>
Public Function Field(Of T) (row As DataRow, columnIndex As Integer) As T

型パラメーター

T

列の戻り値の型を指定するジェネリック パラメーター。A generic parameter that specifies the return type of the column.

パラメーター

row
DataRow

拡張メソッドの this インスタンスとして機能する入力 DataRowThe input DataRow, which acts as the this instance for the extension method.

columnIndex
Int32

列インデックス。The column index.

戻り値

T

T で指定された DataColumncolumnIndex 型の値。The value, of type T, of the DataColumn specified by columnIndex.

例外

基になる列値の型を、ジェネリック パラメーター T で指定された型にキャストできませんでした。The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

ordinal で指定された列は、DataTable が属している DataRow には存在しません。The column specified by ordinal does not exist in the DataTable that the DataRow is a part of.

Null 非許容型に null 値が割り当てられました。A null value was assigned to a non-nullable type.

注釈

クラスは、 DataSet クラスのインスタンスを使用してnull値を表し Value DBNull ます。The DataSet class represents null values with the Value instance of the DBNull class. 統合言語クエリ (LINQ: Language-Integrated Query)Language-Integrated Query (LINQ) Null値を持つ列にアクセスした式では、実行時にが生成さ InvalidCastException れます。A 統合言語クエリ (LINQ: Language-Integrated Query)Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. また、は DataSet null 許容型をサポートしていません。Additionally, DataSet doesn't support nullable types. メソッドは、 Field null 許容型として列にアクセスするためのサポートを提供します。The Field method provides support for accessing columns as nullable types. の基になる値がの場合 DataSet Value 、返される null 許容型の値はnullになります。If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

指定したの値 DataColumnnullで、 T が参照型または null 許容型である場合、戻り値の型はnullになります。If the value of the specified DataColumn is null and T is a reference type or nullable type, then the return type will be null. メソッドはを Field 返しません ValueThe Field method will not return Value.

メソッドは、 Field 型変換を実行しません。The Field method does not perform type conversions. 型変換が必要な場合は、最初にメソッドを使用して列の値を取得する必要があり Field ます。If type conversion is required, you should first obtain the column value by using the Field method. その後、列の値を別の型に変換する必要があります。The column value should then be converted to another type.

Field<T>(DataRow, String)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, String) method also supports nullable types.

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);
static member Field : System.Data.DataRow * string -> 'T
<Extension()>
Public Function Field(Of T) (row As DataRow, columnName As String) As T

型パラメーター

T

列の戻り値の型を指定するジェネリック パラメーター。A generic parameter that specifies the return type of the column.

パラメーター

row
DataRow

拡張メソッドの this インスタンスとして機能する入力 DataRowThe input DataRow, which acts as the this instance for the extension method.

columnName
String

値を取得する列の名前。The name of the column to return the value of.

戻り値

T

T で指定された DataColumncolumnName 型の値。The value, of type T, of the DataColumn specified by columnName.

例外

基になる列値の型を、ジェネリック パラメーター T で指定された型にキャストできませんでした。The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

columnName で指定された列は、DataTable が属している DataRow には存在しません。The column specified by columnName does not occur in the DataTable that the DataRow is a part of.

Null 非許容型に null 値が割り当てられました。A null value was assigned to a non-nullable type.

注釈

クラスは、 DataSet クラスのインスタンスを使用してnull値を表し Value DBNull ます。The DataSet class represents null values with the Value instance of the DBNull class. 統合言語クエリ (LINQ: Language-Integrated Query)Language-Integrated Query (LINQ) Null値を持つ列にアクセスした式では、実行時にが生成さ InvalidCastException れます。A 統合言語クエリ (LINQ: Language-Integrated Query)Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. また、 DataSet は null 許容型をサポートしていません。Additionally, DataSet does not support nullable types. メソッドは、 Field null 許容型として列にアクセスするためのサポートを提供します。The Field method provides support for accessing columns as nullable types. の基になる値がの場合 DataSet Value 、返される null 許容型の値はnullになります。If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

指定したの値 DataColumnnullで、 T が参照型または null 許容型である場合、戻り値の型はnullになります。If the value of the specified DataColumn is null and T is a reference type or nullable type, the return type will be null. メソッドはを Field 返しません ValueThe Field method will not return Value.

メソッドは、 Field 型変換を実行しません。The Field method does not perform type conversions. 型変換が必要な場合は、最初にメソッドを使用して列の値を取得する必要があり Field ます。If type conversion is required, you should first obtain the column value by using the Field method. その後、列の値を別の型に変換する必要があります。The column value should then be converted to another type.

Field<T>(DataRow, DataColumn, DataRowVersion)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn, DataRowVersion) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

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);
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

列の戻り値の型を指定するジェネリック パラメーター。A generic parameter that specifies the return type of the column.

パラメーター

row
DataRow

拡張メソッドの this インスタンスとして機能する入力 DataRowThe input DataRow, which acts as the this instance for the extension method.

column
DataColumn

どの列の値を取得するかを指定する入力 DataColumn オブジェクト。The input DataColumn object that specifies the column to return the value of.

version
DataRowVersion

取得する列の値のバージョン (CurrentOriginal など) を指定する DataRowVersion 列挙値。A DataRowVersion enumeration that specifies the version of the column value to return, such as Current or Original version.

戻り値

T

T および column で指定された DataColumnversion 型の値。The value, of type T, of the DataColumn specified by column and version.

例外

基になる列値の型を、ジェネリック パラメーター T で指定された型にキャストできませんでした。The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

column で指定された列は、DataTable が属している DataRow には存在しません。The column specified by column does not exist in the DataTable that the DataRow is a part of.

Null 非許容型に null 値が割り当てられました。A null value was assigned to a non-nullable type.

注釈

クラスは、 DataSet クラスのインスタンスを使用してnull値を表し Value DBNull ます。The DataSet class represents null values with the Value instance of the DBNull class. 統合言語クエリ (LINQ: Language-Integrated Query)Language-Integrated Query (LINQ) Null値を持つ列にアクセスした式では、実行時にが生成さ InvalidCastException れます。A 統合言語クエリ (LINQ: Language-Integrated Query)Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. また、は DataSet null 許容型をサポートしていません。Additionally, DataSet doesn't support nullable types. メソッドは、 Field null 許容型として列にアクセスするためのサポートを提供します。The Field method provides support for accessing columns as nullable types. の基になる値がの場合 DataSet Value 、返される null 許容型の値はnullになります。If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

指定したの値 DataColumn が null で、 T が参照型または null 許容型である場合、戻り値の型はnullになります。If the value of the specified DataColumn is null and T is a reference type or nullable type, then the return type will be null. メソッドはを Field 返しません ValueThe Field method will not return Value.

メソッドは、 Field 型変換を実行しません。The Field method does not perform type conversions. 型変換が必要な場合は、最初にメソッドを使用して列の値を取得する必要があり Field ます。If type conversion is required, you should first obtain the column value by using the Field method. その後、列の値を別の型に変換する必要があります。The column value should then be converted to another type.

Field<T>(DataRow, Int32, DataRowVersion)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32, DataRowVersion) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

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);
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

列の戻り値の型を指定するジェネリック パラメーター。A generic parameter that specifies the return type of the column.

パラメーター

row
DataRow

拡張メソッドの this インスタンスとして機能する入力 DataRowThe input DataRow, which acts as the this instance for the extension method.

columnIndex
Int32

取得する値が格納されている列の、0 から始まる序数。The zero-based ordinal of the column to return the value of.

version
DataRowVersion

取得する列の値のバージョン (CurrentOriginal など) を指定する DataRowVersion 列挙値。A DataRowVersion enumeration that specifies the version of the column value to return, such as Current or Original version.

戻り値

T

T および ordinal で指定された DataColumnversion 型の値。The value, of type T, of the DataColumn specified by ordinal and version.

例外

基になる列値の型を、ジェネリック パラメーター T で指定された型にキャストできませんでした。The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

ordinal で指定された列は、DataTable が属している DataRow には存在しません。The column specified by ordinal does not exist in the DataTable that the DataRow is a part of.

Null 非許容型に null 値が割り当てられました。A null value was assigned to a non-nullable type.

注釈

クラスは、 DataSet クラスのインスタンスを使用してnull値を表し Value DBNull ます。The DataSet class represents null values with the Value instance of the DBNull class. 統合言語クエリ (LINQ: Language-Integrated Query)Language-Integrated Query (LINQ) Null値を持つ列にアクセスした式では、実行時にが生成さ InvalidCastException れます。A 統合言語クエリ (LINQ: Language-Integrated Query)Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. また、は DataSet null 許容型をサポートしていません。Additionally, DataSet doesn't support nullable types. メソッドは、 Field null 許容型として列にアクセスするためのサポートを提供します。The Field method provides support for accessing columns as nullable types. の基になる値がの場合 DataSet Value 、返される null 許容型の値はnullになります。If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

指定したの値 DataColumn が null で、 T が参照型または null 許容型である場合、戻り値の型はnullになります。If the value of the specified DataColumn is null and T is a reference type or nullable type, then the return type will be null. メソッドはを Field 返しません ValueThe Field method will not return Value.

メソッドは、 Field 型変換を実行しません。The Field method does not perform type conversions. 型変換が必要な場合は、最初にメソッドを使用して列の値を取得する必要があり Field ます。If type conversion is required, you should first obtain the column value by using the Field method. その後、列の値を別の型に変換する必要があります。The column value should then be converted to another type.

Field<T>(DataRow, String, DataRowVersion)

指定された行の個々の列値に対し、型を厳密に指定してアクセスできます。Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String, DataRowVersion) メソッドは Null 許容型もサポートします。The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

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);
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

列の戻り値の型を指定するジェネリック パラメーター。A generic parameter that specifies the return type of the column.

パラメーター

row
DataRow

拡張メソッドの this インスタンスとして機能する入力 DataRowThe input DataRow, which acts as the this instance for the extension method.

columnName
String

値を取得する列の名前。The name of the column to return the value of.

version
DataRowVersion

取得する列の値のバージョン (CurrentOriginal など) を指定する DataRowVersion 列挙値。A DataRowVersion enumeration that specifies the version of the column value to return, such as Current or Original version.

戻り値

T

T および columnName で指定された DataColumnversion 型の値。The value, of type T, of the DataColumn specified by columnName and version.

例外

基になる列値の型を、ジェネリック パラメーター T で指定された型にキャストできませんでした。The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

columnName で指定された列は、DataTable が属している DataRow には存在しません。The column specified by columnName does not exist in the DataTable that the DataRow is a part of.

Null 非許容型に null 値が割り当てられました。A null value was assigned to a non-nullable type.

注釈

クラスは、 DataSet クラスのインスタンスを使用してnull値を表し Value DBNull ます。The DataSet class represents null values with the Value instance of the DBNull class. 統合言語クエリ (LINQ: Language-Integrated Query)Language-Integrated Query (LINQ) Null値を持つ列にアクセスした式では、実行時にが生成さ InvalidCastException れます。A 統合言語クエリ (LINQ: Language-Integrated Query)Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. また、は DataSet null 許容型をサポートしていません。Additionally, DataSet doesn't support nullable types. メソッドは、 Field null 許容型として列にアクセスするためのサポートを提供します。The Field method provides support for accessing columns as nullable types. の基になる値がの場合 DataSet Value 、返される null 許容型の値はnullになります。If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

指定したの値 DataColumn が null で、 T が参照型または null 許容型である場合、戻り値の型はnullになります。If the value of the specified DataColumn is null and T is a reference type or nullable type, then the return type will be null. メソッドはを Field 返しません ValueThe Field method will not return Value.

メソッドは、 Field 型変換を実行しません。The Field method does not perform type conversions. 型変換が必要な場合は、最初にメソッドを使用して列の値を取得する必要があり Field ます。If type conversion is required, you should first obtain the column value by using the Field method. その後、列の値を別の型に変換する必要があります。The column value should then be converted to another type.

適用対象