ObjectDataSourceEventArgs Clase
Definición
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í.
Proporciona datos para los eventos ObjectCreating y ObjectCreated del control ObjectDataSource.
public ref class ObjectDataSourceEventArgs : EventArgspublic class ObjectDataSourceEventArgs : EventArgstype ObjectDataSourceEventArgs = class
inherit EventArgsPublic Class ObjectDataSourceEventArgs
Inherits EventArgs- Herencia
Ejemplos
Esta sección contiene dos ejemplos de código. En el primer ejemplo de código se muestra cómo usar un ObjectDataSource control con un objeto de negocio y un GridView control para recuperar y mostrar información. En el segundo ejemplo de código se proporciona el objeto empresarial básico de ejemplo que usa el primer ejemplo de código.
En el ejemplo de código siguiente se muestra cómo usar un ObjectDataSource control con un objeto de negocio y un GridView control para recuperar y mostrar información. En este ejemplo, como en muchos escenarios reales, es posible que no sea posible ni adecuado usar una instancia predeterminada del objeto de negocio con el ObjectDataSource control . En este ejemplo, no ObjectDataSource puede llamar correctamente al constructor sin parámetros porque producirá una excepción. En algunos casos, el constructor sin parámetros podría estar protegido y, en otros, podría no inicializar el objeto de negocio en un estado deseado. Sea cual sea el motivo, puede crear una instancia del objeto de negocio usted mismo y establecer la instancia en la ObjectInstance propiedad del ObjectDataSourceEventArgs objeto que se pasa al controlador. Se trata de la instancia de objeto empresarial que ObjectDataSource usará para realizar su trabajo.
<%@ Import namespace="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
private void NorthwindLogicCreating(object sender, ObjectDataSourceEventArgs e)
{
// Create an instance of the business object using a non-default constructor.
EmployeeLogic eLogic = new EmployeeLogic("Not created by the default constructor!");
// Set the ObjectInstance property so that the ObjectDataSource uses the created instance.
e.ObjectInstance = eLogic;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:gridview
id="GridView1"
runat="server"
datasourceid="ObjectDataSource1">
</asp:gridview>
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployees"
onobjectcreating="NorthwindLogicCreating"
typename="Samples.AspNet.CS.EmployeeLogic" >
</asp:objectdatasource>
</form>
</body>
</html>
<%@ Import namespace="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Private Sub NorthwindLogicCreating(sender As Object, e As ObjectDataSourceEventArgs)
' Create an instance of the business object using a non-default constructor.
Dim eLogic As EmployeeLogic = New EmployeeLogic("Not created by the default constructor!")
' Set the ObjectInstance property so that the ObjectDataSource uses the created instance.
e.ObjectInstance = eLogic
End Sub ' NorthwindLogicCreating
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - VB Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:gridview
id="GridView1"
runat="server"
datasourceid="ObjectDataSource1">
</asp:gridview>
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployees"
onobjectcreating="NorthwindLogicCreating"
typename="Samples.AspNet.VB.EmployeeLogic" >
</asp:objectdatasource>
</form>
</body>
</html>
En el ejemplo de código siguiente se muestra el objeto empresarial básico de ejemplo que usa el ejemplo de código anterior.
namespace Samples.AspNet.CS {
using System;
using System.Collections;
using System.Web.UI;
using System.Web.UI.WebControls;
public class EmployeeLogic {
public EmployeeLogic() {
throw new NotSupportedException("Initialize data.");
}
public EmployeeLogic(string data) {
_data = data;
}
private string _data;
// Returns a collection of NorthwindEmployee objects.
public ICollection GetAllEmployees () {
ArrayList al = new ArrayList();
al.Add(_data);
return al;
}
}
}
Imports System.Collections
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace Samples.AspNet.VB
Public Class EmployeeLogic
Public Sub New()
Throw New NotSupportedException("Initialize data.")
End Sub
Public Sub New(ByVal data As String)
_data = data
End Sub
Private _data As String
' Returns a collection of NorthwindEmployee objects.
Public Function GetAllEmployees() As ICollection
Dim al As New ArrayList()
al.Add(_data)
Return al
End Function 'GetAllEmployees
End Class
End Namespace ' Samples.AspNet.VB
Comentarios
La ObjectDataSourceEventArgs clase se usa en los OnObjectCreating métodos y OnObjectCreated para proporcionar acceso a la instancia de objeto de negocio antes de que se realicen las operaciones de datos que usan el control y el ObjectDataSource objeto de negocio. El objeto de negocio se establece y se obtiene acceso mediante la ObjectInstance propiedad . Al agregar un delegado de controlador de eventos para controlar el ObjectCreating evento, puede crear una instancia del objeto de negocio en código personalizado en lugar de realizar ObjectDataSource la creación de instancias. Esto resulta útil cuando se desea una instancia no predeterminada del objeto de negocio o llamar a un constructor sin parámetros para crear la instancia; el ObjectDataSource siempre llama al constructor sin parámetros para crear una instancia del objeto de negocio con el que funciona. También puede agregar un delegado de controlador de eventos para controlar el ObjectCreated evento, lo que le permite acceder a cualquier miembro expuesto públicamente del objeto de negocio para realizar cualquier inicialización o trabajo adicional.
El OnObjectCreating control no llama a los ObjectDataSource métodos y OnObjectCreated , si el método de objeto de negocio que realiza las operaciones de datos es static.
El ObjectDataSource control expone muchos eventos que puede controlar para trabajar con el objeto de negocio subyacente en varias ocasiones en su ciclo de vida. En la tabla siguiente se enumeran los eventos y las clases asociadas EventArgs y los delegados del controlador de eventos.
Constructores
| ObjectDataSourceEventArgs(Object) |
Inicializa una nueva instancia de la clase ObjectDataSourceEventArgs usando el objeto especificado. |
Propiedades
| ObjectInstance |
Obtiene o establece un objeto que representa el objeto de negocios con el que el control ObjectDataSource realiza las operaciones de datos. |
Métodos
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
