DataRowExtensions.Field Método

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de DataRow.

Sobrecargas

Field<T>(DataRow, DataColumn)	Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, DataColumn) también admite tipos que aceptan valores NULL.
Field<T>(DataRow, Int32)	Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, Int32) también admite tipos que aceptan valores NULL.
Field<T>(DataRow, String)	Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, String) también admite tipos que aceptan valores NULL.
Field<T>(DataRow, DataColumn, DataRowVersion)	Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, DataColumn, DataRowVersion) también admite tipos que aceptan valores NULL.
Field<T>(DataRow, Int32, DataRowVersion)	Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, Int32, DataRowVersion) también admite tipos que aceptan valores NULL.
Field<T>(DataRow, String, DataRowVersion)	Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, String, DataRowVersion) también admite tipos que aceptan valores NULL.

Field<T>(DataRow, DataColumn)

Source:

DataRowExtensions.cs

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, DataColumn) también admite tipos que aceptan valores NULL.

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

Parámetro genérico que especifica el tipo devuelto de la columna.

Parámetros

row

DataRow

Objeto DataRow de entrada, que actúa como la instancia de this del método de extensión.

column

DataColumn

Objeto DataColumn de entrada que especifica la columna de la que devolver el valor.

Devoluciones

T

Valor de tipo T del objeto DataColumn especificado por column.

Excepciones

InvalidCastException

El tipo de valor de la columna subyacente no pudo convertirse en el tipo especificado por el parámetro genérico, T.

IndexOutOfRangeException

La columna especificada por column no aparece en la DataTable de la que forma parte DataRow.

NullReferenceException

Se ha asignado un valor null a un tipo que no acepta valores NULL.

Comentarios

La DataSet clase representa valores NULL con la Value instancia de la DBNull clase . Una expresión de Language-Integrated Query (LINQ) a la que se accedió a una columna con un valor NULL generaría una InvalidCastException en tiempo de ejecución. Además, DataSet y DataTable no admiten tipos que aceptan valores NULL. El Field método proporciona compatibilidad con el acceso a columnas como tipos que aceptan valores NULL. Si el valor subyacente de DataSet es DBNull.Value, el tipo que acepta valores NULL devuelto tendrá un valor null.

Si el valor del especificado DataColumn es DBNull.Value y T es un tipo de referencia o un tipo que acepta valores NULL, el tipo de valor devuelto será NULL. El Field método no devolverá DBNull.Value.

El Field método no realiza conversiones de tipos. Si se requiere la conversión de tipos, primero debe obtener el valor de columna mediante el Field método . A continuación, el valor de columna se debe convertir en otro tipo.

Field<T>(DataRow, Int32)

Source:

DataRowExtensions.cs

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, Int32) también admite tipos que aceptan valores NULL.

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

Parámetro genérico que especifica el tipo devuelto de la columna.

Parámetros

row

DataRow

Objeto DataRow de entrada, que actúa como la instancia de this del método de extensión.

columnIndex

Int32

Índice de la columna.

Devoluciones

T

Valor de tipo T del objeto DataColumn especificado por columnIndex.

Excepciones

InvalidCastException

El tipo de valor de la columna subyacente no pudo convertirse en el tipo especificado por el parámetro genérico, T.

IndexOutOfRangeException

La columna especificada por ordinal no existe en la DataTable de la que forma parte DataRow.

NullReferenceException

Se ha asignado un valor null a un tipo que no acepta valores NULL.

Comentarios

La DataSet clase representa valores NULL con la Value instancia de la DBNull clase . Una expresión de Language-Integrated Query (LINQ) a la que se accedió a una columna con un valor NULL generaría una InvalidCastException en tiempo de ejecución. Además, DataSet no admite tipos que aceptan valores NULL. El Field método proporciona compatibilidad con el acceso a columnas como tipos que aceptan valores NULL. Si el valor subyacente de DataSet es DBNull.Value, el tipo que acepta valores NULL devuelto tendrá un valor null.

Si el valor del especificado DataColumn es null y T es un tipo de referencia o un tipo que acepta valores NULL, el tipo devuelto será NULL. El Field método no devolverá DBNull.Value.

El Field método no realiza conversiones de tipos. Si se requiere la conversión de tipos, primero debe obtener el valor de columna mediante el Field método . A continuación, el valor de columna se debe convertir en otro tipo.

Field<T>(DataRow, String)

Source:

DataRowExtensions.cs

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, String) también admite tipos que aceptan valores NULL.

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

Parámetro genérico que especifica el tipo devuelto de la columna.

Parámetros

row

DataRow

Objeto DataRow de entrada, que actúa como la instancia de this del método de extensión.

columnName

String

Nombre de la columna de la que se va a devolver el valor.

Devoluciones

T

Valor de tipo T del objeto DataColumn especificado por columnName.

Excepciones

InvalidCastException

El tipo de valor de la columna subyacente no pudo convertirse en el tipo especificado por el parámetro genérico, T.

IndexOutOfRangeException

La columna especificada por columnName no aparece en la DataTable de la que forma parte DataRow.

NullReferenceException

Se asignó un valor null a un tipo que no acepta valores NULL.

Comentarios

La DataSet clase representa valores NULL con la Value instancia de la DBNull clase . Una expresión de Language-Integrated Query (LINQ) a la que se accedió a una columna con un valor NULL generaría una InvalidCastException en tiempo de ejecución. Además, DataSet y DataTable no admiten tipos que aceptan valores NULL. El Field método proporciona compatibilidad con el acceso a columnas como tipos que aceptan valores NULL. Si el valor subyacente de DataSet es DBNull.Value, el tipo que acepta valores NULL devuelto tendrá un valor null.

Si el valor del especificado DataColumn es null y T es un tipo de referencia o un tipo que acepta valores NULL, el tipo de valor devuelto será NULL. El Field método no devolverá DBNull.Value.

El Field método no realiza conversiones de tipos. Si se requiere la conversión de tipos, primero debe obtener el valor de columna mediante el Field método . A continuación, el valor de columna se debe convertir en otro tipo.

Field<T>(DataRow, DataColumn, DataRowVersion)

Source:

DataRowExtensions.cs

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, DataColumn, DataRowVersion) también admite tipos que aceptan valores NULL.

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

Parámetro genérico que especifica el tipo devuelto de la columna.

Parámetros

row

DataRow

Objeto DataRow de entrada, que actúa como la instancia de this del método de extensión.

column

DataColumn

Objeto DataColumn de entrada que especifica la columna de la que devolver el valor.

version

DataRowVersion

Enumeración DataRowVersion que especifica la versión del valor de columna que debe devolverse, como la versión Current o Original.

Devoluciones

T

Valor de tipo T del objeto DataColumn especificado por column y version.

Excepciones

InvalidCastException

El tipo de valor de la columna subyacente no pudo convertirse en el tipo especificado por el parámetro genérico, T.

IndexOutOfRangeException

La columna especificada por column no existe en la DataTable de la que forma parte DataRow.

NullReferenceException

Se ha asignado un valor null a un tipo que no acepta valores NULL.

Comentarios

La DataSet clase representa valores NULL con la Value instancia de la DBNull clase . Una expresión de Language-Integrated Query (LINQ) a la que se accedió a una columna con un valor NULL generaría una InvalidCastException en tiempo de ejecución. Además, DataSet no admite tipos que aceptan valores NULL. El Field método proporciona compatibilidad con el acceso a columnas como tipos que aceptan valores NULL. Si el valor subyacente de DataSet es DBNull.Value, el tipo que acepta valores NULL devuelto tendrá un valor null.

Si el valor del especificado DataColumn es null y T es un tipo de referencia o un tipo que acepta valores NULL, el tipo devuelto será NULL. El Field método no devolverá DBNull.Value.

El Field método no realiza conversiones de tipos. Si se requiere la conversión de tipos, primero debe obtener el valor de columna mediante el Field método . A continuación, el valor de columna se debe convertir en otro tipo.

Field<T>(DataRow, Int32, DataRowVersion)

Source:

DataRowExtensions.cs

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, Int32, DataRowVersion) también admite tipos que aceptan valores NULL.

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

Parámetro genérico que especifica el tipo devuelto de la columna.

Parámetros

row

DataRow

Objeto DataRow de entrada, que actúa como la instancia de this del método de extensión.

columnIndex

Int32

Ordinal de base cero de la columna de la que va a devolverse el valor.

version

DataRowVersion

Enumeración DataRowVersion que especifica la versión del valor de columna que debe devolverse, como la versión Current o Original.

Devoluciones

T

Valor de tipo T del objeto DataColumn especificado por ordinal y version.

Excepciones

InvalidCastException

El tipo de valor de la columna subyacente no pudo convertirse en el tipo especificado por el parámetro genérico, T.

IndexOutOfRangeException

La columna especificada por ordinal no existe en la DataTable de la que forma parte DataRow.

NullReferenceException

Se ha asignado un valor null a un tipo que no acepta valores NULL.

Comentarios

La DataSet clase representa valores NULL con la Value instancia de la DBNull clase . Una expresión de Language-Integrated Query (LINQ) a la que se accedió a una columna con un valor NULL generaría una InvalidCastException en tiempo de ejecución. Además, DataSet no admite tipos que aceptan valores NULL. El Field método proporciona compatibilidad con el acceso a columnas como tipos que aceptan valores NULL. Si el valor subyacente de DataSet es DBNull.Value, el tipo que acepta valores NULL devuelto tendrá un valor null.

Si el valor del especificado DataColumn es null y T es un tipo de referencia o un tipo que acepta valores NULL, el tipo devuelto será NULL. El Field método no devolverá DBNull.Value.

El Field método no realiza conversiones de tipos. Si se requiere la conversión de tipos, primero debe obtener el valor de columna mediante el Field método . A continuación, el valor de columna se debe convertir en otro tipo.

Field<T>(DataRow, String, DataRowVersion)

Source:

DataRowExtensions.cs

Proporciona acceso fuertemente tipado a cada uno de los valores de columna de la fila especificada. El método Field<T>(DataRow, String, DataRowVersion) también admite tipos que aceptan valores NULL.

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

Parámetro genérico que especifica el tipo devuelto de la columna.

Parámetros

row

DataRow

Objeto DataRow de entrada, que actúa como la instancia de this del método de extensión.

columnName

String

Nombre de la columna de la que se va a devolver el valor.

version

DataRowVersion

Enumeración DataRowVersion que especifica la versión del valor de columna que debe devolverse, como la versión Current o Original.

Devoluciones

T

Valor de tipo T del objeto DataColumn especificado por columnName y version.

Excepciones

InvalidCastException

El tipo de valor de la columna subyacente no pudo convertirse en el tipo especificado por el parámetro genérico, T.

IndexOutOfRangeException

La columna especificada por columnName no existe en la DataTable de la que forma parte DataRow.

NullReferenceException

Se ha asignado un valor null a un tipo que no acepta valores NULL.

Comentarios

La DataSet clase representa valores NULL con la Value instancia de la DBNull clase . Una expresión de Language-Integrated Query (LINQ) a la que se accedió a una columna con un valor NULL generaría una InvalidCastException en tiempo de ejecución. Además, DataSet no admite tipos que aceptan valores NULL. El Field método proporciona compatibilidad con el acceso a columnas como tipos que aceptan valores NULL. Si el valor subyacente de DataSet es DBNull.Value, el tipo que acepta valores NULL devuelto tendrá un valor null.

Si el valor del especificado DataColumn es null y T es un tipo de referencia o un tipo que acepta valores NULL, el tipo devuelto será NULL. El Field método no devolverá DBNull.Value.

El Field método no realiza conversiones de tipos. Si se requiere la conversión de tipos, primero debe obtener el valor de columna mediante el Field método . A continuación, el valor de columna se debe convertir en otro tipo.