ObjectDataSourceEventArgs 類別

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

提供資料給 ObjectCreating 控制項的 ObjectCreated 和 ObjectDataSource 事件。

public ref class ObjectDataSourceEventArgs : EventArgs

public class ObjectDataSourceEventArgs : EventArgs

type ObjectDataSourceEventArgs = class
    inherit EventArgs

Public Class ObjectDataSourceEventArgs
Inherits EventArgs

繼承: Object

EventArgs
ObjectDataSourceEventArgs

範例

本節包含兩個程式碼範例。第一個 ObjectDataSource 程式碼範例示範如何使用控制項搭配商務物件和 GridView 控制項來擷取和顯示資訊。第二個程式碼範例提供第一個程式碼範例所使用的範例基本商務物件。

下列程式碼範例示範如何使用 ObjectDataSource 控制項搭配商務物件和 GridView 控制項來擷取和顯示資訊。在此範例中，如同許多真實世界的案例，可能也不適合搭配 ObjectDataSource 控制項使用商務物件的預設實例。在此範例中 ObjectDataSource ，無法成功呼叫無參數建構函式，因為它會擲回例外狀況。在某些情況下，無參數建構函式可能會受到保護，而在某些情況下，它可能不會將商務物件初始化為所需的狀態。不論原因為何，您可以自行建立商務物件的實例，並將實例 ObjectInstance 設定為傳遞至處理常式之 ObjectDataSourceEventArgs 物件的屬性。這是將用來執行其工作的商務物件實例 ObjectDataSource 。

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

下列程式碼範例示範上述程式碼範例所使用的範例基本商務物件。

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

備註

和 OnObjectCreated 方法中 OnObjectCreating 會使用類別 ObjectDataSourceEventArgs ，在執行任何使用控制項和商務物件的資料作業之前，供應商務物件實例的 ObjectDataSource 存取權。商務物件是使用 ObjectInstance 屬性來設定和存取。藉由新增事件處理常式委派來處理 ObjectCreating 事件，您可以在自訂程式碼中建立商務物件的實例，而不是 ObjectDataSource 執行具現化。當您想要商務物件的非預設實例，或呼叫非無參數建構函式來建立實例時，這會很有用;一 ObjectDataSource 律會呼叫無參數建構函式，以建立其運作的商務物件實例。您也可以新增事件處理常式委派來處理 ObjectCreated 事件，這可讓您存取任何公開的商務物件成員，以執行任何其他初始化或工作。

OnObjectCreating如果執行資料作業的商務物件方法為 static ，則控制項不會呼叫 ObjectDataSource 和 OnObjectCreated 方法。

控制項 ObjectDataSource 會公開許多事件，您可以處理這些事件，以在其生命週期的各個時間使用基礎商務物件。下表列出事件和相關聯的 EventArgs 類別和事件處理常式委派。

事件	EventArgs	EventHandler
ObjectCreating. 會在建立商務物件的實例之前立即發生。	ObjectDataSourceEventArgs	ObjectDataSourceObjectEventHandler
ObjectCreated. 會在建立商務物件的實例之後立即發生。	ObjectDataSourceEventArgs	ObjectDataSourceObjectEventHandler
Selecting. 發生于擷取資料之前。	ObjectDataSourceSelectingEventArgs	ObjectDataSourceSelectingEventHandler
Inserting Updating和 Deleting。發生于執行插入、更新或刪除作業之前。	ObjectDataSourceMethodEventArgs	ObjectDataSourceMethodEventHandler
Selected. 發生于擷取資料之後。	ObjectDataSourceStatusEventArgs	ObjectDataSourceStatusEventHandler
Inserted, Updated, Deleted. 發生于插入、更新或刪除作業完成之後。	ObjectDataSourceStatusEventArgs	ObjectDataSourceStatusEventHandler
ObjectDisposing. 在終結商務物件之前發生。	ObjectDataSourceDisposingEventArgs	ObjectDataSourceDisposingEventHandler

建構函式

ObjectDataSourceEventArgs(Object)

使用指定的物件，初始化 ObjectDataSourceEventArgs 類別的新執行個體。

屬性

ObjectInstance

取得或設定物件，表示 ObjectDataSource 用來執行資料作業的商務物件。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

適用於

另請參閱

ObjectDataSourceObjectEventHandler

共用方式為

ObjectDataSourceEventArgs 類別

定義

範例

備註

建構函式

屬性

方法

適用於

另請參閱

其他資源