カスタム コントロールを使用するアセンブリを WebForm に登録する

この記事では、カスタム サーバー コントロールで使用するアセンブリを WebForm で使用できるようにするため ASP.NET 情報を提供します。

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

サンプル アセンブリ プロパティ

カスタム サーバー コントロールとして表すには、アセンブリから直接または間接的に派生 System.Web.UI.Control するクラスが必要であり、クラスを名前空間に囲む必要があります。 この記事のサンプルでは、クラスが名前空間で CustomControlNamespace 囲まれており、アセンブリが CustomControl.dllという名前 のファイルで正常にコンパイルされたことを前提としています。

アセンブリをアプリケーションで使用できるようにする ASP.NET

ASP.NET アプリケーションでアセンブリを使用できるようにするには、アセンブリの .dll をアプリケーションのフォルダーに配置する /bin 必要があります。

1. Windows エクスプローラーのアプリケーションのルート ディレクトリに移動します。

   アプリケーション プロジェクト フォルダーの内容を確認するには:

   1. .NET 環境の [表示] メニューの [ソリューション エクスプローラー] を選択します。
   2. ソリューション エクスプローラーでプロジェクトメイン項目を右クリックし、[プロパティ] を選択します。
   3. [ プロジェクトのプロパティ ] ダイアログ ボックスで、[ 共通プロパティ ] を選択し、[全般] を選択 します。

   ツリー ウィンドウに、 Project Folder プロパティを含む一覧が表示されます。 これは通常、アプリケーションのルート ディレクトリです。

2. Web アプリケーション プロジェクト フォルダーに bin という名前 のフォルダーが存在しない場合は作成します。

3. このフォルダー内のアセンブリの .dll をコピーまたは移動します。 アプリケーションのルート ディレクトリ (またはそのサブフォルダー) の任意の ASP.NET ページからコントロールを使用できるようになりました。

アセンブリを ASP.NET アプリケーション Web フォームに登録する

.NET プログラミング環境で、 Form.aspx ソース ウィンドウを開き、コードの上部に次のタグを追加します。

<%@ Register TagPrefix="Custom" Namespace="CustomControlNamespace" Assembly= "CustomControl" %>

上記のコードについて:

• Custom は、名前空間に関連付けるエイリアスです。
• CustomControlNamespace は、アセンブリのクラスを囲む名前空間です。
• CustomControl は、拡張子のないアセンブリ ファイルの名前です (.dll)。

コードで、これらのパラメーターをアセンブリの適切な名前に変更します。

これで、アセンブリが Web フォームに登録されます。 この登録済みアセンブリは、選択した名前で ASP.NET コードで使用できます。 たとえば、タグは次のようになります。

<Custom:CustomControl id="CustomControl1" parameter1="value1" parameter2="value2" runat="server"/>

上記のタグでは、 Custom はアセンブリの名前空間に対して選択された名前であり、CustomControlカスタム サーバー コントロール名でありparameter 1parameter2、実際のコードによって異なるオプションのコントロール プロパティです。