DataRowExtensions.Field Método

Definição

Espaço de Nomes:: System.Data

Assemblagens:: netstandard.dll, System.Data.Common.dll

Assemblagens:: netstandard.dll, System.Data.Common.dll, System.Data.DataSetExtensions.dll

Assemblagens:: System.Data.Common.dll, System.Data.DataSetExtensions.dll

Assemblagem:: System.Data.Common.dll

Assemblagem:: System.Data.DataSetExtensions.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

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

Sobrecargas

Name	Description
Field<T>(DataRow, DataColumn)	Fornece acesso fortemente tipado a cada um dos valores das colunas na linha especificada. O Field<T>(DataRow, DataColumn) método também suporta tipos anuláveis.
Field<T>(DataRow, Int32)	Fornece acesso fortemente tipado a cada um dos valores das colunas na linha especificada. O Field<T>(DataRow, Int32) método também suporta tipos anuláveis.
Field<T>(DataRow, String)	Fornece acesso fortemente tipado a cada um dos valores das colunas na linha especificada. O Field<T>(DataRow, String) método também suporta tipos anuláveis.
Field<T>(DataRow, DataColumn, DataRowVersion)	Fornece acesso fortemente tipado a cada um dos valores das colunas na linha especificada. O Field<T>(DataRow, DataColumn, DataRowVersion) método também suporta tipos anuláveis.
Field<T>(DataRow, Int32, DataRowVersion)	Fornece acesso fortemente tipado a cada um dos valores das colunas na linha especificada. O Field<T>(DataRow, Int32, DataRowVersion) método também suporta tipos anuláveis.
Field<T>(DataRow, String, DataRowVersion)	Fornece acesso fortemente tipado a cada um dos valores das colunas na linha especificada. O Field<T>(DataRow, String, DataRowVersion) método também suporta tipos anuláveis.

Field<T>(DataRow, DataColumn)

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Fornece acesso fortemente tipado a cada um dos valores das colunas na linha especificada. O Field<T>(DataRow, DataColumn) método também suporta 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);

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 Genérico

T

Um parâmetro genérico que especifica o tipo de retorno da coluna.

Parâmetros

row: DataRow

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

column: DataColumn

O objeto de entrada DataColumn que especifica a coluna para devolver o valor de .

Devoluções

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

Exceções

InvalidCastException

O tipo de valor da coluna subjacente não podia ser fundido para o tipo especificado pelo parâmetro genérico, T.

IndexOutOfRangeException

A coluna especificada por column não ocorre em que DataTable o DataRow faz parte de.

NullReferenceException

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

Observações

A DataSet classe representa valores nulos com a Value instância da DBNull classe. Uma expressão Language-Integrated Query (LINQ) que acedia a uma coluna com valor nulo geraria um InvalidCastException em tempo de execução. Além disso, DataSet e DataTable não suportam tipos anuláveis. O Field método fornece suporte para aceder a colunas como tipos anuláveis. Se o valor subjacente em o DataSet for DBNull.Value, o tipo anulável devolvido terá um valor de 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 retorna DBNull.Value.

O Field método não realiza conversões de tipos. Se for necessária conversão de tipo, deve primeiro obter o valor da coluna usando o Field método. O valor da coluna deve então ser convertido para outro tipo.

Aplica-se a

Field<T>(DataRow, Int32)

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Fornece acesso fortemente tipado a cada um dos valores das colunas na linha especificada. O Field<T>(DataRow, Int32) método também suporta 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);

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 Genérico

T

O tipo de retorno da coluna.

Parâmetros

row: DataRow

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

columnIndex: Int32

O índice da coluna.

Devoluções

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

Exceções

InvalidCastException

O tipo de valor da coluna subjacente não podia ser fundido para o tipo especificado pelo parâmetro genérico, T.

IndexOutOfRangeException

A coluna especificada por columnIndex não existe no DataTable que o DataRow faz parte.

NullReferenceException

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

Observações

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

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

Aplica-se a

Field<T>(DataRow, String)

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Fornece acesso fortemente tipado a cada um dos valores das colunas na linha especificada. O Field<T>(DataRow, String) método também suporta 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);

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 Genérico

T

Um parâmetro genérico que especifica o tipo de retorno da coluna.

Parâmetros

row: DataRow

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

columnName: String

O nome da coluna para devolver o valor de.

Devoluções

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

Exceções

InvalidCastException

O tipo de valor da coluna subjacente não podia ser fundido para o tipo especificado pelo parâmetro genérico, T.

IndexOutOfRangeException

A coluna especificada por columnName não ocorre em que DataTable o DataRow faz parte de.

NullReferenceException

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

Observações

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 retorna DBNull.Value.

Aplica-se a

Field<T>(DataRow, DataColumn, DataRowVersion)

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Fornece acesso fortemente tipado a cada um dos valores das colunas na linha especificada. O Field<T>(DataRow, DataColumn, DataRowVersion) método também suporta 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);

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 Genérico

T

Um parâmetro genérico que especifica o tipo de retorno da coluna.

Parâmetros

row: DataRow

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

column: DataColumn

O objeto de entrada DataColumn que especifica a coluna para devolver o valor de .

version: DataRowVersion

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

Devoluções

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

Exceções

InvalidCastException

O tipo de valor da coluna subjacente não podia ser fundido para o tipo especificado pelo parâmetro genérico, T.

IndexOutOfRangeException

A coluna especificada por column não existe no DataTable que o DataRow faz parte.

NullReferenceException

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

Observações

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

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

Aplica-se a

Field<T>(DataRow, Int32, DataRowVersion)

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Fornece acesso fortemente tipado a cada um dos valores das colunas na linha especificada. O Field<T>(DataRow, Int32, DataRowVersion) método também suporta 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);

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 Genérico

T

Um parâmetro genérico que especifica o tipo de retorno da coluna.

Parâmetros

row: DataRow

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

columnIndex: Int32

O ordinal baseado em zero da coluna para devolver o valor de.

version: DataRowVersion

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

Devoluções

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

Exceções

InvalidCastException

O tipo de valor da coluna subjacente não podia ser fundido para o tipo especificado pelo parâmetro genérico, T.

IndexOutOfRangeException

A coluna especificada por columnIndex não existe no DataTable que o DataRow faz parte.

NullReferenceException

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

Observações

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

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

Aplica-se a

Field<T>(DataRow, String, DataRowVersion)

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Origem:: DataRowExtensions.cs

Fornece acesso fortemente tipado a cada um dos valores das colunas na linha especificada. O Field<T>(DataRow, String, DataRowVersion) método também suporta 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);

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 Genérico

T

Um parâmetro genérico que especifica o tipo de retorno da coluna.

Parâmetros

row: DataRow

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

columnName: String

O nome da coluna para devolver o valor de.

version: DataRowVersion

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

Devoluções

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

Exceções

InvalidCastException

O tipo de valor da coluna subjacente não podia ser fundido para o tipo especificado pelo parâmetro genérico, T.

IndexOutOfRangeException

A coluna especificada por columnName não existe no DataTable que o DataRow faz parte.

NullReferenceException

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

Observações

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

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

Aplica-se a

Comentários

Esta página foi útil?