DataRowExtensions.Field Method

Definition

Fornece acesso fortemente tipado a cada um dos valores da coluna na DataRow.Provides strongly-typed access to each of the column values in the DataRow.

Overloads

Field<T>(DataRow, DataColumn)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, DataColumn) também dá suporte a tipos anuláveis.The Field<T>(DataRow, DataColumn) method also supports nullable types.

Field<T>(DataRow, Int32)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, Int32) também dá suporte a tipos anuláveis.The Field<T>(DataRow, Int32) method also supports nullable types.

Field<T>(DataRow, String)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, String) também dá suporte a tipos anuláveis.The Field<T>(DataRow, String) method also supports nullable types.

Field<T>(DataRow, DataColumn, DataRowVersion)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, DataColumn, DataRowVersion) também dá suporte a tipos anuláveis.The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, Int32, DataRowVersion)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, Int32, DataRowVersion) também dá suporte a tipos anuláveis.The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, String, DataRowVersion)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, String, DataRowVersion) também dá suporte a tipos anuláveis.The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, DataColumn)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, DataColumn) também dá suporte a tipos anuláveis.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

Type Parameters

T

Um parâmetro genérico que especifica o tipo de retorno da coluna.A generic parameter that specifies the return type of the column.

Parameters

row
DataRow

A entrada DataRow, que atua como a instância this para o método de extensão.The input DataRow, which acts as the this instance for the extension method.

column
DataColumn

O objeto DataColumn de entrada que especifica a coluna cujo valor deverá ser retornado.The input DataColumn object that specifies the column to return the value of.

Returns

T

O valor, do tipo T, do DataColumn especificado por column.The value, of type T, of the DataColumn specified by column.

Exceptions

Não foi possível converter o tipo de valor da coluna subjacente no tipo especificado pelo parâmetro genérico, T.The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

A coluna especificada por column não ocorre no DataTable do qual o DataRow faz parte.The column specified by column does not occur in the DataTable that the DataRow is a part of.

Um valor null foi atribuído a um tipo que não permite valor null.A null value was assigned to a non-nullable type.

Remarks

A classe DataSet representa valores nulos com a instância Value da classe DBNull.The DataSet class represents null values with the Value instance of the DBNull class. Uma LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expressão que acessou uma coluna com um valor nulo geraria um InvalidCastException em tempo de execução.A LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. Além disso, DataSet não oferece suporte a tipos anuláveis.Additionally, DataSet does not support nullable types. O método Field fornece suporte para acessar colunas como tipos anuláveis.The Field method provides support for accessing columns as nullable types. Se o valor subjacente no DataSet for Value, o tipo anulável retornado terá um valor de NULL.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Se o valor do DataColumn especificado for Value e T for um tipo de referência ou tipo anulável, o tipo de retorno será nulo.If the value of the specified DataColumn is Value and T is a reference type or nullable type, the return type will be null. O método Field não retornará Value.The Field method will not return Value.

O método Field não executa conversões de tipo.The Field method does not perform type conversions. Se a conversão de tipo for necessária, você deverá primeiro obter o valor da coluna usando o método Field.If type conversion is required, you should first obtain the column value by using the Field method. O valor da coluna deve então ser convertido em outro tipo.The column value should then be converted to another type.

Field<T>(DataRow, Int32)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, Int32) também dá suporte a tipos anuláveis.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

Type Parameters

T

Um parâmetro genérico que especifica o tipo de retorno da coluna.A generic parameter that specifies the return type of the column.

Parameters

row
DataRow

A entrada DataRow, que atua como a instância this para o método de extensão.The input DataRow, which acts as the this instance for the extension method.

columnIndex
Int32

O índice da coluna.The column index.

Returns

T

O valor, do tipo T, do DataColumn especificado por columnIndex.The value, of type T, of the DataColumn specified by columnIndex.

Exceptions

Não foi possível converter o tipo de valor da coluna subjacente no tipo especificado pelo parâmetro genérico, T.The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

A coluna especificada por ordinal não existe na DataTable da qual a DataRow faz parte.The column specified by ordinal does not exist in the DataTable that the DataRow is a part of.

Um valor null foi atribuído a um tipo que não permite valor null.A null value was assigned to a non-nullable type.

Remarks

A classe DataSet representa valores nulos com a instância Value da classe DBNull.The DataSet class represents null values with the Value instance of the DBNull class. Uma LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expressão que acessou uma coluna com um valor nulo geraria um InvalidCastException em tempo de execução.A LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. Além disso, DataSet não dá suporte a tipos anuláveis.Additionally, DataSet doesn't support nullable types. O método Field fornece suporte para acessar colunas como tipos anuláveis.The Field method provides support for accessing columns as nullable types. Se o valor subjacente no DataSet for Value, o tipo anulável retornado terá um valor de NULL.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Se o valor do DataColumn especificado for nulo e T for um tipo de referência ou tipo anulável, o tipo de retorno será 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. O método Field não retornará Value.The Field method will not return Value.

O método Field não executa conversões de tipo.The Field method does not perform type conversions. Se a conversão de tipo for necessária, você deverá primeiro obter o valor da coluna usando o método Field.If type conversion is required, you should first obtain the column value by using the Field method. O valor da coluna deve então ser convertido em outro tipo.The column value should then be converted to another type.

Field<T>(DataRow, String)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, String) também dá suporte a tipos anuláveis.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

Type Parameters

T

Um parâmetro genérico que especifica o tipo de retorno da coluna.A generic parameter that specifies the return type of the column.

Parameters

row
DataRow

A entrada DataRow, que atua como a instância this para o método de extensão.The input DataRow, which acts as the this instance for the extension method.

columnName
String

O nome da coluna para o qual o valor será retornado.The name of the column to return the value of.

Returns

T

O valor, do tipo T, do DataColumn especificado por columnName.The value, of type T, of the DataColumn specified by columnName.

Exceptions

Não foi possível converter o tipo de valor da coluna subjacente no tipo especificado pelo parâmetro genérico, T.The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

A coluna especificada por columnName não ocorre no DataTable do qual o DataRow faz parte.The column specified by columnName does not occur in the DataTable that the DataRow is a part of.

Um valor null foi atribuído a um tipo que não permite valor null.A null value was assigned to a non-nullable type.

Remarks

A classe DataSet representa valores nulos com a instância Value da classe DBNull.The DataSet class represents null values with the Value instance of the DBNull class. Uma LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expressão que acessou uma coluna com um valor nulo geraria um InvalidCastException em tempo de execução.A LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. Além disso, DataSet não oferece suporte a tipos anuláveis.Additionally, DataSet does not support nullable types. O método Field fornece suporte para acessar colunas como tipos anuláveis.The Field method provides support for accessing columns as nullable types. Se o valor subjacente no DataSet for Value, o tipo anulável retornado terá um valor de NULL.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Se o valor do DataColumn especificado for nulo e T for um tipo de referência ou tipo anulável, o tipo de retorno será nulo.If the value of the specified DataColumn is null and T is a reference type or nullable type, the return type will be null. O método Field não retornará Value.The Field method will not return Value.

O método Field não executa conversões de tipo.The Field method does not perform type conversions. Se a conversão de tipo for necessária, você deverá primeiro obter o valor da coluna usando o método Field.If type conversion is required, you should first obtain the column value by using the Field method. O valor da coluna deve então ser convertido em outro tipo.The column value should then be converted to another type.

Field<T>(DataRow, DataColumn, DataRowVersion)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, DataColumn, DataRowVersion) também dá suporte a tipos anuláveis.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

Type Parameters

T

Um parâmetro genérico que especifica o tipo de retorno da coluna.A generic parameter that specifies the return type of the column.

Parameters

row
DataRow

A entrada DataRow, que atua como a instância this para o método de extensão.The input DataRow, which acts as the this instance for the extension method.

column
DataColumn

O objeto DataColumn de entrada que especifica a coluna cujo valor deverá ser retornado.The input DataColumn object that specifies the column to return the value of.

version
DataRowVersion

Uma enumeração DataRowVersion que especifica a versão do valor da coluna a ser retornada, como a versão Current ou Original.A DataRowVersion enumeration that specifies the version of the column value to return, such as Current or Original version.

Returns

T

O valor, do tipo T, do DataColumn especificado por column e version.The value, of type T, of the DataColumn specified by column and version.

Exceptions

Não foi possível converter o tipo de valor da coluna subjacente no tipo especificado pelo parâmetro genérico, T.The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

A coluna especificada por column não existe na DataTable da qual a DataRow faz parte.The column specified by column does not exist in the DataTable that the DataRow is a part of.

Um valor null foi atribuído a um tipo que não permite valor null.A null value was assigned to a non-nullable type.

Remarks

A classe DataSet representa valores nulos com a instância Value da classe DBNull.The DataSet class represents null values with the Value instance of the DBNull class. Uma LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expressão que acessou uma coluna com um valor nulo geraria um InvalidCastException em tempo de execução.A LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. Além disso, DataSet não dá suporte a tipos anuláveis.Additionally, DataSet doesn't support nullable types. O método Field fornece suporte para acessar colunas como tipos anuláveis.The Field method provides support for accessing columns as nullable types. Se o valor subjacente no DataSet for Value, o tipo anulável retornado terá um valor de NULL.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Se o valor do DataColumn especificado for nulo e T for um tipo de referência ou tipo anulável, o tipo de retorno será 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. O método Field não retornará Value.The Field method will not return Value.

O método Field não executa conversões de tipo.The Field method does not perform type conversions. Se a conversão de tipo for necessária, você deverá primeiro obter o valor da coluna usando o método Field.If type conversion is required, you should first obtain the column value by using the Field method. O valor da coluna deve então ser convertido em outro tipo.The column value should then be converted to another type.

Field<T>(DataRow, Int32, DataRowVersion)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, Int32, DataRowVersion) também dá suporte a tipos anuláveis.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

Type Parameters

T

Um parâmetro genérico que especifica o tipo de retorno da coluna.A generic parameter that specifies the return type of the column.

Parameters

row
DataRow

A entrada DataRow, que atua como a instância this para o método de extensão.The input DataRow, which acts as the this instance for the extension method.

columnIndex
Int32

A posição ordinal baseada em zero da coluna da qual retornar o valor.The zero-based ordinal of the column to return the value of.

version
DataRowVersion

Uma enumeração DataRowVersion que especifica a versão do valor da coluna a ser retornada, como a versão Current ou Original.A DataRowVersion enumeration that specifies the version of the column value to return, such as Current or Original version.

Returns

T

O valor, do tipo T, do DataColumn especificado por ordinal e version.The value, of type T, of the DataColumn specified by ordinal and version.

Exceptions

Não foi possível converter o tipo de valor da coluna subjacente no tipo especificado pelo parâmetro genérico, T.The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

A coluna especificada por ordinal não existe na DataTable da qual a DataRow faz parte.The column specified by ordinal does not exist in the DataTable that the DataRow is a part of.

Um valor null foi atribuído a um tipo que não permite valor null.A null value was assigned to a non-nullable type.

Remarks

A classe DataSet representa valores nulos com a instância Value da classe DBNull.The DataSet class represents null values with the Value instance of the DBNull class. Uma LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expressão que acessou uma coluna com um valor nulo geraria um InvalidCastException em tempo de execução.A LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. Além disso, DataSet não dá suporte a tipos anuláveis.Additionally, DataSet doesn't support nullable types. O método Field fornece suporte para acessar colunas como tipos anuláveis.The Field method provides support for accessing columns as nullable types. Se o valor subjacente no DataSet for Value, o tipo anulável retornado terá um valor de NULL.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Se o valor do DataColumn especificado for nulo e T for um tipo de referência ou tipo anulável, o tipo de retorno será 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. O método Field não retornará Value.The Field method will not return Value.

O método Field não executa conversões de tipo.The Field method does not perform type conversions. Se a conversão de tipo for necessária, você deverá primeiro obter o valor da coluna usando o método Field.If type conversion is required, you should first obtain the column value by using the Field method. O valor da coluna deve então ser convertido em outro tipo.The column value should then be converted to another type.

Field<T>(DataRow, String, DataRowVersion)

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada.Provides strongly-typed access to each of the column values in the specified row. O método Field<T>(DataRow, String, DataRowVersion) também dá suporte a tipos anuláveis.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

Type Parameters

T

Um parâmetro genérico que especifica o tipo de retorno da coluna.A generic parameter that specifies the return type of the column.

Parameters

row
DataRow

A entrada DataRow, que atua como a instância this para o método de extensão.The input DataRow, which acts as the this instance for the extension method.

columnName
String

O nome da coluna para o qual o valor será retornado.The name of the column to return the value of.

version
DataRowVersion

Uma enumeração DataRowVersion que especifica a versão do valor da coluna a ser retornada, como a versão Current ou Original.A DataRowVersion enumeration that specifies the version of the column value to return, such as Current or Original version.

Returns

T

O valor, do tipo T, do DataColumn especificado por columnName e version.The value, of type T, of the DataColumn specified by columnName and version.

Exceptions

Não foi possível converter o tipo de valor da coluna subjacente no tipo especificado pelo parâmetro genérico, T.The value type of the underlying column could not be cast to the type specified by the generic parameter, T.

A coluna especificada por columnName não existe na DataTable da qual a DataRow faz parte.The column specified by columnName does not exist in the DataTable that the DataRow is a part of.

Um valor null foi atribuído a um tipo que não permite valor null.A null value was assigned to a non-nullable type.

Remarks

A classe DataSet representa valores nulos com a instância Value da classe DBNull.The DataSet class represents null values with the Value instance of the DBNull class. Uma LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expressão que acessou uma coluna com um valor nulo geraria um InvalidCastException em tempo de execução.A LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expression that accessed a column with a null value would generate a InvalidCastException at run time. Além disso, DataSet não dá suporte a tipos anuláveis.Additionally, DataSet doesn't support nullable types. O método Field fornece suporte para acessar colunas como tipos anuláveis.The Field method provides support for accessing columns as nullable types. Se o valor subjacente no DataSet for Value, o tipo anulável retornado terá um valor de NULL.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Se o valor do DataColumn especificado for nulo e T for um tipo de referência ou tipo anulável, o tipo de retorno será 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. O método Field não retornará Value.The Field method will not return Value.

O método Field não executa conversões de tipo.The Field method does not perform type conversions. Se a conversão de tipo for necessária, você deverá primeiro obter o valor da coluna usando o método Field.If type conversion is required, you should first obtain the column value by using the Field method. O valor da coluna deve então ser convertido em outro tipo.The column value should then be converted to another type.

Applies to