ObjectDataSourceEventArgs ObjectDataSourceEventArgs ObjectDataSourceEventArgs ObjectDataSourceEventArgs Class

Определение

Предоставляет данные для событий ObjectCreating и ObjectCreated элемента управления ObjectDataSource.Provides data for the ObjectCreating and ObjectCreated events of the ObjectDataSource control.

public ref class ObjectDataSourceEventArgs : EventArgs
public class ObjectDataSourceEventArgs : EventArgs
type ObjectDataSourceEventArgs = class
    inherit EventArgs
Public Class ObjectDataSourceEventArgs
Inherits EventArgs
Наследование
ObjectDataSourceEventArgsObjectDataSourceEventArgsObjectDataSourceEventArgsObjectDataSourceEventArgs

Примеры

Этот раздел содержит два примера кода.This section contains two code examples. В первом примере кода показано, как использовать ObjectDataSource элемент управления с бизнес-объектом GridView и элементом управления для извлечения и отображения информации.The first code example demonstrates how to use an ObjectDataSource control with a business object and a GridView control to retrieve and display information. Во втором примере кода представлен пример базового бизнес-объекта, используемого в первом примере кода.The second code example provides the example basic business object that the first code example uses.

В следующем примере кода показано, как использовать ObjectDataSource элемент управления с бизнес-объектом GridView и элементом управления для извлечения и отображения информации.The following code example demonstrates how to use an ObjectDataSource control with a business object and a GridView control to retrieve and display information. В этом примере, как и во многих реальных сценариях, может оказаться невозможным использовать экземпляр бизнес-объекта по умолчанию с ObjectDataSource элементом управления.In this example, as in many real-world scenarios, it might not be possible nor appropriate to use a default instance of the business object with the ObjectDataSource control. В этом примере ObjectDataSource метод не может успешно вызвать конструктор без параметров, так как он выдаст исключение.In this example, the ObjectDataSource cannot successfully call the parameterless constructor because it will throw an exception. В некоторых случаях конструктор без параметров может быть защищенным, а другие могут не инициализировать бизнес-объект до нужного состояния.In some cases, the parameterless constructor might be protected and in others it might not initialize the business object to a desired state. Независимо от причины, можно создать экземпляр бизнес-объекта самостоятельно и установить для ObjectInstance экземпляра свойство ObjectDataSourceEventArgs объекта, передаваемого в обработчик.Whatever the reason, you can create an instance of the business object yourself and set the instance to the ObjectInstance property of the ObjectDataSourceEventArgs object that is passed to the handler. Это экземпляр бизнес-объекта, который ObjectDataSource будет использоваться для выполнения своей работы.This is the business object instance that the ObjectDataSource will use to perform its work.

<%@ 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>

В следующем примере кода показан пример базового бизнес-объекта, используемого в предыдущем примере кода.The following code example demonstrates the example basic business object that the preceding code example uses.

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
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 'New
    
    
    Public Sub New(ByVal data As String) 
        _data = data
    
    End Sub 'New
    
    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 'EmployeeLogic 
End Namespace ' Samples.AspNet.VB

Комментарии

Класс используется OnObjectCreated в методах ObjectDataSource и для предоставления доступа к экземпляру бизнес-объекта перед выполнением любых операций с данными, использующих элемент управления и бизнес-объект. OnObjectCreating ObjectDataSourceEventArgsThe ObjectDataSourceEventArgs class is used in the OnObjectCreating and OnObjectCreated methods to provide access to the business object instance before any data operations that are using the ObjectDataSource control and business object are performed. Бизнес-объект задается и получает доступ ObjectInstance с помощью свойства.The business object is set and accessed using the ObjectInstance property. Добавляя делегат обработчика событий для обработки ObjectCreating события, можно создать экземпляр бизнес-объекта в пользовательском коде, а не ObjectDataSource выполнять создание экземпляра.By adding an event handler delegate to handle the ObjectCreating event, you can create an instance of the business object in custom code instead of the ObjectDataSource performing the instantiation. Это полезно, если требуется не заданный по умолчанию экземпляр бизнес-объекта или вызов конструктора без параметров для создания экземпляра. метод ObjectDataSource всегда вызывает конструктор без параметров, чтобы создать экземпляр бизнес-объекта, с которым он работает.This is useful when you want a non-default instance of your business object or to call a non-parameterless constructor to create the instance; the ObjectDataSource always calls the parameterless constructor to create an instance of the business object it works with. Можно также добавить делегат обработчика событий для обработки ObjectCreated события, что позволяет получать доступ к любым открытым членам бизнес-объекта для выполнения любой дополнительной инициализации или работы.You can also add an event handler delegate to handle the ObjectCreated event, which enables you to access any publicly exposed members of the business object to perform any additional initialization or work.

ObjectDataSource staticМетоды OnObjectCreating иOnObjectCreated не вызываются элементом управления, если метод бизнес-объекта, выполняющий операции с данными, —.The OnObjectCreating and OnObjectCreated methods are not called by the ObjectDataSource control, if the business object method that performs the data operations is static.

ObjectDataSource Элемент управления предоставляет множество событий, которые можно обойти для работы с базовым бизнес-объектом в различные моменты жизненного цикла.The ObjectDataSource control exposes many events that you can handle to work with the underlying business object at various times in its lifecycle. В следующей таблице перечислены события и связанные с ними EventArgs классы и делегаты обработчиков событий.The following table lists the events and the associated EventArgs classes and event handler delegates.

событиеEvent EventArgsEventArgs EventHandlerEventHandler
ObjectCreating.ObjectCreating.

Происходит непосредственно перед созданием экземпляра бизнес-объекта.Occurs immediately before the instance of the business object is created.
ObjectDataSourceEventArgs ObjectDataSourceObjectEventHandler
ObjectCreated.ObjectCreated.

Происходит сразу после создания экземпляра бизнес-объекта.Occurs immediately after the instance of the business object is created.
ObjectDataSourceEventArgs ObjectDataSourceObjectEventHandler
Selecting.Selecting.

Происходит перед извлечением данных.Occurs before the data is retrieved.
ObjectDataSourceSelectingEventArgs ObjectDataSourceSelectingEventHandler
Inserting, Updating и Deleting.Inserting, Updating, and Deleting.

Происходит перед выполнением операции вставки, обновления или удаления.Occur before an insert, update, or delete operation is performed.
ObjectDataSourceMethodEventArgs ObjectDataSourceMethodEventHandler
Selected.Selected.

Происходит после извлечения данных.Occurs after the data is retrieved.
ObjectDataSourceStatusEventArgs ObjectDataSourceStatusEventHandler
Inserted, Updated, Deleted.Inserted, Updated, Deleted.

Происходит после завершения операции вставки, обновления или удаления.Occur after the insert, update, or delete operation is completed.
ObjectDataSourceStatusEventArgs ObjectDataSourceStatusEventHandler
ObjectDisposing.ObjectDisposing.

Происходит перед уничтожением бизнес-объекта.Occurs before a business object is destroyed.
ObjectDataSourceDisposingEventArgs ObjectDataSourceDisposingEventHandler

Конструкторы

ObjectDataSourceEventArgs(Object) ObjectDataSourceEventArgs(Object) ObjectDataSourceEventArgs(Object) ObjectDataSourceEventArgs(Object)

Инициализирует новый экземпляр класса ObjectDataSourceEventArgs, используя заданный объект.Initializes a new instance of the ObjectDataSourceEventArgs class using the specified object.

Свойства

ObjectInstance ObjectInstance ObjectInstance ObjectInstance

Получает или задает объект, представляющий бизнес-объект, совместно с которым элемент управления ObjectDataSource выполняет операции с данными.Gets or sets an object that represents the business object with which the ObjectDataSource control performs data operations.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Применяется к

Дополнительно