ASP.NET サーバーコントロールの概要

2023-07-17

この記事では、HTML サーバーコントロール、Web サーバーコントロール、リストコントロールなど、ASP.NET サーバーコントロールについて説明します。

元の製品バージョン: ASP.NET
元の KB 番号: 306459

この記事では、次の Microsoft .NET Framework クラスライブラリ名前空間について説明します。

System.Web.UI.HtmlControls.HtmlControl
System.Web.UI.WebControls.WebControl

ASP.NET ページフレームワークのサーバーコントロール

ASP.NET ページフレームワークには、Web 用のより構造化されたプログラミングモデルを提供するように設計された多数の組み込みサーバーコントロールが含まれています。これらのコントロールには、次の機能があります。

自動状態管理。
Request オブジェクトを使用しなくても、オブジェクト値に簡単にアクセスできます。
サーバー側コードのイベントに対応して、より構造化されたアプリケーションを作成する機能。
Web ページのユーザーインターフェイスを構築するための一般的なアプローチ。
出力は、ブラウザーの機能に基づいて自動的にカスタマイズされます。

ASP.NET ページフレームワークには、組み込みのコントロールに加えて、ユーザーコントロールとカスタムコントロールを作成する機能も用意されています。ユーザーコントロールとカスタムコントロールを使用すると、既存のコントロールを拡張して、より豊富なユーザーインターフェイスを構築できます。

HTML サーバーコントロール

HTML サーバーコントロールは、 runat=server 属性を含む HTML 要素です。 HTML サーバーコントロールには、対応する HTML タグと同じ HTML 出力と同じプロパティがあります。さらに、HTML サーバーコントロールは、自動状態管理とサーバー側イベントを提供します。 HTML サーバーコントロールには、次の利点があります。

HTML サーバーコントロールは、対応する HTML タグを使用して 1 つにマップします。
ASP.NET アプリケーションがコンパイルされると、 runat=server 属性を持つ HTML サーバーコントロールがアセンブリにコンパイルされます。
ほとんどのコントロールには、最も一般的に使用されるコントロールのイベントの OnServerEvent が含まれます。たとえば、 <input type=button> コントロールには OnServerClick イベントがあります。
特定の HTML サーバーコントロールとして実装されていない HTML タグは、サーバー側で引き続き使用できます。ただし、 HtmlGenericControlとしてアセンブリに追加されます。
ASP.NET ページが再ポストされると、HTML サーバーコントロールは値を保持します。

System.Web.UI.HtmlControls.HtmlControl基本クラスには、すべての共通プロパティが含まれています。 HTML サーバーコントロールは、このクラスから派生します。

HTML サーバーコントロールを使用するには、次の構文を使用します ( HtmlInputText コントロールを例として使用します)。

<input type="text" value="hello world" runat=server />

ASP.NET で使用できる個々の HTML サーバーコントロールの詳細については、次の Web サイトを参照してください。

Web サーバーコントロール

Web コントロールは、Button、TextBox、Hyperlink などの HTML サーバーコントロールに似ていますが、Web コントロールには標準化されたプロパティ名のセットがあることを除きます。 Web サーバーコントロールには、次の利点があります。

製造元や開発者が、ユーザーインターフェイスを自動的に生成するツールやアプリケーションを簡単に構築できるようにします。
対話型 Web フォームを作成するプロセスを簡略化します。HTML コントロールの動作に関する知識が少なくて済み、それらを使用するタスクがエラーになりにくくなります。

System.Web.UI.WebControls.WebControl基本クラスには、すべての共通プロパティが含まれています。ほとんどの Web サーバーコントロールは、このクラスから派生します。

Web サーバーコントロールを使用するには、次の構文を使用します (TextBox コントロールを例として使用します)。

<asp:textbox text="hello world" runat=server />

Web サーバーコントロールは、次の 4 つのカテゴリに分類できます。

基本的な Web コントロール
検証コントロール
リストコントロール
リッチコントロール

基本的な Web コントロール

基本的な Web コントロールは、対応する HTML サーバーコントロールと同じ機能を提供します。ただし、基本的な Web コントロールには、プログラミングできる追加のメソッド、イベント、およびプロパティが含まれます。

ASP.NET で使用できる個々の Web コントロールの詳細については、次の Web サイトを参照してください。

検証コントロール

検証コントロールは、ページの他のコントロールに入力された値を検証するために使用されます。検証コントロールは、ページが表示されるブラウザーの機能に応じて、クライアント側の検証、サーバー側の検証、またはその両方を実行します。検証コントロールには、次の利点があります。

検証する各コントロールに 1 つ以上の検証コントロールを関連付けることができます。
検証は、ページフォームが送信されるときに実行されます。
検証を実行するかどうかをプログラムで指定できます。これは、すべてのフィールドに有効なデータを入力しなくてもユーザーが終了できるようにキャンセルボタンを指定する場合に便利です。
検証コントロールは、検証をクライアント側またはサーバー側で実行する必要があるかどうかを自動的に検出します。

Note

クライアント側の検証では、ポストバック操作が完了する前にエラーがキャッチされます。そのため、1 つのページにクライアント側とサーバー側の検証コントロールの組み合わせがある場合、クライアント側の検証が失敗した場合、サーバー側の検証が優先されます。ASP.NET で使用できる個々の検証コントロールの詳細については、次の Web サイトを参照してください。

List コントロール

リストコントロールは、コレクションへのバインドをサポートする特別な Web サーバーコントロールです。リストコントロールを使用すると、カスタマイズされたテンプレートの形式でデータの行を表示できます。すべてのリストコントロールは、コレクションへのバインドに使用される DataSource プロパティと DataMember プロパティを公開します。

リストコントロールは、IEnumerable、ICollection、または IListSource インターフェイスをサポートするコレクションにのみバインドできます。たとえば、Visual C# .NET サンプルページは次のように表示されます。

<%@ Page Language="C#" %>
<script runat="server">
    Public void Page_Load()
    {
        String[] myStringArray = new String[] {"one","two","three"};
        rptr.DataSource = myStringArray;
        rptr.DataBind();
    }
</script>
<html>
    <body>
        <asp:repeater id=rptr runat="server">
            <itemtemplate><%# Container.DataItem %><br></itemtemplate>
        </asp:repeater>
    </body>
</html>

Visual Basic .NET のサンプルページは次のように表示されます。

<%@ Page Language="vb" %>
<script runat="server">
    public sub Page_Load()
        Dim myStringArray as String()
        myStringArray = new String() {"one","two","three"}
        rptr.DataSource = myStringArray
        rptr.DataBind()
    end sub
</script>
<html>
    <body>
        <asp:repeater id=rptr runat="server">
            <itemtemplate><%# Container.DataItem %><br></itemtemplate>
        </asp:repeater>
    </body>
</html>

出力は次のようになります。

1
2 つ
3 つ

ASP.NET で使用できる個々のリストコントロールの詳細については、次の Web サイトを参照してください。

豊富なコントロール

上記のコントロールに加えて、ASP.NET ページフレームワークには、リッチコントロールと呼ばれるタスク固有のコントロールがいくつか用意されています。豊富なコントロールは、複数の HTML 要素で構築され、豊富な機能を備えています。豊富なコントロールの例として、Calendar コントロールと AdRotator コントロールがあります。

ASP.NET で使用できる個々のリッチコントロールの詳細については、次の Web サイトを参照してください。

ユーザー向けの制御

多くの場合、追加のコードを記述しなくても、Web フォームのユーザーインターフェイスを再利用できます。 ASP.NET では、Web フォームをユーザーコントロールに変換することでこれを行うことができます。 .ascx ファイル拡張子を持つユーザーコントロールは、1 つの Web フォーム内で複数回使用できます。

Web フォームをユーザーコントロールに変換するには、次の手順に従います。

すべての <html>、 <head>、 <body>、および <form> タグを削除します。
ページに @ Page ディレクティブが表示される場合は、 @ Controlに変更します。
インスタンス化するときにユーザーコントロールが厳密に型指定されるように、@ Control ディレクティブにclassName属性を含めます。
コントロールにわかりやすいファイル名を付け、ファイル拡張子を .aspx から .ascx に変更します。

ユーザーコントロールの詳細については、「 Web フォームユーザーコントロールを参照してください。

カスタムコントロール

ASP.NET では、組み込みの Web コントロールに加えて、独自のカスタムコントロールを作成することもできます。次のいずれかのシナリオに直面している場合は、カスタムコントロールを開発すると便利な場合があります。

2 つ以上の組み込み Web コントロールの機能を組み合わせる必要があります。
組み込みコントロールの機能を拡張する必要があります。
現在存在するコントロールとは異なるコントロールが必要です。

カスタムコントロールの開発の詳細については、次のトピックを参照してください。

次の方法で共有

ASP.NET サーバー コントロールの概要

ASP.NET ページ フレームワークのサーバー コントロール

HTML サーバー コントロール

Web サーバー コントロール