ScriptManager.AddHistoryPoint 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.Extensions.dll

创建一个历史时间点，并将其添加到浏览器的历史记录堆栈中。

重载

AddHistoryPoint(NameValueCollection, String)	使用指定的状态数据集合和状态标题创建历史时间点，然后将它添加到浏览器的历史记录堆栈中。
AddHistoryPoint(String, String)	使用指定的状态键和状态值创建历史时间点，然后将它添加到浏览器的历史记录堆栈中。
AddHistoryPoint(String, String, String)	使用指定的状态键、状态值和状态标题创建历史时间点，然后将它添加到浏览器的历史记录堆栈中。

注解

这些方法重载使你能够定义服务器状态，以及浏览器中历史记录项的标题（可选）。 创建历史记录点时，序列化和加密的数据将追加到网页的 URL，并在浏览器的历史记录堆栈中包含一个条目。 在引发任何后续服务器导航事件时，可以使用状态数据重新创建页面。 有关详细信息，请参阅 使用服务器控件管理浏览器历史记录。

AddHistoryPoint(NameValueCollection, String)

使用指定的状态数据集合和状态标题创建历史时间点，然后将它添加到浏览器的历史记录堆栈中。

public:
 void AddHistoryPoint(System::Collections::Specialized::NameValueCollection ^ state, System::String ^ title);

public void AddHistoryPoint (System.Collections.Specialized.NameValueCollection state, string title);

member this.AddHistoryPoint : System.Collections.Specialized.NameValueCollection * string -> unit

Public Sub AddHistoryPoint (state As NameValueCollection, title As String)

参数

state

NameValueCollection

包含状态数据的键/值对的集合。

title

String

将作为此状态的标题添加到浏览器的历史记录堆栈中的文本。

注解

如果要为状态数据保存多个键/值对，请使用此方法创建历史记录点。 创建历史记录点时，序列化和加密的数据将追加到网页的 URL，并在浏览器的历史记录堆栈中包含一个条目。 title如果 参数为 null，则网页的标题将用作历史记录堆栈中状态项的标题。

在引发任何后续服务器导航事件时，可以使用状态数据重新创建页面。 有关详细信息，请参阅 使用服务器控件管理浏览器历史记录。

AddHistoryPoint(String, String)

使用指定的状态键和状态值创建历史时间点，然后将它添加到浏览器的历史记录堆栈中。

public:
 void AddHistoryPoint(System::String ^ key, System::String ^ value);

public void AddHistoryPoint (string key, string value);

member this.AddHistoryPoint : string * string -> unit

Public Sub AddHistoryPoint (key As String, value As String)

参数

key

String

标识网页状态的键/值对的键部分。

value

String

标识网页状态的键/值对的值部分。

注解

如果只想保存值来标识状态，请使用此方法创建历史记录点。 创建历史记录点时，序列化和加密的数据将追加到网页的 URL，并在浏览器的历史记录堆栈中包含一个条目。 网页的标题用作历史记录堆栈中状态条目的标题。

在引发任何后续服务器导航事件时，可以使用状态数据重新创建页面。 有关详细信息，请参阅 使用服务器控件管理浏览器历史记录。

AddHistoryPoint(String, String, String)

使用指定的状态键、状态值和状态标题创建历史时间点，然后将它添加到浏览器的历史记录堆栈中。

public:
 void AddHistoryPoint(System::String ^ key, System::String ^ value, System::String ^ title);

public void AddHistoryPoint (string key, string value, string title);

member this.AddHistoryPoint : string * string * string -> unit

Public Sub AddHistoryPoint (key As String, value As String, title As String)

参数

key

String

标识网页状态的键/值对的键部分。

value

String

标识网页状态的键/值对的值部分。

title

String

将作为此状态的标题添加到浏览器的历史记录堆栈中的文本。

注解

如果要保存一个值来标识状态和状态的标题，请使用此方法创建历史记录点。 创建历史记录点时，序列化和加密的数据将追加到网页的 URL，并在浏览器的历史记录堆栈中包含一个条目。 title如果 参数为 null，则网页的标题将用作历史记录堆栈中状态项的标题。

在引发任何后续服务器导航事件时，可以使用状态数据重新创建页面。 有关详细信息，请参阅 使用服务器控件管理浏览器历史记录。