PartialCachingAttribute コンストラクター

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.dll

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

オーバーロード

PartialCachingAttribute(Int32)	キャッシュされるユーザー コントロールに割り当てる存続期間を指定して、PartialCachingAttribute クラスの新しいインスタンスを初期化します。
PartialCachingAttribute(Int32, String, String, String)	キャッシュの存続期間、GET 値と POST 値、コントロール名、およびキャッシュを変更するために使用するカスタム出力キャッシュ要件を指定して、PartialCachingAttribute クラスの新しいインスタンスを初期化します。
PartialCachingAttribute(Int32, String, String, String, Boolean)	キャッシュの存続期間、GET および POST の値、コントロール名、キャッシュを変更するために使用するカスタム出力キャッシュ要件、およびユーザー コントロール出力を複数のページで共有できるようにするかどうかを指定して、PartialCachingAttribute クラスの新しいインスタンスを初期化します。
PartialCachingAttribute(Int32, String, String, String, String, Boolean)	キャッシュの存続期間、GET および POST の値、コントロール名、キャッシュを変更するために使用するカスタム出力キャッシュ要件、データベースの依存関係、およびユーザー コントロール出力を複数のページで共有できるようにするかどうかを指定して、PartialCachingAttribute クラスの新しいインスタンスを初期化します。

PartialCachingAttribute(Int32)

キャッシュされるユーザー コントロールに割り当てる存続期間を指定して、PartialCachingAttribute クラスの新しいインスタンスを初期化します。

public:
 PartialCachingAttribute(int duration);

public PartialCachingAttribute (int duration);

new System.Web.UI.PartialCachingAttribute : int -> System.Web.UI.PartialCachingAttribute

Public Sub New (duration As Integer)

パラメーター

duration

Int32

ユーザー コントロールを出力キャッシュに残しておく時間 (秒数)。

例

次のコード例は、コンストラクターを PartialCachingAttribute(Int32) ユーザー コントロールに適用する方法を示しています。 この例では、コンストラクターを使用して、ユーザー コントロールをキャッシュできることを示し、キャッシュ期間を指定します。 このコード例は、PartialCachingAttribute クラスのために提供されている大規模な例の一部です。

// Set the PartialCachingAttribute.Duration property to 20 seconds.
[PartialCaching(20)]
public partial class ctlMine : UserControl

' Set the PartialCachingAttribute.Duration property to 20 seconds.
<PartialCaching(20)> _
Partial Class ctlMine
    Inherits UserControl

PartialCachingAttribute(Int32, String, String, String)

キャッシュの存続期間、GET 値と POST 値、コントロール名、およびキャッシュを変更するために使用するカスタム出力キャッシュ要件を指定して、PartialCachingAttribute クラスの新しいインスタンスを初期化します。

public:
 PartialCachingAttribute(int duration, System::String ^ varyByParams, System::String ^ varyByControls, System::String ^ varyByCustom);

public PartialCachingAttribute (int duration, string varyByParams, string varyByControls, string varyByCustom);

new System.Web.UI.PartialCachingAttribute : int * string * string * string -> System.Web.UI.PartialCachingAttribute

Public Sub New (duration As Integer, varyByParams As String, varyByControls As String, varyByCustom As String)

パラメーター

duration

Int32

ユーザー コントロールがキャッシュされる時間 (秒数)。

varyByParams

String

出力キャッシュを切り替えるために使われる各文字列をセミコロンで区切ったリスト。 既定では、これらの文字列は、GET メソッド属性を設定して送信されたクエリ文字列値、または POST メソッドを使用して送信されたパラメーターと対応しています。 この属性を複数のパラメーターに設定すると、出力キャッシュにはそれぞれの指定したパラメーターに対して要求されたドキュメントの異なったバージョンが含まれます。 指定できる値は、"none"、"*"、有効なクエリ文字列、または POST パラメーター名です。

varyByControls

String

出力キャッシュを切り替えるために使われる各文字列をセミコロンで区切ったリスト。 これらの文字列は、ユーザー コントロールのプロパティの完全修飾名を表します。 ユーザー コントロールでこのパラメーターを使用すると、指定された各ユーザー コントロール プロパティのキャッシュに合わせてユーザー コントロール出力が変化します。

varyByCustom

String

カスタム出力キャッシュ要件を表す任意のテキスト。 このパラメーターに "browser" の値が指定された場合は、キャッシュがブラウザー名およびメジャー バージョン情報に応じて変化します。 カスタム文字列が入力された場合、アプリケーションの Global.asax ファイルの GetVaryByCustomString(HttpContext, String) メソッドをオーバーライドする必要があります。

例

次のコード例は、コンストラクターを PartialCachingAttribute(Int32, String, String, String) ユーザー コントロールに適用する方法を示しています。 この例では、コンストラクターを使用して、ユーザー コントロールをキャッシュできることを示し、キャッシュ期間を 20 秒として指定し、ユーザー コントロールの出力を変更する名前の付いた state コントロールを指定します。

// Set the PartialCachingAttribute.Duration property to
// 20 seconds and the PartialCachingAttribute.VaryByControls
// property to the ID of the server control to vary the output by.
// In this case, it is state, the ID assigned to a DropDownList
// server control.
[PartialCaching(20, null, "state", null)]

' Set the PartialCachingAttribute.Duration property to
' 20 seconds and the PartialCachingAttribute.VaryByControls
' property to the ID of the server control to vary the output by.
' In this case, it is state, the ID assigned to a DropDownList
' server control.
<PartialCaching(20, Nothing, "state", Nothing)> _
Public Class ctlSelect
    Inherits UserControl

PartialCachingAttribute(Int32, String, String, String, Boolean)

キャッシュの存続期間、GET および POST の値、コントロール名、キャッシュを変更するために使用するカスタム出力キャッシュ要件、およびユーザー コントロール出力を複数のページで共有できるようにするかどうかを指定して、PartialCachingAttribute クラスの新しいインスタンスを初期化します。

public:
 PartialCachingAttribute(int duration, System::String ^ varyByParams, System::String ^ varyByControls, System::String ^ varyByCustom, bool shared);

public PartialCachingAttribute (int duration, string varyByParams, string varyByControls, string varyByCustom, bool shared);

new System.Web.UI.PartialCachingAttribute : int * string * string * string * bool -> System.Web.UI.PartialCachingAttribute

Public Sub New (duration As Integer, varyByParams As String, varyByControls As String, varyByCustom As String, shared As Boolean)

パラメーター

duration

Int32

ユーザー コントロールがキャッシュされる時間 (秒数)。

varyByParams

String

出力キャッシュを切り替えるために使われる各文字列をセミコロンで区切ったリスト。 既定では、これらの文字列は、GET メソッド属性を設定して送信されたクエリ文字列値、または POST メソッドを使用して送られたパラメーターに対応しています。 この属性を複数のパラメーターに設定すると、出力キャッシュにはそれぞれの指定したパラメーターに対して要求されたドキュメントの異なったバージョンが含まれます。 指定できる値は、"none"、"*"、有効なクエリ文字列、または POST パラメーター名です。

varyByControls

String

出力キャッシュを切り替えるために使われる各文字列をセミコロンで区切ったリスト。 これらの文字列は、ユーザー コントロールのプロパティの完全修飾名を表します。 ユーザー コントロールでこのパラメーターを使用すると、指定された各ユーザー コントロール プロパティのキャッシュに合わせてユーザー コントロール出力が変化します。

varyByCustom

String

カスタム出力キャッシュ要件を表す任意のテキスト。 このパラメーターに "browser" の値が指定された場合は、キャッシュがブラウザー名およびメジャー バージョン情報に応じて変化します。 カスタム文字列が入力された場合、アプリケーションの Global.asax ファイルの GetVaryByCustomString(HttpContext, String) メソッドをオーバーライドする必要があります。

shared

Boolean

複数のページでユーザー コントロールの出力を共有できることを示す場合は true。それ以外の場合は false。

PartialCachingAttribute(Int32, String, String, String, String, Boolean)

キャッシュの存続期間、GET および POST の値、コントロール名、キャッシュを変更するために使用するカスタム出力キャッシュ要件、データベースの依存関係、およびユーザー コントロール出力を複数のページで共有できるようにするかどうかを指定して、PartialCachingAttribute クラスの新しいインスタンスを初期化します。

public:
 PartialCachingAttribute(int duration, System::String ^ varyByParams, System::String ^ varyByControls, System::String ^ varyByCustom, System::String ^ sqlDependency, bool shared);

public PartialCachingAttribute (int duration, string varyByParams, string varyByControls, string varyByCustom, string sqlDependency, bool shared);

new System.Web.UI.PartialCachingAttribute : int * string * string * string * string * bool -> System.Web.UI.PartialCachingAttribute

Public Sub New (duration As Integer, varyByParams As String, varyByControls As String, varyByCustom As String, sqlDependency As String, shared As Boolean)

パラメーター

duration

Int32

ユーザー コントロールがキャッシュされる時間 (秒数)。

varyByParams

String

出力キャッシュを切り替えるために使われる各文字列をセミコロンで区切ったリスト。 既定では、これらの文字列は、GET メソッド属性を設定して送信されたクエリ文字列値、または POST メソッドを使用して送られたパラメーターに対応しています。 この属性を複数のパラメーターに設定すると、出力キャッシュにはそれぞれの指定したパラメーターに対して要求されたドキュメントの異なったバージョンが含まれます。 指定できる値は、"none"、"*"、有効なクエリ文字列、または POST パラメーター名です。

varyByControls

String

出力キャッシュを切り替えるために使われる各文字列をセミコロンで区切ったリスト。 これらの文字列は、ユーザー コントロールのプロパティの完全修飾名を表します。 ユーザー コントロールでこのパラメーターを使用すると、指定された各ユーザー コントロール プロパティのキャッシュに合わせてユーザー コントロール出力が変化します。

varyByCustom

String

カスタム出力キャッシュ要件を表す任意のテキスト。 このパラメーターに "browser" の値が指定された場合は、キャッシュがブラウザー名およびメジャー バージョン情報に応じて変化します。 カスタム文字列が入力された場合、アプリケーションの Global.asax ファイルの GetVaryByCustomString(HttpContext, String) メソッドをオーバーライドする必要があります。

sqlDependency

String

変更されたときに ASP.NET キャッシュ内のキャッシュ エントリを明示的に期限切れにするデータベース名とテーブル名の、区切り記号で区切られたリスト。 これらのデータベース名は、Web 構成セクションで指定されている SQL Server キャッシュの依存関係と一致します。

shared

Boolean

複数のページでユーザー コントロールの出力を共有できることを示す場合は true。それ以外の場合は false。