分離コードファイル内でのユーザーコントロールの開発

[アーティクル]
03/28/2008

分離コードファイルを使用して Web フォームページを作成できるのと同様に、ページが実行するロジック (分離コードファイル) から (.aspx ファイル内の) ユーザーインターフェイス (UI) 構文を切り離す方法で、ユーザーコントロールを作成できます。技術は同じですが、わずかな違いがあります。

メモ Visual Studio .NET などの RAD (Rapid Application Development) ツールを使用して ASP.NET アプリケーションを作成している場合、このツールは、既定では分離コード技術を使用してユーザーコントロールと Web フォームページを構築します。Visual Studio .NET を使って Web アプリケーションを作成する場合は、アプリケーションのすべてのページとユーザーコントロールで同じプログラミング言語を使用する必要があります。

分離コードファイルの中でユーザーコントロールを開発するには

ユーザーコントロールからアクセスする必要のある名前空間を含む分離コードファイルを作成します。少なくとも、名前空間 System と System.Web.UI、およびユーザーコントロールが必要とするその他の名前空間を含める必要があります。
```
Imports System
Imports System.Web.UI
Imports System.Web.UI.WebControls
[C#]
using System;
using System.Web.UI;
using System.Web.UI.WebControls;
```

UserControl クラスから継承するクラスを宣言し、そのクラスに目的の機能を持たせるためのコードを書きます。ユーザーコントロール用に記述したイベント処理メソッドがある場合は、それらも含めます。また、ユーザーコントロールの中で使用する予定のある ASP.NET サーバーコントロールのパブリックインスタンスを宣言します。

Public Class MyCodeBehind
Inherits UserControl

    Public Name As TextBox
    Public Result As Label

    Public Sub SubmitBtn_Click(sender As Object, e As EventArgs)
        Result.Text = "Hi, " & Name.Text & ", welcome to ASP.NET!"
    End Sub
End Class
[C#]
public class MyCodeBehind : UserControl {
    public TextBox   Name;
    public Label   Result;

    public void SubmitBtn_Click(Object sender, EventArgs e) {
        Result.Text = "Hi, " + Name.Text + ", welcome to ASP.NET!";   
    }
}

分離コードファイルに名前を付けます。ファイルの開発に使用した言語を反映した拡張子を必ず付けてください。適切な拡張子を指定しないと、コンパイルエラーが発生します。この例では、Visual Basic で開発したユーザーコントロールに UserControl.vb という名前、C# で開発したユーザーコントロールに UserControl.cs という名前を付けています。
.ascx ファイルを作成し、@ Control ディレクティブを使用して、ユーザーコントロールが継承するクラスの名前と、手順 1. で作成したソースファイルへのパスを指定します。サーバーコントロールと、ユーザーコントロールに表示するテキストを含めます。各サーバーコントロールについて ID 属性を宣言する場合は、その値が分離コードファイル内で作成したインスタンスの名前と一致することを確認してください。たとえば、次の <asp:textbox/> 要素内の ID 属性は Name であり、手順 2. の Name TextBox サーバーコントロールと一致しています。
```
<%@ control inherits = "MyCodeBehind" src = "UserControl.vb" %>
Name: <asp:textbox id="Name" runat="server"/> 
<asp:button text="Click Me" OnClick="SubmitBtn_Click" runat="server"/> 
<asp:label id="Result" runat = "server" />
[C#]
<%@ control inherits = "MyCodeBehind" src = "UserControl.cs" %>
Name: <asp:textbox id="Name" runat="server"/> 
<asp:button text="Click Me" OnClick="SubmitBtn_Click" runat="server"/> 
<asp:label id="Result" runat = "server" />
```
ユーザーコントロールの機能を使用する場所にする Web フォームページに、そのコントロールを含めます。詳細については「Web フォームページへのユーザーコントロールの取り込み」を参照してください。

参照

Web フォームユーザーコントロール | Web フォームのコードモデル | Web フォームページへのユーザーコントロールの取り込み | @ Control | UserControl

次の方法で共有

分離コードファイル内でのユーザーコントロールの開発

参照

その他のリソース

次の方法で共有

分離コード ファイル内でのユーザー コントロールの開発

参照

その他のリソース

分離コードファイル内でのユーザーコントロールの開発