ObjectDataSourceView Clase

Definición

Admite el control ObjectDataSource y proporciona una interfaz para que los controles enlazados a datos realicen operaciones de datos con objetos de negocio 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
ObjectDataSourceView
Implementaciones

Comentarios

La ObjectDataSourceView clase está pensada principalmente para que la usen los 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, Deletey Insert , la ordenación, el filtrado y la administración de la configuración 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 controles 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 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 páginas ObjectDataSource . 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. Los siguientes métodos de recuperación de datos, propiedades y eventos se implementan mediante el ObjectDataSourceView objeto y se exponen directamente mediante su ObjectDataSource control a los desarrolladores de páginas y a otros autores de llamadas:

Actualización de datos

El ObjectDataSourceView objeto admite actualizaciones de datos mediante una llamada a un método de objeto de datos o de negocio identificado por la UpdateMethod propiedad . Los controles enlazados a datos que realizan automáticamente actualizaciones, 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 y ObjectDataSourceView se exponen directamente mediante su ObjectDataSource control a los desarrolladores de páginas y a otros autores de llamadas:

Insertar datos

El ObjectDataSourceView objeto admite la inserción de nuevas filas de datos mediante una llamada a un método de objeto de datos o de negocio identificado por la InsertMethod propiedad . Los controles enlazados a datos que realizan automáticamente inserciones, 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 y ObjectDataSourceView se exponen directamente mediante su ObjectDataSource control a los desarrolladores de páginas y a otros autores de llamadas:

Eliminar datos

El ObjectDataSourceView objeto admite la eliminación de datos mediante una llamada 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 y ObjectDataSourceView se exponen directamente mediante su ObjectDataSource control a los desarrolladores de páginas y a otros autores de llamadas:

Filtrado y ordenación de datos

La recuperación de datos es más eficaz cuando se pueden filtrar los datos dinámicamente. 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 autores de llamadas.

Puede ordenar los datos que recupere con ObjectDataSource orden ordenando 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 ObjectDataSourceView no puede determinar qué tipo devuelve el Select método sin llamar al método . La sintaxis de SortExpression la 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 en las solicitudes de página. Se proporciona la implementación de los LoadViewStatemétodos , SaveViewStatey TrackViewState para habilitar el seguimiento del estado de vista para el control. Para obtener más información, consulte ASP.NET State Management Overview.

Constructores

ObjectDataSourceView(ObjectDataSource, String, HttpContext)

Inicializa una nueva instancia de la clase ObjectDataSourceView.

Propiedades

CanDelete

Obtiene un valor que indica si el objeto ObjectDataSourceView asociado al control ObjectDataSource actual admite la operación de eliminación.

CanInsert

Obtiene un valor que indica si el objeto ObjectDataSourceView asociado al control ObjectDataSource actual admite la operación de inserción.

CanPage

Obtiene un valor que indica si el objeto ObjectDataSourceView asociado al control ObjectDataSource actual admite la paginación de los datos recuperados.

CanRetrieveTotalRowCount

Obtiene un valor que indica si el objeto ObjectDataSourceView asociado al control ObjectDataSource actual 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 objeto ObjectDataSourceView asociado al control ObjectDataSource actual admite una vista ordenada del origen de datos subyacente.

CanUpdate

Obtiene un valor que indica si el objeto ObjectDataSourceView asociado al control ObjectDataSource actual admite la operación de actualización.

ConflictDetection

Obtiene o establece un valor que determina cómo el control ObjectDataSource realiza actualizaciones y eliminaciones cuando los datos de una fila del almacenamiento de datos subyacente cambian mientras dura la operación.

ConvertNullToDBNull

Obtiene o establece un valor que indica si los valores Parameter que se pasan a una operación de actualización, inserción o eliminación se convierten automáticamente de null al valor Value.

DataObjectTypeName

Obtiene o establece el nombre de una clase que el control ObjectDataSource utiliza para un parámetro de una operación de datos. El control ObjectDataSource utiliza la clase especificada en lugar de los objetos Parameter que se encuentran en las diversas colecciones de parámetros.

DeleteMethod

Obtiene o establece el nombre del método o función a los que invoca el objeto ObjectDataSourceView para eliminar datos.

DeleteParameters

Obtiene la colección de parámetros que contiene los parámetros utilizados por el método DeleteMethod.

EnablePaging

Obtiene o establece un valor que indica si el control de origen de datos admite la paginación en el conjunto de datos recuperado.

Events

Obtiene una lista de delegados de controladores de eventos de la vista de origen de datos.

(Heredado de DataSourceView)
FilterExpression

Obtiene o establece una expresión de filtrado que se aplica cuando se llama al método del objeto comercial identificado por la propiedad SelectMethod.

FilterParameters

Obtiene una colección de parámetros que están asociados a los marcadores de posición de parámetros de la cadena FilterExpression.

InsertMethod

Obtiene o establece el nombre del método o función a los que invoca el objeto ObjectDataSourceView para insertar datos.

InsertParameters

Obtiene la colección de parámetros que contiene los parámetros utilizados por el método InsertMethod.

IsTrackingViewState

Obtiene un valor que indica si el objeto ObjectDataSourceView está guardando los cambios en su estado de vista.

MaximumRowsParameterName

Obtiene o establece el nombre del parámetro del método de recuperación de datos utilizado para indicar el número de registros que se debe recuperar para obtener la compatibilidad con la paginación del origen de datos.

Name

Obtiene el nombre de la vista de datos de origen.

(Heredado de DataSourceView)
OldValuesParameterFormatString

Obtiene o establece una cadena de formato para aplicarla a los nombres de los parámetros de los valores originales que se pasan a los métodos Delete o Update.

ParsingCulture

Obtiene o establece un valor que indica qué información de referencia cultural se utiliza al convertir valores de cadena a los 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 a los que invoca el control ObjectDataSourceView para recuperar un recuento de filas.

SelectMethod

Obtiene o establece el nombre del método o función a los que invoca el control ObjectDataSourceView para recuperar datos.

SelectParameters

Obtiene la colección de parámetros que utiliza el método SelectMethod.

SortParameterName

Obtiene o establece el nombre del parámetro del método de recuperación de datos utilizado para especificar una expresión de orden para obtener 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 utilizado para indicar el índice de tipo entero del primer registro que se debe recuperar del conjunto de resultados para obtener la compatibilidad con la paginación del origen de datos.

TypeName

Obtiene o establece el nombre de la clase representada por el control ObjectDataSource.

UpdateMethod

Obtiene o establece el nombre del método o función a los que invoca el objeto ObjectDataSourceView para actualizar datos.

UpdateParameters

Obtiene la colección de parámetros que utiliza el método UpdateMethod.

Métodos

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 el objeto DataSourceView representa.

(Heredado de DataSourceView)
Delete(IDictionary, IDictionary)

Realiza una operación de eliminación mediante una llamada al método de objetos comerciales identificado por la propiedad DeleteMethod y utilizando las colecciones keys y oldValues especificadas.

Equals(Object)

Determina si el objeto especificado es igual que el 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 utilizando el método DeleteMethod y las colecciones keys y oldValues especificadas.

ExecuteInsert(IDictionary)

Realiza una operación de inserción mediante una llamada al método de objetos comerciales identificado por la propiedad InsertMethod y utilizando la colección values especificada.

ExecuteSelect(DataSourceSelectArguments)

Recupera datos del objeto identificado por la propiedad TypeName llamando al método identificado por la propiedad SelectMethod y pasando los valores de la colección SelectParameters.

ExecuteUpdate(IDictionary, IDictionary, IDictionary)

Realiza una operación de actualización llamando al método identificado por la propiedad UpdateMethod y utilizando los parámetros suministrados en las colecciones keys, values o oldValues.

GetHashCode()

Sirve como la 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 el objeto DataSourceView representa.

(Heredado de DataSourceView)
Insert(IDictionary)

Realiza una operación de inserción mediante una llamada al método de objetos comerciales identificado por la propiedad InsertMethod y utilizando la colección values especificada.

LoadViewState(Object)

Restaura el estado de vista cargado anteriormente de la vista de origen de datos.

MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
OnDataSourceViewChanged(EventArgs)

Genera el evento DataSourceViewChanged.

(Heredado de DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)

Provoca el evento Deleted una vez que el objeto ObjectDataSourceView ha terminado una operación de eliminación.

OnDeleting(ObjectDataSourceMethodEventArgs)

Provoca el evento Deleting antes de que el objeto ObjectDataSourceView trate de realizar una operación de eliminación.

OnFiltering(ObjectDataSourceFilteringEventArgs)

Provoca el evento Filtering antes de que el objeto ObjectDataSourceView trate de realizar una operación de filtrado.

OnInserted(ObjectDataSourceStatusEventArgs)

Provoca el evento Inserted una vez que el objeto ObjectDataSourceView ha terminado una operación de inserción.

OnInserting(ObjectDataSourceMethodEventArgs)

Provoca el evento Inserting antes de que el objeto ObjectDataSourceView trate de realizar una operación de inserción.

OnObjectCreated(ObjectDataSourceEventArgs)

Provoca el evento ObjectCreated una vez que el objeto ObjectDataSourceView ha creado una instancia del objeto identificado por la propiedad TypeName.

OnObjectCreating(ObjectDataSourceEventArgs)

Provoca el evento ObjectCreating antes de que el objeto ObjectDataSourceView cree una instancia de un objeto comercial para realizar una operación de datos.

OnObjectDisposing(ObjectDataSourceDisposingEventArgs)

Provoca el evento ObjectDisposing antes de que el objeto ObjectDataSourceView descarte un tipo con instancias.

OnSelected(ObjectDataSourceStatusEventArgs)

Provoca el evento Selected una vez que el objeto ObjectDataSourceView ha terminado una operación de recuperación de datos.

OnSelecting(ObjectDataSourceSelectingEventArgs)

Provoca el evento Selecting antes de que el objeto ObjectDataSourceView trate de realizar una operación de recuperación de datos.

OnUpdated(ObjectDataSourceStatusEventArgs)

Provoca el evento Updated una vez que el objeto ObjectDataSourceView ha terminado una operación de actualización.

OnUpdating(ObjectDataSourceMethodEventArgs)

Provoca el evento Updating antes de que el objeto ObjectDataSourceView trate de realizar una operación de actualización.

RaiseUnsupportedCapabilityError(DataSourceCapabilities)

El método RaiseUnsupportedCapabilitiesError(DataSourceView) llama a este método para comparar las funciones solicitadas para una operación de ExecuteSelect(DataSourceSelectArguments) con las funciones que admite la vista.

(Heredado de DataSourceView)
SaveViewState()

Guarda los cambios del estado de vista del objeto ObjectDataSourceView desde el momento en que la página se devolvió al servidor.

Select(DataSourceSelectArguments, DataSourceViewSelectCallback)

Obtiene, de forma asincrónica, una lista de datos del espacio de almacenamiento de datos subyacente.

(Heredado de DataSourceView)
Select(DataSourceSelectArguments)

Recupera datos del objeto identificado por la propiedad TypeName llamando al método identificado por la propiedad SelectMethod y pasando los valores de la colección SelectParameters.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
TrackViewState()

Hace que el objeto ObjectDataSourceView realice el seguimiento de los cambios de su estado de vista de forma que dichos cambios se puedan guardar en el objeto ViewState del control y se conserven en distintas 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 el objeto DataSourceView representa.

(Heredado de DataSourceView)
Update(IDictionary, IDictionary, IDictionary)

Realiza una operación de actualización llamando al método identificado por la propiedad UpdateMethod y utilizando los parámetros suministrados en las colecciones keys, values o oldValues.

Eventos

DataSourceViewChanged

Se produce cuando la vista de origen de datos ha cambiado.

(Heredado de DataSourceView)
Deleted

Tiene lugar cuando se termina una operación de Delete.

Deleting

Tiene lugar antes de una operación de Delete.

Filtering

Se produce antes de una operación de filtrado.

Inserted

Tiene lugar cuando se termina una operación de Insert.

Inserting

Tiene lugar antes de una operación de Insert.

ObjectCreated

Tiene lugar una vez que el objeto ObjectDataSourceView ha creado una instancia del tipo identificado por la propiedad TypeName.

ObjectCreating

Tiene antes de que el objeto ObjectDataSourceView cree una instancia del tipo identificado por la propiedad TypeName.

ObjectDisposing

Tiene lugar cuando el objeto ObjectDataSourceView descarta una instancia de un objeto que ha creado.

Selected

Tiene lugar cuando se termina una operación de recuperación de datos.

Selecting

Tiene lugar antes de una operación de recuperación de datos.

Updated

Tiene lugar cuando se termina una operación de Update.

Updating

Tiene lugar antes de una operación de Update.

Implementaciones de interfaz explícitas

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().

Se aplica a

Consulte también