ObjectDataSourceView Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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: Object

DataSourceView
ObjectDataSourceView

Implementaciones: IStateManager

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 ObjectDataSourceView ObjectDataSource. 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:

El método Select
La propiedad SelectMethod
La propiedad SelectParameters
Al evento Selecting
Al evento Selected

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:

El método Update
La propiedad UpdateMethod
La propiedad UpdateParameters
Al evento Updating
Al evento Updated

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 GridView 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 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:

El método Insert
La propiedad InsertMethod
La propiedad InsertParameters
Al evento Inserting
Al evento Inserted

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 GridView 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 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:

El método Delete
La propiedad DeleteMethod
La propiedad DeleteParameters
Al evento Deleting
Al evento Deleted

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

Comparteix a través de