DataRowExtensions.Field Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Fornece acesso fortemente tipado a cada um dos valores da coluna na DataRow.

Sobrecargas

Field<T>(DataRow, DataColumn)	Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, DataColumn) também dá suporte a tipos que permitem valor nulo.
Field<T>(DataRow, Int32)	Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, Int32) também dá suporte a tipos que permitem valor nulo.
Field<T>(DataRow, String)	Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, String) também dá suporte a tipos que permitem valor nulo.
Field<T>(DataRow, DataColumn, DataRowVersion)	Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, DataColumn, DataRowVersion) também dá suporte a tipos que permitem valor nulo.
Field<T>(DataRow, Int32, DataRowVersion)	Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, Int32, DataRowVersion) também dá suporte a tipos que permitem valor nulo.
Field<T>(DataRow, String, DataRowVersion)	Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, String, DataRowVersion) também dá suporte a tipos que permitem valor nulo.

Field<T>(DataRow, DataColumn)

Origem:

DataRowExtensions.cs

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, DataColumn) também dá suporte a tipos que permitem valor nulo.

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.

Parâmetros

row

DataRow

O DataRow de entrada, que funciona como a instância this do método de extensão.

column

DataColumn

O objeto DataColumn de entrada que especifica a coluna cujo valor deverá ser retornado.

Retornos

T

O valor, do tipo T, do DataColumn especificado por column.

Exceções

InvalidCastException

Não foi possível converter o tipo de valor da coluna subjacente no tipo especificado pelo parâmetro genérico, T.

IndexOutOfRangeException

A coluna especificada por column não ocorre no DataTable do qual o DataRow faz parte.

NullReferenceException

Um valor null foi atribuído a um tipo que não permite valor null.

Comentários

A DataSet classe representa valores nulos com a Value instância da DBNull classe . Uma expressão linq (consulta Language-Integrated) que acessava uma coluna com um valor nulo geraria um InvalidCastException em tempo de execução. Além disso, DataSet e DataTable não dão suporte a tipos anuláveis. O Field método fornece suporte para acessar colunas como tipos anuláveis. Se o valor subjacente no DataSet for DBNull.Value, o tipo anulável retornado terá um valor nulo.

Se o valor do especificado DataColumn for DBNull.Value e T for um tipo de referência ou tipo anulável, o tipo de retorno será nulo. O Field método não retornará DBNull.Value.

O Field método não executa conversões de tipo. Se a conversão de tipo for necessária, primeiro você deverá obter o valor da coluna usando o Field método . Em seguida, o valor da coluna deve ser convertido em outro tipo.

Field<T>(DataRow, Int32)

Origem:

DataRowExtensions.cs

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, Int32) também dá suporte a tipos que permitem valor nulo.

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.

Parâmetros

row

DataRow

A entrada DataRow, que funciona como a instância this do método de extensão.

columnIndex

Int32

O índice da coluna.

Retornos

T

O valor, do tipo T, do DataColumn especificado por columnIndex.

Exceções

InvalidCastException

Não foi possível converter o tipo de valor da coluna subjacente no tipo especificado pelo parâmetro genérico, T.

IndexOutOfRangeException

A coluna especificada por ordinal não existe na DataTable da qual a DataRow faz parte.

NullReferenceException

Um valor null foi atribuído a um tipo que não permite valor null.

Comentários

A DataSet classe representa valores nulos com a Value instância da DBNull classe . Uma expressão linq (consulta Language-Integrated) que acessava uma coluna com um valor nulo geraria um InvalidCastException em tempo de execução. Além disso, DataSet não dá suporte a tipos anuláveis. O Field método fornece suporte para acessar colunas como tipos anuláveis. Se o valor subjacente no DataSet for DBNull.Value, o tipo anulável retornado terá um valor nulo.

Se o valor do especificado DataColumn for nulo e T for um tipo de referência ou tipo anulável, o tipo de retorno será nulo. O Field método não retornará DBNull.Value.

O Field método não executa conversões de tipo. Se a conversão de tipo for necessária, primeiro você deverá obter o valor da coluna usando o Field método . Em seguida, o valor da coluna deve ser convertido em outro tipo.

Field<T>(DataRow, String)

Origem:

DataRowExtensions.cs

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, String) também dá suporte a tipos que permitem valor nulo.

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.

Parâmetros

row

DataRow

A entrada DataRow, que funciona como a instância this do método de extensão.

columnName

String

O nome da coluna para o qual o valor será retornado.

Retornos

T

O valor, do tipo T, do DataColumn especificado por columnName.

Exceções

InvalidCastException

Não foi possível converter o tipo de valor da coluna subjacente no tipo especificado pelo parâmetro genérico, T.

IndexOutOfRangeException

A coluna especificada por columnName não ocorre no DataTable do qual o DataRow faz parte.

NullReferenceException

Um valor null foi atribuído a um tipo que não permite valor null.

Comentários

A DataSet classe representa valores nulos com a Value instância da DBNull classe . Uma expressão linq (consulta Language-Integrated) que acessava uma coluna com um valor nulo geraria um InvalidCastException em tempo de execução. Além disso, DataSet e DataTable não dão suporte a tipos anuláveis. O Field método fornece suporte para acessar colunas como tipos anuláveis. Se o valor subjacente no DataSet for DBNull.Value, o tipo anulável retornado terá um valor nulo.

Se o valor do especificado DataColumn for nulo e T for um tipo de referência ou tipo anulável, o tipo de retorno será nulo. O Field método não retornará DBNull.Value.

O Field método não executa conversões de tipo. Se a conversão de tipo for necessária, primeiro você deverá obter o valor da coluna usando o Field método . Em seguida, o valor da coluna deve ser convertido em outro tipo.

Field<T>(DataRow, DataColumn, DataRowVersion)

Origem:

DataRowExtensions.cs

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, DataColumn, DataRowVersion) também dá suporte a tipos que permitem valor nulo.

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.

Parâmetros

row

DataRow

O DataRow de entrada, que funciona como a instância this do método de extensão.

column

DataColumn

O objeto DataColumn de entrada que especifica a coluna cujo valor deverá ser retornado.

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.

Retornos

T

O valor, do tipo T, do DataColumn especificado por column e version.

Exceções

InvalidCastException

Não foi possível converter o tipo de valor da coluna subjacente no tipo especificado pelo parâmetro genérico, T.

IndexOutOfRangeException

A coluna especificada por column não existe na DataTable da qual a DataRow faz parte.

NullReferenceException

Um valor null foi atribuído a um tipo que não permite valor null.

Comentários

A DataSet classe representa valores nulos com a Value instância da DBNull classe . Uma expressão linq (consulta Language-Integrated) que acessava uma coluna com um valor nulo geraria um InvalidCastException em tempo de execução. Além disso, DataSet não dá suporte a tipos anuláveis. O Field método fornece suporte para acessar colunas como tipos anuláveis. Se o valor subjacente no DataSet for DBNull.Value, o tipo anulável retornado terá um valor nulo.

Se o valor do especificado DataColumn for nulo e T for um tipo de referência ou tipo anulável, o tipo de retorno será nulo. O Field método não retornará DBNull.Value.

O Field método não executa conversões de tipo. Se a conversão de tipo for necessária, primeiro você deverá obter o valor da coluna usando o Field método . Em seguida, o valor da coluna deve ser convertido em outro tipo.

Field<T>(DataRow, Int32, DataRowVersion)

Origem:

DataRowExtensions.cs

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, Int32, DataRowVersion) também dá suporte a tipos que permitem valor nulo.

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.

Parâmetros

row

DataRow

A entrada DataRow, que funciona como a instância this do método de extensão.

columnIndex

Int32

A posição ordinal baseada em zero da coluna da qual retornar o valor.

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.

Retornos

T

O valor, do tipo T, do DataColumn especificado por ordinal e version.

Exceções

InvalidCastException

Não foi possível converter o tipo de valor da coluna subjacente no tipo especificado pelo parâmetro genérico, T.

IndexOutOfRangeException

A coluna especificada por ordinal não existe na DataTable da qual a DataRow faz parte.

NullReferenceException

Um valor null foi atribuído a um tipo que não permite valor null.

Comentários

A DataSet classe representa valores nulos com a Value instância da DBNull classe . Uma expressão LINQ (Consulta Language-Integrated) que acessava uma coluna com um valor nulo geraria um InvalidCastException em tempo de execução. Além disso, DataSet não dá suporte a tipos anuláveis. O Field método fornece suporte para acessar colunas como tipos anuláveis. Se o valor subjacente no DataSet for DBNull.Value, o tipo que permite valor nulo retornado terá um valor nulo.

Se o valor do especificado DataColumn for nulo e T for um tipo de referência ou tipo anulável, o tipo de retorno será nulo. O Field método não retornará DBNull.Value.

O Field método não executa conversões de tipo. Se a conversão de tipo for necessária, primeiro você deverá obter o valor da coluna usando o Field método . Em seguida, o valor da coluna deve ser convertido em outro tipo.

Field<T>(DataRow, String, DataRowVersion)

Origem:

DataRowExtensions.cs

Fornece acesso fortemente tipado a cada um dos valores da coluna na linha especificada. O método Field<T>(DataRow, String, DataRowVersion) também dá suporte a tipos que permitem valor nulo.

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.

Parâmetros

row

DataRow

A entrada DataRow, que funciona como a instância this do método de extensão.

columnName

String

O nome da coluna para o qual o valor será retornado.

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.

Retornos

T

O valor, do tipo T, do DataColumn especificado por columnName e version.

Exceções

InvalidCastException

Não foi possível converter o tipo de valor da coluna subjacente no tipo especificado pelo parâmetro genérico, T.

IndexOutOfRangeException

A coluna especificada por columnName não existe na DataTable da qual a DataRow faz parte.

NullReferenceException

Um valor null foi atribuído a um tipo que não permite valor null.

Comentários

A DataSet classe representa valores nulos com a Value instância da DBNull classe . Uma expressão LINQ (Consulta Language-Integrated) que acessava uma coluna com um valor nulo geraria um InvalidCastException em tempo de execução. Além disso, DataSet não dá suporte a tipos anuláveis. O Field método fornece suporte para acessar colunas como tipos anuláveis. Se o valor subjacente no DataSet for DBNull.Value, o tipo que permite valor nulo retornado terá um valor nulo.

Se o valor do especificado DataColumn for nulo e T for um tipo de referência ou tipo anulável, o tipo de retorno será nulo. O Field método não retornará DBNull.Value.

O Field método não executa conversões de tipo. Se a conversão de tipo for necessária, primeiro você deverá obter o valor da coluna usando o Field método . Em seguida, o valor da coluna deve ser convertido em outro tipo.