DataRowExtensions.Field DataRowExtensions.Field DataRowExtensions.Field DataRowExtensions.Field Method

Definição

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.

Sobrecargas

Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) 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 que permitem valor nulo.The Field<T>(DataRow, DataColumn) method also supports nullable types.

Field<T>(DataRow, Int32) Field<T>(DataRow, Int32) Field<T>(DataRow, Int32) 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 que permitem valor nulo.The Field<T>(DataRow, Int32) method also supports nullable types.

Field<T>(DataRow, String) Field<T>(DataRow, String) Field<T>(DataRow, String) 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 que permitem valor nulo.The Field<T>(DataRow, String) method also supports nullable types.

Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion) 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 que permitem valor nulo.The Field<T>(DataRow, DataColumn, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion) 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 que permitem valor nulo.The Field<T>(DataRow, Int32, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion) 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 que permitem valor nulo.The Field<T>(DataRow, String, DataRowVersion) method also supports nullable types.

Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) Field<T>(DataRow, DataColumn) 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 que permitem valor nulo.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

Parâmetros de tipo

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.

Parâmetros

row
DataRow DataRow DataRow DataRow

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

column
DataColumn DataColumn DataColumn 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.

Retornos

T T T T

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

Exceções

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.

Comentários

O DataSet classe representa nulo valores com o Value instância da DBNull classe.The DataSet class represents null values with the Value instance of the DBNull class. Um LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expressão que é acessado de uma coluna com um nulo valor 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 que permitem valor nulos.Additionally, DataSet does not support nullable types. O Field método fornece suporte para acessar as colunas como tipos anuláveis.The Field method provides support for accessing columns as nullable types. Se subjacente valor na DataSet está Value, o tipo que permite valor nulo retornado terá um valor de nulo.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Se o valor especificado DataColumn está Value e T é 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 Field método não retornará Value.The Field method will not return Value.

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

Field<T>(DataRow, Int32) Field<T>(DataRow, Int32) Field<T>(DataRow, Int32) 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 que permitem valor nulo.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

Parâmetros de tipo

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.

Parâmetros

row
DataRow DataRow DataRow DataRow

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

columnIndex
Int32 Int32 Int32 Int32

O índice da coluna.The column index.

Retornos

T T T T

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

Exceções

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.

Comentários

O DataSet classe representa nulo valores com o Value instância da DBNull classe.The DataSet class represents null values with the Value instance of the DBNull class. Um LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expressão que é acessado de uma coluna com um nulo valor 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 Field método fornece suporte para acessar as colunas como tipos anuláveis.The Field method provides support for accessing columns as nullable types. Se subjacente valor na DataSet está Value, o tipo que permite valor nulo retornado terá um valor de nulo.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Se o valor especificado DataColumn está nulo e T é 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, then the return type will be null. O Field método não retornará Value.The Field method will not return Value.

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

Field<T>(DataRow, String) Field<T>(DataRow, String) Field<T>(DataRow, String) 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 que permitem valor nulo.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

Parâmetros de tipo

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.

Parâmetros

row
DataRow DataRow DataRow DataRow

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

columnName
String String String String

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

Retornos

T T T T

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

Exceções

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.

Comentários

O DataSet classe representa nulo valores com o Value instância da DBNull classe.The DataSet class represents null values with the Value instance of the DBNull class. Um LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expressão que é acessado de uma coluna com um nulo valor 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 que permitem valor nulos.Additionally, DataSet does not support nullable types. O Field método fornece suporte para acessar as colunas como tipos anuláveis.The Field method provides support for accessing columns as nullable types. Se subjacente valor na DataSet está Value, o tipo que permite valor nulo retornado terá um valor de nulo.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Se o valor especificado DataColumn está nulo e T é 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 Field método não retornará Value.The Field method will not return Value.

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

Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion) Field<T>(DataRow, DataColumn, DataRowVersion) 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 que permitem valor nulo.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

Parâmetros de tipo

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.

Parâmetros

row
DataRow DataRow DataRow DataRow

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

column
DataColumn DataColumn DataColumn 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 DataRowVersion DataRowVersion 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.

Retornos

T T T 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.

Exceções

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.

Comentários

O DataSet classe representa nulo valores com o Value instância da DBNull classe.The DataSet class represents null values with the Value instance of the DBNull class. Um LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expressão que é acessado de uma coluna com um nulo valor 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 Field método fornece suporte para acessar as colunas como tipos anuláveis.The Field method provides support for accessing columns as nullable types. Se subjacente valor na DataSet está Value, o tipo que permite valor nulo retornado terá um valor de nulo.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Se o valor especificado DataColumn for null e T é 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, then the return type will be null. O Field método não retornará Value.The Field method will not return Value.

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

Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion) Field<T>(DataRow, Int32, DataRowVersion) 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 que permitem valor nulo.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

Parâmetros de tipo

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.

Parâmetros

row
DataRow DataRow DataRow DataRow

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

columnIndex
Int32 Int32 Int32 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 DataRowVersion DataRowVersion 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.

Retornos

T T T 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.

Exceções

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.

Comentários

O DataSet classe representa nulo valores com o Value instância da DBNull classe.The DataSet class represents null values with the Value instance of the DBNull class. Um LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expressão que é acessado de uma coluna com um nulo valor 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 Field método fornece suporte para acessar as colunas como tipos anuláveis.The Field method provides support for accessing columns as nullable types. Se subjacente valor na DataSet está Value, o tipo que permite valor nulo retornado terá um valor de nulo.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Se o valor especificado DataColumn for null e T é 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, then the return type will be null. O Field método não retornará Value.The Field method will not return Value.

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

Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion) Field<T>(DataRow, String, DataRowVersion) 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 que permitem valor nulo.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

Parâmetros de tipo

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.

Parâmetros

row
DataRow DataRow DataRow DataRow

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

columnName
String String String String

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

version
DataRowVersion DataRowVersion DataRowVersion 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.

Retornos

T T T 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.

Exceções

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.

Comentários

O DataSet classe representa nulo valores com o Value instância da DBNull classe.The DataSet class represents null values with the Value instance of the DBNull class. Um LINQ (Consulta Integrada à Linguagem)Language-Integrated Query (LINQ) expressão que é acessado de uma coluna com um nulo valor 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 Field método fornece suporte para acessar as colunas como tipos anuláveis.The Field method provides support for accessing columns as nullable types. Se subjacente valor na DataSet está Value, o tipo que permite valor nulo retornado terá um valor de nulo.If the underlying value in the DataSet is Value, the returned nullable type will have a value of null.

Se o valor especificado DataColumn for null e T é 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, then the return type will be null. O Field método não retornará Value.The Field method will not return Value.

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

Aplica-se a