OutputCacheProfileとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

OutputCacheProfile クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

アプリケーションページによって使用できる出力キャッシュプロファイルを構成します。このクラスは継承できません。

名前空間: System.Web.Configuration
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 OutputCacheProfile
    Inherits ConfigurationElement

Visual Basic (使用法)

Dim instance As OutputCacheProfile

public sealed class OutputCacheProfile : ConfigurationElement

C++

public ref class OutputCacheProfile sealed
 : public ConfigurationElement

public final class OutputCacheProfile extends
 ConfigurationElement

JScript

public final class OutputCacheProfile extends
 ConfigurationElement

解説

OutputCacheProfile クラスを使用すると、構成ファイルの caching セクション内の outputCacheProfiles セクションの add 要素にプログラムからアクセスして変更できます。

OutputCacheProfile オブジェクトを使用すると、依存関係、キャッシュ場所、キャッシュの有効期限などの頻繁に使用される構成設定をまとめることができるので、ページごとに指定する必要がなくなります。

OutputCacheProfile は、@ OutputCache ディレクティブの CacheProfile 属性を使用してページに適用できます。

メモ
@ OutputCache ディレクティブは、OutputCacheProfile オブジェクトに格納されている、Enabled 属性以外のすべての設定をオーバーライドできます。これにより、このオブジェクトをオーバーライドしている可能性のあるすべてのページ内のディレクティブを変更することなく、OutputCacheProfile を有効にしたり無効にしたりできます。

メモ

@ OutputCache ディレクティブは、OutputCacheProfile オブジェクトに格納されている、Enabled 属性以外のすべての設定をオーバーライドできます。これにより、このオブジェクトをオーバーライドしている可能性のあるすべてのページ内のディレクティブを変更することなく、OutputCacheProfile を有効にしたり無効にしたりできます。

CacheDependency クラスは、依存関係を監視し、キャッシュアイテムが変更されたときに、そのキャッシュアイテムが自動的に削除されるようにします。

使用例

OutputCacheProfiles コレクションを使用して、その OutputCacheProfile オブジェクトにアクセスする方法を次のコード例に示します。

Visual Basic

  ' Get the Web application configuration.
  Dim webConfig _
  As System.Configuration.Configuration = _
  WebConfigurationManager.OpenWebConfiguration( _
  "/aspnetTest")

  ' Get the section.
  Dim configPath As String
 = _
 "system.web/caching/outputCacheSettings"
  Dim outputCacheSettings _
  As System.Web.Configuration.OutputCacheSettingsSection = _
  CType(webConfig.GetSection(configPath), _
  System.Web.Configuration.OutputCacheSettingsSection)

' Get the profile at zero index.
  Dim outputCacheProfile _
  As System.Web.Configuration.OutputCacheProfile = _
  outputCacheSettings.OutputCacheProfiles(0)

  // Get the Web application configuration.
  System.Configuration.Configuration webConfig =
  WebConfigurationManager.OpenWebConfiguration("/aspnetTest");

 // Get the section.

  string configPath = 
      "system.web/caching/outputCacheSettings";
  System.Web.Configuration.OutputCacheSettingsSection outputCacheSettings =
  (System.Web.Configuration.OutputCacheSettingsSection)webConfig.GetSection(
  configPath);

// Get the profile at zero index.
System.Web.Configuration.OutputCacheProfile outputCacheProfile = 
  outputCacheSettings.OutputCacheProfiles[0];

継承階層

System.Object
System.Configuration.ConfigurationElement
System.Web.Configuration.OutputCacheProfile

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
OutputCacheProfile メンバ
System.Web.Configuration 名前空間
OutputCacheProfileCollection
CacheDependency クラス
その他の技術情報
caching 要素 (ASP.NET 設定スキーマ)
caching の outputCacheSettings の outputCacheProfiles 要素 (ASP.NET 設定スキーマ)
@ OutputCache
アプリケーションデータのキャッシュ
方法 : ASP.NET ページのキャッシュを宣言によって設定する
方法 : ページのキャッシュをプログラムによって設定する

OutputCacheProfile コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

OutputCacheProfile クラスの新しいインスタンスを初期化します。

名前空間: System.Web.Configuration
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    name As String _
)

Visual Basic (使用法)

Dim name As String

Dim instance As New OutputCacheProfile(name)

public OutputCacheProfile (
    string name
)

C++

public:
OutputCacheProfile (
    String^ name
)

public OutputCacheProfile (
    String name
)

JScript

public function OutputCacheProfile (
    name : String
)

パラメータ

name: 使用する名前値。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
OutputCacheProfile クラス
OutputCacheProfile メンバ
System.Web.Configuration 名前空間

OutputCacheProfile プロパティ

パブリックプロパティパブリックプロパティ

( プロテクトプロパティも参照)

	名前	説明
	Duration	ページまたはコントロールがキャッシュされる時間を取得または設定します。
	ElementInformation	ConfigurationElement オブジェクトのカスタマイズできない情報と機能を格納する ElementInformation オブジェクトを取得します。 ( ConfigurationElement から継承されます。)
	Enabled	キャッシングが有効かどうかを示す値を取得または設定します。
	Location	出力キャッシュ場所を取得または設定します。
	LockAllAttributesExcept	ロックされている属性のコレクションを取得します。 ( ConfigurationElement から継承されます。)
	LockAllElementsExcept	ロックされている要素のコレクションを取得します。 ( ConfigurationElement から継承されます。)
	LockAttributes	ロックされている属性のコレクションを取得します。 ( ConfigurationElement から継承されます。)
	LockElements	ロックされている要素のコレクションを取得します。 ( ConfigurationElement から継承されます。)
	LockItem	要素がロックされているかどうかを示す値を取得または設定します。 ( ConfigurationElement から継承されます。)
	Name	OutputCacheProfile 名を取得または設定します。
	NoStore	二次保存が有効かどうかを示す値を取得または設定します。
	SqlDependency	SqlDependency プロパティを取得または設定します。
	VaryByControl	VaryByControl プロパティを取得または設定します。
	VaryByCustom	VaryByCustom プロパティを取得または設定します。
	VaryByHeader	VaryByHeader プロパティを取得または設定します。
	VaryByParam	VaryByParam プロパティを取得または設定します。

プロテクトプロパティ

	名前	説明
	ElementProperty	ConfigurationElement オブジェクト自体を表す ConfigurationElementProperty オブジェクトを取得します。 ( ConfigurationElement から継承されます。)
	EvaluationContext	ConfigurationElement オブジェクトの ContextInformation オブジェクトを取得します。 ( ConfigurationElement から継承されます。)
	Item	オーバーロードされます。この ConfigurationElement オブジェクトのプロパティ、属性、または子要素を取得または設定します。 ( ConfigurationElement から継承されます。)
	Properties	プロパティのコレクションを取得します。 ( ConfigurationElement から継承されます。)

参照

その他の技術情報

caching 要素 (ASP.NET 設定スキーマ)
caching の outputCacheSettings の outputCacheProfiles 要素 (ASP.NET 設定スキーマ)
@ OutputCache
アプリケーションデータのキャッシュ
方法 : ASP.NET ページのキャッシュを宣言によって設定する
方法 : ページのキャッシュをプログラムによって設定する

OutputCacheProfile メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。現在の ConfigurationElement インスタンスを、指定したオブジェクトと比較します。 ( ConfigurationElement から継承されます。)
	GetHashCode	現在の ConfigurationElement インスタンスを表す一意の値を取得します。 ( ConfigurationElement から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsReadOnly	ConfigurationElement オブジェクトが読み取り専用かどうかを示す値を取得します。 ( ConfigurationElement から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	DeserializeElement	構成ファイルから XML を読み取ります。 ( ConfigurationElement から継承されます。)
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	Init	ConfigurationElement オブジェクトを初期状態に設定します。 ( ConfigurationElement から継承されます。)
	InitializeDefault	ConfigurationElement オブジェクトの既定の値セットを初期化するために使用します。 ( ConfigurationElement から継承されます。)
	IsModified	派生クラスに実装された場合、この構成要素が最後の保存または読み込み以降に変更されたかどうかを示します。 ( ConfigurationElement から継承されます。)
	ListErrors	この ConfigurationElement オブジェクトおよびすべてのサブ要素の無効なプロパティのエラーを、渡されたリストに追加します。 ( ConfigurationElement から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnDeserializeUnrecognizedAttribute	逆シリカル化中に不明な属性が発生したかどうかを示す値を取得します。 ( ConfigurationElement から継承されます。)
	OnDeserializeUnrecognizedElement	逆シリカル化中に不明な要素が発生したかどうかを示す値を取得します。 ( ConfigurationElement から継承されます。)
	OnRequiredPropertyNotFound	必須プロパティが見つからなかったかどうかを示す値を取得します。 ( ConfigurationElement から継承されます。)
	PostDeserialize	逆シリアル化後に呼び出されます。 ( ConfigurationElement から継承されます。)
	PreSerialize	シリアル化前に呼び出されます。 ( ConfigurationElement から継承されます。)
	Reset	ConfigurationElement オブジェクトの内部状態 (ロックやプロパティコレクションなど) をリセットします。 ( ConfigurationElement から継承されます。)
	ResetModified	派生クラスに実装された場合、IsModified メソッドの値を false にリセットします。 ( ConfigurationElement から継承されます。)
	SerializeElement	派生クラスに実装されている場合、この構成要素の内容を構成ファイルに書き込みます。 ( ConfigurationElement から継承されます。)
	SerializeToXmlElement	派生クラスに実装されている場合、この構成要素の外側のタグを構成ファイルに書き込みます。 ( ConfigurationElement から継承されます。)
	SetPropertyValue	プロパティを指定した値に設定します。 ( ConfigurationElement から継承されます。)
	SetReadOnly	ConfigurationElement オブジェクトおよびすべてのサブ要素に IsReadOnly プロパティを設定します。 ( ConfigurationElement から継承されます。)
	Unmerge	保存しないすべての値を削除するには、ConfigurationElement オブジェクトを変更します。 ( ConfigurationElement から継承されます。)

参照

その他の技術情報

OutputCacheProfile メンバ

アプリケーションページによって使用できる出力キャッシュプロファイルを構成します。このクラスは継承できません。

OutputCacheProfile データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	OutputCacheProfile	OutputCacheProfile クラスの新しいインスタンスを初期化します。

パブリックプロパティ

( プロテクトプロパティも参照)

	名前	説明
	Duration	ページまたはコントロールがキャッシュされる時間を取得または設定します。
	ElementInformation	ConfigurationElement オブジェクトのカスタマイズできない情報と機能を格納する ElementInformation オブジェクトを取得します。 (ConfigurationElement から継承されます。)
	Enabled	キャッシングが有効かどうかを示す値を取得または設定します。
	Location	出力キャッシュ場所を取得または設定します。
	LockAllAttributesExcept	ロックされている属性のコレクションを取得します。(ConfigurationElement から継承されます。)
	LockAllElementsExcept	ロックされている要素のコレクションを取得します。(ConfigurationElement から継承されます。)
	LockAttributes	ロックされている属性のコレクションを取得します。 (ConfigurationElement から継承されます。)
	LockElements	ロックされている要素のコレクションを取得します。(ConfigurationElement から継承されます。)
	LockItem	要素がロックされているかどうかを示す値を取得または設定します。(ConfigurationElement から継承されます。)
	Name	OutputCacheProfile 名を取得または設定します。
	NoStore	二次保存が有効かどうかを示す値を取得または設定します。
	SqlDependency	SqlDependency プロパティを取得または設定します。
	VaryByControl	VaryByControl プロパティを取得または設定します。
	VaryByCustom	VaryByCustom プロパティを取得または設定します。
	VaryByHeader	VaryByHeader プロパティを取得または設定します。
	VaryByParam	VaryByParam プロパティを取得または設定します。

プロテクトプロパティ

	名前	説明
	ElementProperty	ConfigurationElement オブジェクト自体を表す ConfigurationElementProperty オブジェクトを取得します。(ConfigurationElement から継承されます。)
	EvaluationContext	ConfigurationElement オブジェクトの ContextInformation オブジェクトを取得します。(ConfigurationElement から継承されます。)
	Item	オーバーロードされます。この ConfigurationElement オブジェクトのプロパティ、属性、または子要素を取得または設定します。(ConfigurationElement から継承されます。)
	Properties	プロパティのコレクションを取得します。(ConfigurationElement から継承されます。)

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。現在の ConfigurationElement インスタンスを、指定したオブジェクトと比較します。 (ConfigurationElement から継承されます。)
	GetHashCode	現在の ConfigurationElement インスタンスを表す一意の値を取得します。 (ConfigurationElement から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsReadOnly	ConfigurationElement オブジェクトが読み取り専用かどうかを示す値を取得します。 (ConfigurationElement から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	DeserializeElement	構成ファイルから XML を読み取ります。 (ConfigurationElement から継承されます。)
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	Init	ConfigurationElement オブジェクトを初期状態に設定します。 (ConfigurationElement から継承されます。)
	InitializeDefault	ConfigurationElement オブジェクトの既定の値セットを初期化するために使用します。 (ConfigurationElement から継承されます。)
	IsModified	派生クラスに実装された場合、この構成要素が最後の保存または読み込み以降に変更されたかどうかを示します。 (ConfigurationElement から継承されます。)
	ListErrors	この ConfigurationElement オブジェクトおよびすべてのサブ要素の無効なプロパティのエラーを、渡されたリストに追加します。 (ConfigurationElement から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnDeserializeUnrecognizedAttribute	逆シリカル化中に不明な属性が発生したかどうかを示す値を取得します。 (ConfigurationElement から継承されます。)
	OnDeserializeUnrecognizedElement	逆シリカル化中に不明な要素が発生したかどうかを示す値を取得します。 (ConfigurationElement から継承されます。)
	OnRequiredPropertyNotFound	必須プロパティが見つからなかったかどうかを示す値を取得します。 (ConfigurationElement から継承されます。)
	PostDeserialize	逆シリアル化後に呼び出されます。 (ConfigurationElement から継承されます。)
	PreSerialize	シリアル化前に呼び出されます。 (ConfigurationElement から継承されます。)
	Reset	ConfigurationElement オブジェクトの内部状態 (ロックやプロパティコレクションなど) をリセットします。 (ConfigurationElement から継承されます。)
	ResetModified	派生クラスに実装された場合、IsModified メソッドの値を false にリセットします。 (ConfigurationElement から継承されます。)
	SerializeElement	派生クラスに実装されている場合、この構成要素の内容を構成ファイルに書き込みます。 (ConfigurationElement から継承されます。)
	SerializeToXmlElement	派生クラスに実装されている場合、この構成要素の外側のタグを構成ファイルに書き込みます。 (ConfigurationElement から継承されます。)
	SetPropertyValue	プロパティを指定した値に設定します。 (ConfigurationElement から継承されます。)
	SetReadOnly	ConfigurationElement オブジェクトおよびすべてのサブ要素に IsReadOnly プロパティを設定します。 (ConfigurationElement から継承されます。)
	Unmerge	保存しないすべての値を削除するには、ConfigurationElement オブジェクトを変更します。 (ConfigurationElement から継承されます。)