DataRowExtensions.Field Método

Definição

Namespace:: System.Data

Assembly:: System.Data.DataSetExtensions.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece acesso fortemente tipado a cada um dos valores de coluna no DataRow.

Sobrecargas

Nome	Description
Field<T>(DataRow, DataColumn)	Fornece acesso fortemente tipado a cada um dos valores de coluna na linha especificada. O Field<T>(DataRow, DataColumn) método também dá suporte a tipos anuláveis.
Field<T>(DataRow, Int32)	Fornece acesso fortemente tipado a cada um dos valores de coluna na linha especificada. O Field<T>(DataRow, Int32) método também dá suporte a tipos anuláveis.
Field<T>(DataRow, String)	Fornece acesso fortemente tipado a cada um dos valores de coluna na linha especificada. O Field<T>(DataRow, String) método também dá suporte a tipos anuláveis.
Field<T>(DataRow, DataColumn, DataRowVersion)	Fornece acesso fortemente tipado a cada um dos valores de coluna na linha especificada. O Field<T>(DataRow, DataColumn, DataRowVersion) método também dá suporte a tipos anuláveis.
Field<T>(DataRow, Int32, DataRowVersion)	Fornece acesso fortemente tipado a cada um dos valores de coluna na linha especificada. O Field<T>(DataRow, Int32, DataRowVersion) método também dá suporte a tipos anuláveis.
Field<T>(DataRow, String, DataRowVersion)	Fornece acesso fortemente tipado a cada um dos valores de coluna na linha especificada. O Field<T>(DataRow, String, DataRowVersion) método também dá suporte a tipos anuláveis.

Field<T>(DataRow, DataColumn)

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

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

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

column: DataColumn

O objeto de entrada DataColumn que especifica a coluna da qual retornar o valor.

Retornos

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

Exceções

InvalidCastException

O tipo de valor da coluna subjacente não pôde ser convertido no tipo especificado pelo parâmetro genérico. T

IndexOutOfRangeException

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

NullReferenceException

Um valor nulo foi atribuído a um tipo não anulável.

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ê suporte a tipos anuláveis. O Field método fornece suporte para acessar colunas como tipos anuláveis. Se o valor subjacente estiver DataSet 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.

Aplica-se a

Field<T>(DataRow, Int32)

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

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

O tipo de retorno da coluna.

Parâmetros

row: DataRow

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

columnIndex: Int32

O índice de coluna.

Retornos

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

Exceções

InvalidCastException

O tipo de valor da coluna subjacente não pôde ser convertido no tipo especificado pelo parâmetro genérico. T

IndexOutOfRangeException

A coluna especificada por columnIndex não existe na DataTable qual faz DataRow parte.

NullReferenceException

Um valor nulo foi atribuído a um tipo não anulável.

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 estiver DataSet 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.

Aplica-se a

Field<T>(DataRow, String)

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

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 atua como a this instância do método de extensão.

columnName: String

O nome da coluna da qual retornar o valor.

Retornos

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

Exceções

InvalidCastException

O tipo de valor da coluna subjacente não pôde ser convertido no tipo especificado pelo parâmetro genérico. T

IndexOutOfRangeException

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

NullReferenceException

Um null valor foi atribuído a um tipo não anulável.

Comentários

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.

Aplica-se a

Field<T>(DataRow, DataColumn, DataRowVersion)

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

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

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

column: DataColumn

O objeto de entrada DataColumn que especifica a coluna da qual retornar o valor.

version: DataRowVersion

Uma DataRowVersion enumeração que especifica a versão do valor da coluna a ser retornada, como Current ou Original versão.

Retornos

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

Exceções

InvalidCastException

O tipo de valor da coluna subjacente não pôde ser convertido no tipo especificado pelo parâmetro genérico. T

IndexOutOfRangeException

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

NullReferenceException

Um valor nulo foi atribuído a um tipo não anulável.

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 estiver DataSet 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.

Aplica-se a

Field<T>(DataRow, Int32, DataRowVersion)

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

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 atua como a this instância do método de extensão.

columnIndex: Int32

O ordinal baseado em zero da coluna da qual retornar o valor.

version: DataRowVersion

Uma DataRowVersion enumeração que especifica a versão do valor da coluna a ser retornada, como Current ou Original versão.

Retornos

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

Exceções

InvalidCastException

O tipo de valor da coluna subjacente não pôde ser convertido no tipo especificado pelo parâmetro genérico. T

IndexOutOfRangeException

A coluna especificada por columnIndex não existe na DataTable qual faz DataRow parte.

NullReferenceException

Um valor nulo foi atribuído a um tipo não anulável.

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 estiver DataSet 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.

Aplica-se a

Field<T>(DataRow, String, DataRowVersion)

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

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 atua como a this instância do método de extensão.

columnName: String

O nome da coluna da qual retornar o valor.

version: DataRowVersion

Uma DataRowVersion enumeração que especifica a versão do valor da coluna a ser retornada, como Current ou Original versão.

Retornos

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

Exceções

InvalidCastException

O tipo de valor da coluna subjacente não pôde ser convertido no tipo especificado pelo parâmetro genérico. T

IndexOutOfRangeException

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

NullReferenceException

Um valor nulo foi atribuído a um tipo não anulável.

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 estiver DataSet 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.

Aplica-se a

Comentários

Esta página foi útil?