ObjectDataSourceEventArgs 클래스

정의

ObjectCreating 컨트롤의 ObjectCreatedObjectDataSource 이벤트에 대한 데이터를 제공합니다.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
상속
ObjectDataSourceEventArgs

예제

이 섹션에는 두 코드 예제가 있습니다.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 에서는가 예외를 throw 하기 때문에 매개 변수가 없는 생성자를 성공적으로 호출할 수 없습니다.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.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

설명

ObjectDataSourceEventArgs 클래스에서 사용 됩니다는 OnObjectCreatingOnObjectCreated 사용 하는 데이터 작업 하기 전에 비즈니스 개체 인스턴스에 대 한 액세스를 제공 하는 메서드를 ObjectDataSource 제어 및 비즈니스 개체 수행 됩니다.The 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.

OnObjectCreating 하 고 OnObjectCreated 메서드에 의해 호출 되지 않습니다는 ObjectDataSource 비즈니스 개체 메서드 데이터 작업을 수행 하는 경우이 컨트롤 static합니다.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 이벤트 처리기EventHandler
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, UpdatingDeletingInserting, 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 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ObjectDataSourceEventArgs class using the specified object.

속성

ObjectInstance

ObjectDataSource 컨트롤이 데이터 작업을 수행할 때 함께 사용할 비즈니스 개체를 나타내는 개체를 가져오거나 설정합니다.Gets or sets an object that represents the business object with which the ObjectDataSource control performs data operations.

메서드

Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

적용 대상

추가 정보