ASP.NET ディレクティブは、カスタム コントロールやページの言語の登録など、オプションの設定を指定するための命令です。これらの設定は、NET Framework が単一ページ フォーム (.aspx) またはユーザー コントロール (.ascx) Web ページを処理する方法を記述します。
コマンドを発行するための基本的な構文:
<%@ directive_name attribute=value [attribute=value] %>このセクションでは、ASP.NET ディレクティブを紹介します。そのほとんどはチュートリアル全体で使用されます。
アプリケーション ディレクティブは、アプリケーション固有のプロパティを定義します。これは、global.aspx ファイルの先頭に提供されます。
アプリケーション命令の基本構文:
<%@ Application Language="C#" %>アプリケーション ディレクティブのプロパティ:
| 財産 | 説明する |
|---|---|
| 継承する | クラス名から継承されます。 |
| 説明 | アプリケーションのテキストによる説明。パーサーとコンパイラーはこれを無視します。 |
| 言語 | コードグループで使用される言語。 |
コレクション ディレクティブは、分析中にコンポーネントを Web ページまたはアプリケーションにリンクします。これは、Global.asax ファイル、ページ ファイル、別の Web ページにリンクするユーザー コントロール、またはユーザー コントロール内のアプリケーション タイプ リンク全体で発生する可能性があります。
コレクション コントロールの基本構文は次のとおりです。
<%@ Assembly Name ="myassembly" %>コレクション コントロールのプロパティは次のとおりです。
| 財産 | 説明する |
|---|---|
| 名前 | リンクされたコレクションコンポーネントの名前。 |
| 送信元 | ソース ファイルが動的にリンクされ、編集されるパス。 |
コントロール命令はユーザー コントロールで使用され、ユーザー コントロール (.ascx) ファイルに表示されます。
制御命令の基本的な構文は次のとおりです。
<%@ Control Language="C#" EnableViewState="false" %>制御命令のプロパティは次のとおりです。
| 財産 | 説明する |
|---|---|
| 自動イベントワイヤアップ | イベント ハンドラーの自動関連付けを許可または無効にするブール値。 |
| クラス名 | コントロールのファイル名。 |
| デバッグ | デバッグ シンボルの編集を許可または無効にするブール値。 |
| 説明 | コントロール ページのテキスト説明。コンパイラによって無視されます。 |
| ビューステートを有効にする | ページリクエストは、ビューステートを維持するかどうかを示すブール値です。 |
| 明示的な | VB 言語では、エディターにオプション表示モードを使用するように指示します。 |
| 継承する | ページによって継承されるクラスを制御します。 |
| 言語 | コーディング言語とスクリプト言語。 |
| 送信元 | コードビハインド クラスのファイル名。 |
| 厳しい | VB 言語では、オプション「標準モード」を使用するようにエディターに指示します。 |
ツール ディレクティブは、Web ページ、マスター ページ、またはユーザー コントロール ページが指定された .Net Framework インターフェイスを実装する必要があることを示します。
ツール命令の基本的な構文は次のとおりです。
<%@ Implements Interface="interface_name" %>import ディレクティブは、ユーザー制御アプリケーションのページに名前空間をインポートします。 Import ディレクティブが global.asax ファイルで指定されている場合、それはアプリケーション全体に適用されます。ユーザー制御ページ内の Web ページにある場合は、その Web ページまたはコントロールに適用されます。
import ディレクティブの基本的な構文は次のとおりです。
<%@ namespace="System.Drawing" %>main ディレクティブは、ページ ファイルをホームページとして指定します。
サンプルのホームページ ディレクティブの基本構文は次のとおりです。
<%@ MasterPage Language="C#" AutoEventWireup="true" CodeFile="SiteMater.master.cs" Inherits="SiteMaster" %>MasterType ディレクティブは、ページのマスター属性にクラス名を割り当て、そのタイプを強化します。
マスター ディレクティブの基本構文は次のとおりです。
<%@ MasterType attribute="value"[attribute="value" ...] %>出力キャッシュ ディレクティブは、Web ページまたはユーザー コントロールの出力キャッシュ ポリシーを制御します。
出力キャッシュ命令の基本構文:
<%@ OutputCache Duration="15" VaryByParam="None" %>ページ ディレクティブは、特定のページ パーサーおよびコンパイラーのページ ファイル属性を定義します。
ページ ディレクティブの基本構文は次のとおりです。
%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" Trace="true" %>ページ ディレクティブのプロパティは次のとおりです。
| 財産 | 説明する |
|---|---|
| 自動イベントワイヤアップ | Page_Load などのメソッドに自動的にバインドされるページ イベントを許可または無効にするブール値。 |
| バッファ | HTTP 応答のバッファリングを許可または無効にするブール値。 |
| クラス名 | ページのカテゴリ名。 |
| クライアントターゲット | サーバー コントロールはコンテンツをブラウザーにレンダリングする必要があります。 |
| コードファイル | コードビハインドファイルの名前。 |
| デバッグ | デバッグ シンボルを使用したコンパイルを許可または無効にするブール値。 |
| 説明 | ページのファイル説明。パーサーによって無視されます。 |
| セッション状態を有効にする | ページセッションステータスを読み取り専用として有効または無効にします。 |
| ビューステートを有効にする | ビューステートのクロスページリクエストを許可または禁止するブール値。 |
| エラーページ | 未処理のページ例外が発生した場合のリダイレクト アドレス。 |
| 継承する | コードビハインドまたは他のクラスの名前。 |
| 言語 | コードプログラミング言語。 |
| 送信元 | コードビハインド クラスのファイル名。 |
| トレース | 追跡を有効または無効にします。 |
| トレースモード | 追跡情報がどのように表示され、時間またはカテゴリごとに並べ替えられるかを示します。 |
| 取引 | トランザクションがサポートされているかどうかを示します。 |
| 検証リクエスト | すべての入力データがハードコードされたリストとして有効に検証されるかどうかを示すブール値。 |
前のページ ディレクティブは、ページにカテゴリを割り当て、そのページ タイプを強化します。
前のページのディレクティブのサンプルの基本構文:
<%@ PreviousPageType attribute="value"[attribute="value" ...] %>参照ディレクティブは、別のページまたはユーザー コントロールをコンパイルして現在のページにリンクする必要があることを示します。
参照ディレクティブの基本構文は次のとおりです。
<%@ Reference Page ="somepage.aspx" %>登録ディレクティブは、カスタム サーバー コントロールとユーザー コントロールを登録するために使用されます。
登録ディレクティブの基本構文は次のとおりです。
<%@ Register Src="~/footer.ascx" TagName="footer" TagPrefix="Tfooter" %>