Web.config ファイルの <pages> セクションを表します。
構文
class PagesSection : ConfigurationSectionWithCollection
メソッド
次の表に、PagesSection クラスによって公開されるメソッドの一覧を示します。
| 名前 | 説明 |
|---|---|
| [追加] | (ConfigurationSectionWithCollection から継承。) |
| Clear | (ConfigurationSectionWithCollection から継承。) |
| Get | (ConfigurationSectionWithCollection から継承。) |
| GetAllowDefinition | (ConfigurationSection から継承。) |
| GetAllowLocation | (ConfigurationSection から継承。) |
| 削除 | (ConfigurationSectionWithCollection から継承。) |
| RevertToParent | (ConfigurationSection から継承。) |
| SetAllowDefinition | (ConfigurationSection から継承。) |
| SetAllowLocation | (ConfigurationSection から継承。) |
プロパティ
次の表は、PagesSection クラスによって公開されるプロパティの一覧です。
| 名前 | 説明 |
|---|---|
AsyncTimeout |
ページが非同期タスクの実行を待機する時間を指定する、読み取り/書き込みの datetime 値。 既定値は 45 秒です。 |
AutoEventWireup |
読み取り/書き込みの boolean 値。 ASP.NET ページのイベントをイベント処理関数に自動的に接続する場合は true。それ以外の場合は false。 既定値は、true です。 注: このプロパティが true の場合、ASP.NET は、イベントが Page_Load や Page_Init などのイベント ハンドラーを指定することを要求しません。 つまり、Web Forms ページのサーバー スクリプトで、Visual Basic の Handles キーワードは必要ありません。 既定では、Visual Studio で ASP.NET Web アプリケーションを作成するとき、.aspx ページまたは .ascx コントロールで AutoEventWireup プロパティの値は false に設定され、イベント ハンドラーは自動的には作成されません。 パフォーマンスが重要な考慮事項である場合は、AutoEventWireup を true に設定しないでください。 |
Buffer |
読み取り/書き込みの boolean 値。 .aspx ページと .ascx コントロールで応答バッファリングを使用する場合は true。それ以外の場合は false。 既定値は、true です。 注: 応答バッファリングを有効にすると、ページまたはコントロールの出力は、ページまたはコントロール全体が処理されるまでバッファーされます。 パフォーマンスが重要な考慮事項である場合は、このプロパティを true に設定しないでください。 |
CompilationMode |
.aspx ページと .ascx コントロールを実行時にコンパイルするかどうかを指定する、読み取り/書き込みの sint32 列挙型。 使用できる値の一覧は、後述の「注釈」セクションに示します。 |
Controls |
カスタム コントロールとユーザー コントロールの構成情報を含む TagPrefixInfo 値。 |
EnableEventValidation |
boolean 値。 イベント検証を実行する必要がある場合は true。それ以外の場合は false。 既定値は、true です。イベント検証メカニズムを使うと、コントロールからの承認されていないポストバック要求およびコールバックのリスクを排除できます。 レンダリング時に、コントロールはそのイベントを登録し、ポストバック要求またはコールバック中にコントロールで発生させることができる特定のイベントのみを検証します。 ASP.NET のすべてのイベント ドリブン コントロールで、この機能が既定で使用されるようになりました。 ただし、必要に応じて Web アプリケーションのイベント検証を無効にすることで、.NET Framework バージョン 1.0 の動作に戻すことができます。 注: 基本コントロールは、このプロパティをチェックして、イベントを検証する必要があるかどうかを判断します。 派生コントロールはこの基本コントロールの設定を継承しないため、既定ではイベント検証の対象から除外されます。 派生コントロール自体に EnableEventValidation プロパティを追加し、それを true に設定することで、派生コントロールに対してイベント検証を実行するよう ASP.NET に指示することもできます。 |
EnableSessionState |
セッション状態を有効にするかどうかを示す、読み取り/書き込みの sint32 値。 使用できる値の一覧は、後述の「注釈」セクションに示します。 |
EnableViewState |
読み取り/書き込みの boolean 値。 ビューステートを有効にする場合は true。それ以外の場合は false. 既定値は true です。 |
EnableViewStateMac |
読み取り/書き込みの boolean 値。 ページがクライアントからポストバックされたときに、ASP.NET がページのビューステートに対してメッセージ認証チェックを実行する必要がある場合は true。それ以外の場合は false。 既定値は、true です。 注: セキュリティ上の理由から、このプロパティは常に true に設定する必要があります。 |
Location |
(ConfigurationSection から継承。)キー プロパティ。 |
MaintainScrollPositionOnPostBack |
読み取り/書き込みの boolean 値。 ポストバック後にブラウザーのページスクロール位置を維持する必要がある場合は true。それ以外の場合は false。 既定値は、false です。 |
MasterPageFile |
アプリケーションのマスター ページへの参照を指定する、読み取り/書き込みの string 値。 文字列には相対パスまたは絶対パスを含めることができます。 |
MaxPageStateFieldLength |
1 つのビューステート フィールドに含めることができる最大文字数を指定する、読み取り/書き込みの sint32 値。 既定値は –1 (制限を指定しない) です。格納されるデータの長さが指定した値を超える場合、そのデータは複数のビューステート フィールドに分割されます。 |
Namespaces |
Web アプリケーションのすべてのページに自動的にインポートされる名前空間参照を含む、NamespaceInfo 値。 これにより、指定した名前空間のクラスをページで使用できるようになります。 |
PageBaseType |
.aspx ページが既定で継承する分離コード クラスを指定する、読み取り/書き込みの string 値。 既定値は "System.Web.UI.Page" です。 |
PageParserFilterType |
パーサー フィルターの種類を指定する、読み取り/書き込みの string 値。 パーサー フィルターは、System.Web.UI.PageParserFilter クラスのインスタンスです。 実行時に、ページのコンパイル プロセスでパーサー フィルターを呼び出し、ページを解析する前にソース コードへの変更をチェックします。 |
Path |
(ConfigurationSection から継承。)キー プロパティ。 |
SectionInformation |
(ConfigurationSection から継承。) |
SmartNavigation |
読み取り/書き込みの boolean 値。 スマート移動が有効な場合は true。それ以外の場合は false。 既定値は、false です。 注: スマート ナビゲーションには、Microsoft Internet Explorer 5.5、6、または 7 が必要です。 |
StyleSheetTheme |
ASP.NET スタイル シート テーマの名前を指定する、読み取り/書き込みの string 値。 |
TagMapping |
構成タグの再マップ ステートメントを含む TagMapInfo 値。 このプロパティを使うと、コンパイル時にタグの種類を再マップできます。 再マップを行うと、構成ファイルのスコープ内にある ASP.NET アプリケーションのすべてのページとコントロールで、元のタグの種類の代わりにマップされたタグが使用されます。 |
Theme |
ASP.NET ページ テーマの名前を指定する、読み取り/書き込みの string 値。 |
UserControlBaseType |
ユーザー コントロールが既定で継承する分離コード クラスを指定する、読み取り/書き込みの string 値。 既定値は "System.Web.UI.UserControl" です。 |
ValidateRequest |
読み取り/書き込みの boolean 値。 ブラウザーからのすべての入力に対して ASP.NET が要求の検証を実行する場合は true。それ以外の場合は false。 既定値は、true です。要求の検証は、入力データを危険性のある値のリストと比較することで実行されます。 一致があった場合、ASP.NET は System.Web.HttpRequestValidationException を発生させます。 |
ViewStateEncryptionMode |
ASP.NET がビューステートの値に使用する暗号化モードを指定する、読み取り/書き込みの sint32 列挙型。 使用できる値の一覧は、後述の「注釈」セクションに示します。 |
サブクラス
このクラスにはサブクラスが含まれていません。
解説
次の表に、CompilationMode プロパティとして使用できる値の一覧を示します。 既定値は 2 (Always) です。
| Value | キーワード | 説明 |
|---|---|---|
| 0 | Auto |
ASP.NET は、可能であればページをコンパイルしません。 |
| 1 | Never |
ページまたはコントロールが動的にコンパイルされることはありません。 この設定は、指定したページをコンパイル プロセスから除外することで、パフォーマンスを向上させます。 コンパイルが必要なスクリプト ブロックやコード コンストラクトがページに含まれている場合、ASP.NET はエラーを返し、そのページは実行されません。 |
| 2 | Always |
ページは常にコンパイルする必要があります。 |
次の表に、EnableSessionState プロパティとして使用できる値の一覧を示します。 既定値は 2 (True) です。
| Value | キーワード | 説明 |
|---|---|---|
| 0 | False |
セッション状態は無効です。 |
| 1 | ReadOnly |
セッション状態は読み取り専用です。 |
| 2 | True |
セッション状態は有効です。 |
次の表に、ViewStateEncryptionMode プロパティとして使用できる値の一覧を示します。 既定値は 0 (Auto) です。
| Value | キーワード | 説明 |
|---|---|---|
| 0 | Auto |
コントロールが System.Web.UI.Page.RegisterRequiresViewStateEncryption メソッドを呼び出して暗号化を要求した場合、ビューステート情報は暗号化されます。 |
| 1 | Always |
ビューステート情報は常に暗号化されます。 |
| 2 | Never |
ビューステート情報は、コントロールが要求した場合でも暗号化されません。 |
継承階層
ConfigurationSectionWithCollection
PagesSection
要件
| 型 | 説明 |
|---|---|
| クライアント | - Windows Vista 上の IIS 7.0 - Windows 7 上の IIS 7.5 - Windows 8 上の IIS 8.0 - Windows 10 上の IIS 10.0 |
| [サーバー] | - Windows Server 2008 上の IIS 7.0 - Windows Server 2008 R2 上の IIS 7.5 - Windows Server 2012 上の IIS 8.0 - Windows Server 2012 R2 上の IIS 8.5 - Windows Server 2016 上の IIS 10.0 |
| Product | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF ファイル | WebAdministration.mof |
参照
Microsoft.Web.Management.Client.Win32.ModulePage.Microsoft.Web.Management.Client.IModulePage.Initialize
System.Web.UI.Page.RegisterRequiresViewStateEncryption
System.Web.Configuration.PagesSectionSystem.Web.HttpRequestValidationException
AspSession クラス
ConfigurationSectionWithCollection クラス
NamespaceInfo クラス
SessionPageStateSection クラス
SessionStateSection クラス
TagMapElement クラス
TagMapInfo クラス
TagPrefixElement クラス
TagPrefixInfo クラス
CompilationMode 列挙型