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

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

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

ObjectDataSource.TypeName プロパティ

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

ObjectDataSource オブジェクトが表すクラスの名前を取得または設定します。

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

Visual Basic (宣言)

Public Property TypeName As
 String

Visual Basic (使用法)

Dim instance As ObjectDataSource
Dim value As String

value = instance.TypeName

instance.TypeName = value

public string TypeName { get;
 set; }

C++

public:
property String^ TypeName {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_TypeName ()

/** @property */
public void set_TypeName (String value)

JScript

public function get TypeName
 () : String

public function set TypeName
 (value : String)

プロパティ値
ObjectDataSource が表すオブジェクトの型を識別する部分修飾クラス名または完全修飾クラス名。既定値は空の文字列 ("") です。

解説

ObjectDataSource コントロールのバインド先となるオブジェクトのインスタンスを作成するために、このコントロールはリフレクションを使用して、実行時に型名で識別された型を読み込みます。したがって、TypeName プロパティの値には、Bin ディレクトリまたは App_Code ディレクトリにあるコードの部分修飾型、またはグローバルアセンブリキャッシュに登録されたコードの完全修飾型名を指定できます。グローバルアセンブリキャッシュを使用する場合、Machine.config ファイルまたは Web.config ファイルの assemblies セクションに適切な参照を追加する必要があります。

ObjectCreating イベントを処理して型のインスタンスを作成しない場合には、型は既定のコンストラクタを持つ必要があります。型のメソッドがメンバメソッドの場合、Select、Update、Insert、および Delete の各メソッドを呼び出すたびに、型のインスタンスが作成されます。メソッドが static (Visual Basic では Shared) の場合、インスタンスは作成されません。型が IDisposable インターフェイスを実装している場合は、オブジェクトが破棄される前に Dispose メソッドが呼び出されます。

使用例

GridView コントロールが Web フォーム上の ObjectDataSource コントロールを使用してデータを表示する方法を次のコード例に示します。ObjectDataSource は、TypeName プロパティで部分修飾クラス名または完全修飾クラス名を識別し、SelectMethodプロパティでデータを取得するために呼び出されるメソッドを識別します。実行時にオブジェクトが作成され、メソッドはリフレクションを使用して呼び出されます。GridView コントロールは、SelectMethod によって返された IEnumerable コレクションに対して列挙処理を実行し、データを表示します。

Visual Basic

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB"
 Assembly="Samples.AspNet.VB"
 %>
<%@ Page language="vb" %>
<html>
  <head>
    <title>ObjectDataSource - Visual Basic Example</title>
  </head>
  <body>
    <form id="Form1" method="post"
 runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.VB.EmployeeLogic"
 />

    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS"
 Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<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:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.CS.EmployeeLogic" />

    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL"
 Assembly="Samples.AspNet.JSL" %>
<%@ Page language="VJ#" %>
<html>
  <head>
    <title>ObjectDataSource - VJ# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.JSL.EmployeeLogic" />

    </form>
  </body>
</html>