DataRowExtensions.Field Metoda

Definicja

Przestrzeń nazw:
System.Data
Zestaw:
System.Data.DataSetExtensions.dll
Zestaw:
System.Data.Common.dll
Zestawy:
netstandard.dll, System.Data.DataSetExtensions.dll
Zestaw:
netstandard.dll

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w DataRow .Provides strongly-typed access to each of the column values in the DataRow.

Przeciążenia

Field<T>(DataRow, DataColumn)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn)Metoda obsługuje również Typy dopuszczające wartości null.The Field<T>(DataRow, DataColumn) method also supports nullable types.
Field<T>(DataRow, Int32)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32)Metoda obsługuje również Typy dopuszczające wartości null.The Field<T>(DataRow, Int32) method also supports nullable types.
Field<T>(DataRow, String)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String)Metoda obsługuje również Typy dopuszczające wartości null.The Field<T>(DataRow, String) method also supports nullable types.
Field<T>(DataRow, DataColumn, DataRowVersion)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn, DataRowVersion)Metoda obsługuje również Typy dopuszczające wartości null.The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.
Field<T>(DataRow, Int32, DataRowVersion)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32, DataRowVersion)Metoda obsługuje również Typy dopuszczające wartości null.The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.
Field<T>(DataRow, String, DataRowVersion)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String, DataRowVersion)Metoda obsługuje również Typy dopuszczające wartości null.The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, DataColumn)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn)Metoda obsługuje również Typy dopuszczające wartości 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);
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

Parametry typu

T

Parametr generyczny, który określa zwracany typ kolumny.A generic parameter that specifies the return type of the column.

Parametry

row
DataRow

Dane wejściowe DataRow , które pełnią rolę this wystąpienia metody rozszerzenia.The input DataRow, which acts as the this instance for the extension method.

column
DataColumn

Obiekt wejściowy DataColumn , który określa kolumnę, dla której ma zostać zwrócona wartość.The input DataColumn object that specifies the column to return the value of.

Zwraca

T

Wartość typu T DataColumn określonego przez column .The value, of type T, of the DataColumn specified by column.

Wyjątki

InvalidCastException

Nie można rzutować typu wartości kolumny źródłowej na typ określony przez parametr generyczny T .The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

IndexOutOfRangeException

Kolumna określona przez column nie występuje w elemencie, do DataTable którego należy DataRow .The column specified by column does not occur in the DataTable that the DataRow is a part of.

NullReferenceException

Wartość zerowa została przypisana do typu, który nie dopuszcza wartości null.A null value was assigned to a non-nullable type.

Uwagi

DataSetKlasa reprezentuje wartości null z Value wystąpieniem DBNull klasy.The DataSet class represents null values with the Value instance of the DBNull class. Wyrażenie Language-Integrated Query (LINQ), które uzyskuje dostęp do kolumny z wartością null , spowoduje wygenerowanie InvalidCastException w czasie wykonywania.A Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. Ponadto program nie DataSet obsługuje typów dopuszczających wartość null.Additionally, DataSet does not support nullable types. FieldMetoda zapewnia obsługę dostępu do kolumn jako typy dopuszczające wartości null.The Field method provides support for accessing columns as nullable types. Jeśli wartość bazowa w elemencie DataSet is Value , zwracany typ dopuszczający wartość null będzie miał wartością zerową.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Jeśli wartość określona DataColumn jest Value i T jest typem referencyjnym lub typem dopuszczającym wartość null, zwracany typ będzie miał wartość 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. FieldMetoda nie zostanie zwrócona Value .The Field method will not return Value.

FieldMetoda nie wykonuje konwersji typów.The Field method does not perform type conversions. Jeśli wymagana jest konwersja typu, należy najpierw uzyskać wartość kolumny przy użyciu Field metody.If type conversion is required, you should first obtain the column value by using the Field method. Wartość kolumny należy następnie przekonwertować na inny typ.The column value should then be converted to another type.

Dotyczy

Field<T>(DataRow, Int32)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32)Metoda obsługuje również Typy dopuszczające wartości 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);
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

Parametry typu

T

Parametr generyczny, który określa zwracany typ kolumny.A generic parameter that specifies the return type of the column.

Parametry

row
DataRow

Dane wejściowe DataRow , które pełnią rolę this wystąpienia metody rozszerzenia.The input DataRow, which acts as the this instance for the extension method.

columnIndex
Int32

Indeks kolumny.The column index.

Zwraca

T

Wartość typu T DataColumn określonego przez columnIndex .The value, of type T, of the DataColumn specified by columnIndex.

Wyjątki

InvalidCastException

Nie można rzutować typu wartości kolumny źródłowej na typ określony przez parametr generyczny T .The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

IndexOutOfRangeException

Kolumna określona przez ordinal nie istnieje w elemencie, do DataTable którego należy DataRow .The column specified by ordinal does not exist in the DataTable that the DataRow is a part of.

NullReferenceException

Wartość zerowa została przypisana do typu, który nie dopuszcza wartości null.A null value was assigned to a non-nullable type.

Uwagi

DataSetKlasa reprezentuje wartości null z Value wystąpieniem DBNull klasy.The DataSet class represents null values with the Value instance of the DBNull class. Wyrażenie Language-Integrated Query (LINQ), które uzyskuje dostęp do kolumny z wartością null , spowoduje wygenerowanie InvalidCastException w czasie wykonywania.A Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. Ponadto DataSet nie obsługuje typów dopuszczających wartość null.Additionally, DataSet doesn't support nullable types. FieldMetoda zapewnia obsługę dostępu do kolumn jako typy dopuszczające wartości null.The Field method provides support for accessing columns as nullable types. Jeśli wartość bazowa w elemencie DataSet is Value , zwracany typ dopuszczający wartość null będzie miał wartością zerową.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Jeśli wartość określona DataColumn ma wartość null i T jest typem referencyjnym lub typem dopuszczającym wartość null, zwracany typ będzie miał wartość 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. FieldMetoda nie zostanie zwrócona Value .The Field method will not return Value.

FieldMetoda nie wykonuje konwersji typów.The Field method does not perform type conversions. Jeśli wymagana jest konwersja typu, należy najpierw uzyskać wartość kolumny przy użyciu Field metody.If type conversion is required, you should first obtain the column value by using the Field method. Wartość kolumny należy następnie przekonwertować na inny typ.The column value should then be converted to another type.

Dotyczy

Field<T>(DataRow, String)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String)Metoda obsługuje również Typy dopuszczające wartości 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);
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

Parametry typu

T

Parametr generyczny, który określa zwracany typ kolumny.A generic parameter that specifies the return type of the column.

Parametry

row
DataRow

Dane wejściowe DataRow , które pełnią rolę this wystąpienia metody rozszerzenia.The input DataRow, which acts as the this instance for the extension method.

columnName
String

Nazwa kolumny, dla której ma zostać zwrócona wartość.The name of the column to return the value of.

Zwraca

T

Wartość typu T DataColumn określonego przez columnName .The value, of type T, of the DataColumn specified by columnName.

Wyjątki

InvalidCastException

Nie można rzutować typu wartości kolumny źródłowej na typ określony przez parametr generyczny T .The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

IndexOutOfRangeException

Kolumna określona przez columnName nie występuje w elemencie, do DataTable którego należy DataRow .The column specified by columnName does not occur in the DataTable that the DataRow is a part of.

NullReferenceException

nullWartość została przypisana do typu, który nie dopuszcza wartości null.A null value was assigned to a non-nullable type.

Uwagi

DataSetKlasa reprezentuje wartości null z Value wystąpieniem DBNull klasy.The DataSet class represents null values with the Value instance of the DBNull class. Wyrażenie Language-Integrated Query (LINQ), które uzyskuje dostęp do kolumny z wartością null , spowoduje wygenerowanie InvalidCastException w czasie wykonywania.A Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. Ponadto program nie DataSet obsługuje typów dopuszczających wartość null.Additionally, DataSet does not support nullable types. FieldMetoda zapewnia obsługę dostępu do kolumn jako typy dopuszczające wartości null.The Field method provides support for accessing columns as nullable types. Jeśli wartość bazowa w elemencie DataSet is Value , zwracany typ dopuszczający wartość null będzie miał wartością zerową.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Jeśli określona wartość DataColumn ma wartość null i T jest typem referencyjnym lub typem dopuszczającym wartość null, zwracany typ będzie miał wartość 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. FieldMetoda nie zostanie zwrócona Value .The Field method will not return Value.

FieldMetoda nie wykonuje konwersji typów.The Field method does not perform type conversions. Jeśli wymagana jest konwersja typu, należy najpierw uzyskać wartość kolumny przy użyciu Field metody.If type conversion is required, you should first obtain the column value by using the Field method. Wartość kolumny należy następnie przekonwertować na inny typ.The column value should then be converted to another type.

Dotyczy

Field<T>(DataRow, DataColumn, DataRowVersion)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, DataColumn, DataRowVersion)Metoda obsługuje również Typy dopuszczające wartości 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);
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

Parametry typu

T

Parametr generyczny, który określa zwracany typ kolumny.A generic parameter that specifies the return type of the column.

Parametry

row
DataRow

Dane wejściowe DataRow , które pełnią rolę this wystąpienia metody rozszerzenia.The input DataRow, which acts as the this instance for the extension method.

column
DataColumn

Obiekt wejściowy DataColumn , który określa kolumnę, dla której ma zostać zwrócona wartość.The input DataColumn object that specifies the column to return the value of.

version
DataRowVersion

DataRowVersionWyliczenie określające wersję wartości kolumny, która ma zostać zwrócona, na przykład Current lub Original wersję.A DataRowVersion enumeration that specifies the version of the column value to return, such as Current or Original version.

Zwraca

T

Wartość typu T DataColumn określonego przez column i version .The value, of type T, of the DataColumn specified by column and version.

Wyjątki

InvalidCastException

Nie można rzutować typu wartości kolumny źródłowej na typ określony przez parametr generyczny T .The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

IndexOutOfRangeException

Kolumna określona przez column nie istnieje w elemencie, do DataTable którego należy DataRow .The column specified by column does not exist in the DataTable that the DataRow is a part of.

NullReferenceException

Wartość zerowa została przypisana do typu, który nie dopuszcza wartości null.A null value was assigned to a non-nullable type.

Uwagi

DataSetKlasa reprezentuje wartości null z Value wystąpieniem DBNull klasy.The DataSet class represents null values with the Value instance of the DBNull class. Wyrażenie Language-Integrated Query (LINQ), które uzyskuje dostęp do kolumny z wartością null , spowoduje wygenerowanie InvalidCastException w czasie wykonywania.A Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. Ponadto DataSet nie obsługuje typów dopuszczających wartość null.Additionally, DataSet doesn't support nullable types. FieldMetoda zapewnia obsługę dostępu do kolumn jako typy dopuszczające wartości null.The Field method provides support for accessing columns as nullable types. Jeśli wartość bazowa w elemencie DataSet is Value , zwracany typ dopuszczający wartość null będzie miał wartością zerową.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Jeśli wartość określona DataColumn ma wartość null i T jest typem referencyjnym lub typem dopuszczającym wartość null, zwracany typ będzie miał wartość 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. FieldMetoda nie zostanie zwrócona Value .The Field method will not return Value.

FieldMetoda nie wykonuje konwersji typów.The Field method does not perform type conversions. Jeśli wymagana jest konwersja typu, należy najpierw uzyskać wartość kolumny przy użyciu Field metody.If type conversion is required, you should first obtain the column value by using the Field method. Wartość kolumny należy następnie przekonwertować na inny typ.The column value should then be converted to another type.

Dotyczy

Field<T>(DataRow, Int32, DataRowVersion)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, Int32, DataRowVersion)Metoda obsługuje również Typy dopuszczające wartości 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);
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

Parametry typu

T

Parametr generyczny, który określa zwracany typ kolumny.A generic parameter that specifies the return type of the column.

Parametry

row
DataRow

Dane wejściowe DataRow , które pełnią rolę this wystąpienia metody rozszerzenia.The input DataRow, which acts as the this instance for the extension method.

columnIndex
Int32

Numer porządkowy od zera kolumny, która ma zwracać wartość.The zero-based ordinal of the column to return the value of.

version
DataRowVersion

DataRowVersionWyliczenie określające wersję wartości kolumny, która ma zostać zwrócona, na przykład Current lub Original wersję.A DataRowVersion enumeration that specifies the version of the column value to return, such as Current or Original version.

Zwraca

T

Wartość typu T DataColumn określonego przez ordinal i version .The value, of type T, of the DataColumn specified by ordinal and version.

Wyjątki

InvalidCastException

Nie można rzutować typu wartości kolumny źródłowej na typ określony przez parametr generyczny T .The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

IndexOutOfRangeException

Kolumna określona przez ordinal nie istnieje w elemencie, do DataTable którego należy DataRow .The column specified by ordinal does not exist in the DataTable that the DataRow is a part of.

NullReferenceException

Wartość zerowa została przypisana do typu, który nie dopuszcza wartości null.A null value was assigned to a non-nullable type.

Uwagi

DataSetKlasa reprezentuje wartości null z Value wystąpieniem DBNull klasy.The DataSet class represents null values with the Value instance of the DBNull class. Wyrażenie Language-Integrated Query (LINQ), które uzyskuje dostęp do kolumny z wartością null , spowoduje wygenerowanie InvalidCastException w czasie wykonywania.A Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. Ponadto DataSet nie obsługuje typów dopuszczających wartość null.Additionally, DataSet doesn't support nullable types. FieldMetoda zapewnia obsługę dostępu do kolumn jako typy dopuszczające wartości null.The Field method provides support for accessing columns as nullable types. Jeśli wartość bazowa w elemencie DataSet is Value , zwracany typ dopuszczający wartość null będzie miał wartością zerową.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Jeśli wartość określona DataColumn ma wartość null i T jest typem referencyjnym lub typem dopuszczającym wartość null, zwracany typ będzie miał wartość 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. FieldMetoda nie zostanie zwrócona Value .The Field method will not return Value.

FieldMetoda nie wykonuje konwersji typów.The Field method does not perform type conversions. Jeśli wymagana jest konwersja typu, należy najpierw uzyskać wartość kolumny przy użyciu Field metody.If type conversion is required, you should first obtain the column value by using the Field method. Wartość kolumny należy następnie przekonwertować na inny typ.The column value should then be converted to another type.

Dotyczy

Field<T>(DataRow, String, DataRowVersion)

Zapewnia jednoznacznie dostęp do każdej wartości kolumny w określonym wierszu.Provides strongly-typed access to each of the column values in the specified row. Field<T>(DataRow, String, DataRowVersion)Metoda obsługuje również Typy dopuszczające wartości 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);
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

Parametry typu

T

Parametr generyczny, który określa zwracany typ kolumny.A generic parameter that specifies the return type of the column.

Parametry

row
DataRow

Dane wejściowe DataRow , które pełnią rolę this wystąpienia metody rozszerzenia.The input DataRow, which acts as the this instance for the extension method.

columnName
String

Nazwa kolumny, dla której ma zostać zwrócona wartość.The name of the column to return the value of.

version
DataRowVersion

DataRowVersionWyliczenie określające wersję wartości kolumny, która ma zostać zwrócona, na przykład Current lub Original wersję.A DataRowVersion enumeration that specifies the version of the column value to return, such as Current or Original version.

Zwraca

T

Wartość typu T DataColumn określonego przez columnName i version .The value, of type T, of the DataColumn specified by columnName and version.

Wyjątki

InvalidCastException

Nie można rzutować typu wartości kolumny źródłowej na typ określony przez parametr generyczny T .The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

IndexOutOfRangeException

Kolumna określona przez columnName nie istnieje w elemencie, do DataTable którego należy DataRow .The column specified by columnName does not exist in the DataTable that the DataRow is a part of.

NullReferenceException

Wartość zerowa została przypisana do typu, który nie dopuszcza wartości null.A null value was assigned to a non-nullable type.

Uwagi

DataSetKlasa reprezentuje wartości null z Value wystąpieniem DBNull klasy.The DataSet class represents null values with the Value instance of the DBNull class. Wyrażenie Language-Integrated Query (LINQ), które uzyskuje dostęp do kolumny z wartością null , spowoduje wygenerowanie InvalidCastException w czasie wykonywania.A Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. Ponadto DataSet nie obsługuje typów dopuszczających wartość null.Additionally, DataSet doesn't support nullable types. FieldMetoda zapewnia obsługę dostępu do kolumn jako typy dopuszczające wartości null.The Field method provides support for accessing columns as nullable types. Jeśli wartość bazowa w elemencie DataSet is Value , zwracany typ dopuszczający wartość null będzie miał wartością zerową.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Jeśli wartość określona DataColumn ma wartość null i T jest typem referencyjnym lub typem dopuszczającym wartość null, zwracany typ będzie miał wartość 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. FieldMetoda nie zostanie zwrócona Value .The Field method will not return Value.

FieldMetoda nie wykonuje konwersji typów.The Field method does not perform type conversions. Jeśli wymagana jest konwersja typu, należy najpierw uzyskać wartość kolumny przy użyciu Field metody.If type conversion is required, you should first obtain the column value by using the Field method. Wartość kolumny należy następnie przekonwertować na inny typ.The column value should then be converted to another type.

Dotyczy