ObjectDataSourceEventArgs.ObjectInstance プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ObjectDataSourceEventArgs.ObjectInstance プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ObjectDataSource コントロールがデータ操作を実行するビジネスオブジェクトを表すオブジェクトを取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property ObjectInstance As
 Object

Visual Basic (使用法)

Dim instance As ObjectDataSourceEventArgs
Dim value As Object

value = instance.ObjectInstance

instance.ObjectInstance = value

public Object ObjectInstance { get; set;
 }

C++

public:
property Object^ ObjectInstance {
    Object^ get ();
    void set (Object^ value);
}

/** @property */
public Object get_ObjectInstance ()

/** @property */
public void set_ObjectInstance (Object value)

JScript

public function get ObjectInstance
 () : Object

public function set ObjectInstance
 (value : Object)

プロパティ値
ObjectDataSource がデータ操作を実行するために使用するビジネスオブジェクト。それ以外の場合、ObjectDataSourceEventArgs に null 参照 (Visual Basic では Nothing) が渡されるときは null 参照 (Visual Basic では Nothing)。

使用例

このセクションには、2 つのコード例が含まれています。ビジネスオブジェクトおよび GridView コントロールで、ObjectDataSource コントロールを使用して情報を取得および表示する方法を最初のコード例に示します。最初のコード例が使用する基本的なビジネスオブジェクトの例を 2 番目のコード例に示します。

ビジネスオブジェクトおよび GridView コントロールで、ObjectDataSource コントロールを使用して情報を取得および表示する方法を次のコード例に示します。この例では、現実世界の状況と同じように、ObjectDataSource コントロールでビジネスオブジェクトの既定のインスタンスを使用することができず、不適切である場合があります。この例では、ObjectDataSource は例外をスローするため、既定のコンストラクタを正常に呼び出すことができません。既定のコンストラクタが保護される場合もあれば、既定のコンストラクタではビジネスオブジェクトが目的の状態に初期化されない場合もあります。原因が何でも、ビジネスオブジェクトのインスタンスを自分で作成して、ハンドラに渡される ObjectDataSourceEventArgs オブジェクトの ObjectInstance プロパティにそのインスタンスを設定できます。これは、ObjectDataSource が作業の実行に使用するビジネスオブジェクトインスタンスです。

Visual Basic

<%@ Import namespace="Samples.AspNet.VB"
 %>
<%@ Page language="vb" %>
<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>
  <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>

<%@ Import namespace="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<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>
  <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>

前のコード例が使用する基本的なビジネスオブジェクトの例を次のコード例に示します。

Visual Basic

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

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;
    }
    
  }

}