ObjectDataSourceView Clase

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.dll

Admite el ObjectDataSource control y proporciona una interfaz para que los controles enlazados a datos realicen operaciones de datos con objetos empresariales y de datos.

public ref class ObjectDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager

public class ObjectDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager

type ObjectDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class ObjectDataSourceView
Inherits DataSourceView
Implements IStateManager

Herencia

Object

DataSourceView

ObjectDataSourceView

Implementaciones

IStateManager

Comentarios

La ObjectDataSourceView clase está pensada principalmente para ser utilizada por controles enlazados a datos y no como un objeto programable en el código de página.

La ObjectDataSourceView clase implementa la funcionalidad de datos para el ObjectDataSource control, incluidas las Selectoperaciones , Update, Delete, y Insert , la ordenación, el filtrado y la administración de la configuración que se mantienen en estado de vista.

Se crea un ObjectDataSourceView objeto para cada instancia de la ObjectDataSource clase en tiempo de ejecución. Las llamadas a las operaciones de datos de la instancia de la ObjectDataSource clase se controlan mediante la instancia del ObjectDataSourceView objeto . Los desarrolladores de páginas no acceden directamente a la instancia de la ObjectDataSourceView clase . Los desarrolladores de control pueden crear controles de datos personalizados mediante la extensión de las ObjectDataSource clases y ObjectDataSourceView .

La ObjectDataSourceView clase realiza operaciones de datos mediante una llamada a métodos en objetos de datos o empresariales mediante la reflexión. En tiempo de ejecución, el ObjectDataSource control crea una instancia del tipo identificado por la TypeName propiedad y, a continuación, llama al método adecuado para la operación de datos. El objeto al que se crea una instancia no se almacena en caché en la memoria .ObjectDataSourceView El objeto se crea y destruye para cada llamada al método de datos. Si el método es static (Shared en Visual Basic), no se crea una instancia, pero se sigue llamando al método de operación de datos.

El ObjectDataSourceView control no expone directamente a los desarrolladores de ObjectDataSource páginas. En su lugar, se obtiene acceso a las propiedades y los métodos de a través de ObjectDataSourceViewObjectDataSource. Por ejemplo, la DeleteMethod propiedad de ObjectDataSourceView se establece estableciendo la DeleteMethod propiedad de ObjectDataSource.

Recuperación de datos

La operación más básica que realiza una vista del origen de datos es la recuperación de datos del almacenamiento de datos subyacente mediante el Select método , que recupera una IEnumerable colección de elementos de datos. El objeto implementa los ObjectDataSourceView siguientes métodos, propiedades y eventos de recuperación de datos y expone directamente su ObjectDataSource control a los desarrolladores de páginas y a otros autores de llamadas:

• El método Select

• La propiedad SelectMethod

• La propiedad SelectParameters

• El Selecting evento

• El Selected evento

Actualizar datos

El ObjectDataSourceView objeto admite actualizaciones de datos llamando a un método de objeto de datos o de negocio identificado por la UpdateMethod propiedad . Los controles enlazados a datos que realizan actualizaciones automáticamente, como los GridView controles y DetailsView , pasan sus parámetros en una IOrderedDictionary interfaz a ObjectDataSourceView y el objeto view combina estos parámetros con los parámetros que se encuentran en la UpdateParameters colección.

Los siguientes métodos de actualización, propiedades y eventos se implementan mediante ObjectDataSourceView y exponen ObjectDataSource directamente su control a los desarrolladores de páginas y a otros autores de llamadas:

• El método Update

• La propiedad UpdateMethod

• La propiedad UpdateParameters

• El Updating evento

• El Updated evento

Insertar datos

El ObjectDataSourceView objeto admite la inserción de nuevas filas de datos llamando a un método de objeto de datos o de negocio identificado por la InsertMethod propiedad . Los controles enlazados a datos que realizan inserciones automáticamente, como y GridViewDetailsView, pasan sus parámetros en una IOrderedDictionary interfaz a ObjectDataSourceView y el objeto view combina estos parámetros con los parámetros que se encuentran en la InsertParameters colección.

Los siguientes métodos de inserción, propiedades y eventos se implementan mediante ObjectDataSourceView y exponen directamente su ObjectDataSource control a los desarrolladores de páginas y a otros autores de llamadas:

• El método Insert

• La propiedad InsertMethod

• La propiedad InsertParameters

• El Inserting evento

• El Inserted evento

Eliminación de datos

El ObjectDataSourceView objeto admite la eliminación de datos llamando a un método de objeto de datos o de negocio identificado por la DeleteMethod propiedad . Los controles enlazados a datos que realizan automáticamente eliminaciones, como y GridViewDetailsView, pasan sus parámetros en una IOrderedDictionary interfaz a ObjectDataSourceView y el objeto view combina estos parámetros con los parámetros que se encuentran en la DeleteParameters colección. Los siguientes métodos de eliminación, propiedades y eventos se implementan mediante ObjectDataSourceView y exponen directamente su ObjectDataSource control a los desarrolladores de páginas y a otros autores de llamadas:

• El método Delete

• La propiedad DeleteMethod

• La propiedad DeleteParameters

• El Deleting evento

• El Deleted evento

Filtrado y ordenación de datos

La recuperación de datos es más eficaz cuando se pueden filtrar los datos de forma dinámica. El filtrado solo es compatible con el ObjectDataSource control si el Select método devuelve un DataTable objeto o DataSet . Puede usar las FilterExpression propiedades y FilterParameters para aplicar el filtrado dinámico a la recuperación de datos. Estas propiedades se implementan mediante el ObjectDataSourceView objeto y se exponen directamente mediante su ObjectDataSource control a controles enlazados a datos y a otros llamadores.

Puede ordenar los datos que recupera con ObjectDataSource si ordena los datos en la memoria después de recuperarlos. La ordenación solo es compatible con el ObjectDataSource control si el Select método devuelve o DataTableDataSet. La CanSort propiedad siempre devuelve true, porque no ObjectDataSourceView puede determinar qué tipo devuelve el Select método sin llamar al método . La SortExpression sintaxis de propiedad es la misma que para una DataView.Sort propiedad .

Estado de vista de seguimiento

ObjectDataSourceView implementa la interfaz y usa el IStateManager estado de vista para realizar un seguimiento de su estado entre las solicitudes de página. Se proporciona la implementación de los LoadViewStatemétodos , SaveViewStatey TrackViewState para habilitar el seguimiento de estado de vista para el control. Para obtener más información, consulte ASP.NET Información general sobre la administración de estado.

Constructores

Nombre	Description
ObjectDataSourceView(ObjectDataSource, String, HttpContext)	Inicializa una nueva instancia de la clase ObjectDataSourceView.

Propiedades

Nombre	Description
CanDelete	Obtiene un valor que indica si el ObjectDataSourceView objeto asociado al control actual ObjectDataSource admite la operación de eliminación.
CanInsert	Obtiene un valor que indica si el ObjectDataSourceView objeto asociado al control actual ObjectDataSource admite la operación de inserción.
CanPage	Obtiene un valor que indica si el ObjectDataSourceView objeto asociado al control actual ObjectDataSource admite la paginación a través de los datos recuperados.
CanRetrieveTotalRowCount	Obtiene un valor que indica si el ObjectDataSourceView objeto asociado al control actual ObjectDataSource admite la recuperación del número total de filas de datos, además del conjunto de datos.
CanSort	Obtiene un valor que indica si el ObjectDataSourceView objeto asociado al control actual ObjectDataSource admite una vista ordenada en el origen de datos subyacente.
CanUpdate	Obtiene un valor que indica si el ObjectDataSourceView objeto asociado al control actual ObjectDataSource admite la operación de actualización.
ConflictDetection	Obtiene o establece un valor que determina cómo el ObjectDataSource control realiza actualizaciones y elimina cuando los datos de una fila del almacenamiento de datos subyacente cambian durante el tiempo de la operación.
ConvertNullToDBNull	Obtiene o establece un valor que indica si Parameter los valores que se pasan a una operación de actualización, inserción o eliminación se convierten automáticamente en null el Value valor.
DataObjectTypeName	Obtiene o establece el nombre de una clase que el ObjectDataSource control usa para un parámetro en una operación de datos. El ObjectDataSource control usa la clase especificada en lugar de los Parameter objetos que se encuentran en las distintas colecciones de parámetros.
DeleteMethod	Obtiene o establece el nombre del método o función que el ObjectDataSourceView objeto invoca para eliminar datos.
DeleteParameters	Obtiene la colección de parámetros que contiene los parámetros utilizados por el DeleteMethod método .
EnablePaging	Obtiene o establece un valor que indica si el control de origen de datos admite la paginación a través del conjunto de datos que recupera.
Events	Obtiene una lista de delegados del controlador de eventos para la vista del origen de datos. (Heredado de DataSourceView)
FilterExpression	Obtiene o establece una expresión de filtrado que se aplica cuando se llama al método de objeto de negocio identificado por la SelectMethod propiedad .
FilterParameters	Obtiene una colección de parámetros asociados a los marcadores de posición de parámetros que se encuentran en la FilterExpression cadena.
InsertMethod	Obtiene o establece el nombre del método o función que el ObjectDataSourceView objeto invoca para insertar datos.
InsertParameters	Obtiene la colección de parámetros que contiene los parámetros utilizados por el InsertMethod método .
IsTrackingViewState	Obtiene un valor que indica si el ObjectDataSourceView objeto guarda los cambios en su estado de vista.
MaximumRowsParameterName	Obtiene o establece el nombre del parámetro del método de recuperación de datos que se usa para indicar el número de registros que se van a recuperar para la compatibilidad con la paginación del origen de datos.
Name	Obtiene el nombre de la vista del origen de datos. (Heredado de DataSourceView)
OldValuesParameterFormatString	Obtiene o establece una cadena de formato que se aplicará a los nombres de los parámetros de los valores originales que se pasan a los Delete métodos o Update .
ParsingCulture	Obtiene un valor o establece un valor que indica qué información de referencia cultural se usa al convertir valores de cadena en tipos de propiedad reales para construir un objeto del tipo indicado por DataObjectTypeName.
SelectCountMethod	Obtiene o establece el nombre del método o función que invoca el ObjectDataSourceView control para recuperar un recuento de filas.
SelectMethod	Obtiene o establece el nombre del método o función que invoca el ObjectDataSourceView control para recuperar datos.
SelectParameters	Obtiene la colección de parámetros que contiene los parámetros utilizados por el SelectMethod método .
SortParameterName	Obtiene o establece el nombre del parámetro del método de recuperación de datos que se usa para especificar una expresión de ordenación para la compatibilidad con la ordenación del origen de datos.
StartRowIndexParameterName	Obtiene o establece el nombre del parámetro del método de recuperación de datos que se usa para indicar el índice entero del primer registro que se va a recuperar del conjunto de resultados para la compatibilidad con la paginación del origen de datos.
TypeName	Obtiene o establece el nombre de la clase que representa el ObjectDataSource control.
UpdateMethod	Obtiene o establece el nombre del método o función que el ObjectDataSourceView objeto invoca para actualizar los datos.
UpdateParameters	Obtiene la colección de parámetros que contiene los parámetros utilizados por el UpdateMethod método .

Métodos

Nombre	Description
CanExecute(String)	Determina si se puede ejecutar el comando especificado. (Heredado de DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Realiza una operación de eliminación asincrónica en la lista de datos que representa el DataSourceView objeto. (Heredado de DataSourceView)
Delete(IDictionary, IDictionary)	Realiza una operación de eliminación llamando al método de objeto de negocio identificado por la DeleteMethod propiedad mediante las colecciones y oldValues especificadaskeys.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Ejecuta el comando especificado. (Heredado de DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	Ejecuta el comando especificado. (Heredado de DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Realiza una operación de eliminación mediante el DeleteMethod método y la colección y oldValues especificadoskeys.
ExecuteInsert(IDictionary)	Realiza una operación de inserción llamando al método de objeto de negocio identificado por la InsertMethod propiedad mediante la colección especificada values .
ExecuteSelect(DataSourceSelectArguments)	Recupera datos del objeto identificado por la TypeName propiedad llamando al método identificado por la SelectMethod propiedad y pasando los valores de la SelectParameters colección.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Realiza una operación de actualización llamando al método identificado por la UpdateMethod propiedad y utilizando los parámetros proporcionados en las keyscolecciones , valueso oldValues .
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Realiza una operación de inserción asincrónica en la lista de datos que representa el DataSourceView objeto. (Heredado de DataSourceView)
Insert(IDictionary)	Realiza una operación de inserción llamando al método de objeto de negocio identificado por la InsertMethod propiedad mediante la colección especificada values .
LoadViewState(Object)	Restaura el estado de vista guardado anteriormente para la vista del origen de datos.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
OnDataSourceViewChanged(EventArgs)	Genera el evento DataSourceViewChanged. (Heredado de DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)	Genera el Deleted evento después de que el ObjectDataSourceView objeto haya completado una operación de eliminación.
OnDeleting(ObjectDataSourceMethodEventArgs)	Genera el Deleting evento antes de que el ObjectDataSourceView objeto intente una operación de eliminación.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Genera el Filtering evento antes de que el ObjectDataSourceView objeto intente una operación de filtrado.
OnInserted(ObjectDataSourceStatusEventArgs)	Genera el Inserted evento después de que el ObjectDataSourceView objeto haya completado una operación de inserción.
OnInserting(ObjectDataSourceMethodEventArgs)	Genera el Inserting evento antes de que el ObjectDataSourceView objeto intente una operación de inserción.
OnObjectCreated(ObjectDataSourceEventArgs)	Genera el ObjectCreated evento después de crear ObjectDataSourceView una instancia del objeto identificado por la TypeName propiedad .
OnObjectCreating(ObjectDataSourceEventArgs)	Genera el ObjectCreating evento antes de que el ObjectDataSourceView objeto cree una instancia de un objeto de negocio para realizar una operación de datos.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)	Genera el ObjectDisposing evento antes de que el ObjectDataSourceView objeto descarte un tipo de instancia.
OnSelected(ObjectDataSourceStatusEventArgs)	Genera el Selected evento después de que el ObjectDataSourceView objeto haya completado una operación de recuperación de datos.
OnSelecting(ObjectDataSourceSelectingEventArgs)	Genera el Selecting evento antes de que el ObjectDataSourceView objeto intente una operación de recuperación de datos.
OnUpdated(ObjectDataSourceStatusEventArgs)	Genera el Updated evento después de que el ObjectDataSourceView objeto haya completado una operación de actualización.
OnUpdating(ObjectDataSourceMethodEventArgs)	Genera el Updating evento antes de que el ObjectDataSourceView objeto intente una operación de actualización.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Llamado por el RaiseUnsupportedCapabilitiesError(DataSourceView) método para comparar las funcionalidades solicitadas para una ExecuteSelect(DataSourceSelectArguments) operación con las que admite la vista. (Heredado de DataSourceView)
SaveViewState()	Guarda los cambios en el estado de vista del ObjectDataSourceView objeto desde el momento en que se devolvió la página al servidor.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Obtiene una lista de datos de forma asincrónica desde el almacenamiento de datos subyacente. (Heredado de DataSourceView)
Select(DataSourceSelectArguments)	Recupera datos del objeto identificado por la TypeName propiedad llamando al método identificado por la SelectMethod propiedad y pasando los valores de la SelectParameters colección.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TrackViewState()	Hace que el ObjectDataSourceView objeto realice un seguimiento de los cambios en su estado de vista para que los cambios se puedan almacenar en el ViewState objeto para el control y conservarse en las solicitudes de la misma página.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Realiza una operación de actualización asincrónica en la lista de datos que representa el DataSourceView objeto. (Heredado de DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Realiza una operación de actualización llamando al método identificado por la UpdateMethod propiedad y utilizando los parámetros proporcionados en las keyscolecciones , valueso oldValues .

Eventos

Nombre	Description
DataSourceViewChanged	Se produce cuando la vista del origen de datos ha cambiado. (Heredado de DataSourceView)
Deleted	Se produce cuando se ha completado una Delete operación.
Deleting	Se produce antes de una Delete operación.
Filtering	Se produce antes de una operación de filtro.
Inserted	Se produce cuando se ha completado una Insert operación.
Inserting	Se produce antes de una Insert operación.
ObjectCreated	Se produce después de que el ObjectDataSourceView objeto cree una instancia del tipo identificado por la TypeName propiedad .
ObjectCreating	Se produce antes de que el ObjectDataSourceView objeto cree una instancia del tipo identificado por la TypeName propiedad .
ObjectDisposing	Se produce cuando el ObjectDataSourceView objeto descarta una instancia de un objeto que ha creado.
Selected	Se produce cuando se ha completado una operación de recuperación de datos.
Selecting	Se produce antes de una operación de recuperación de datos.
Updated	Se produce cuando se ha completado una Update operación.
Updating	Se produce antes de una Update operación.

Implementaciones de interfaz explícitas

Nombre	Description
IStateManager.IsTrackingViewState	Para obtener una descripción de este miembro, vea IsTrackingViewState.
IStateManager.LoadViewState(Object)	Para obtener una descripción de este miembro, vea LoadViewState(Object).
IStateManager.SaveViewState()	Para obtener una descripción de este miembro, vea SaveViewState().
IStateManager.TrackViewState()	Para obtener una descripción de este miembro, vea TrackViewState().

Consulte también

• ObjectDataSource
• DataSourceView