カスタム コントロールを使用するアセンブリを WebForm に登録する
この記事では、カスタム サーバー コントロールで使用するアセンブリを WebForm で使用できるようにするため ASP.NET 情報を提供します。
元の製品バージョン: ASP.NET
元の KB 番号: 321749
サンプル アセンブリ プロパティ
カスタム サーバー コントロールとして表すには、アセンブリから直接または間接的に派生 System.Web.UI.Control
するクラスが必要であり、クラスを名前空間に囲む必要があります。 この記事のサンプルでは、クラスが名前空間で CustomControlNamespace
囲まれており、アセンブリが CustomControl.dllという名前 のファイルで正常にコンパイルされたことを前提としています。
アセンブリをアプリケーションで使用できるようにする ASP.NET
ASP.NET アプリケーションでアセンブリを使用できるようにするには、アセンブリの .dll をアプリケーションのフォルダーに配置する /bin
必要があります。
Windows エクスプローラーのアプリケーションのルート ディレクトリに移動します。
アプリケーション プロジェクト フォルダーの内容を確認するには:
- .NET 環境の [表示] メニューの [ソリューション エクスプローラー] を選択します。
- ソリューション エクスプローラーでプロジェクトメイン項目を右クリックし、[プロパティ] を選択します。
- [ プロジェクトのプロパティ ] ダイアログ ボックスで、[ 共通プロパティ ] を選択し、[全般] を選択 します。
ツリー ウィンドウに、 Project Folder プロパティを含む一覧が表示されます。 これは通常、アプリケーションのルート ディレクトリです。
Web アプリケーション プロジェクト フォルダーに bin という名前 のフォルダーが存在しない場合は作成します。
このフォルダー内のアセンブリの .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 1
parameter2
、実際のコードによって異なるオプションのコントロール プロパティです。
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示