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 ，則會使用網頁的標題做為歷程記錄堆疊中狀態專案的標題。

當引發任何後續的伺服器導覽事件時，您可以使用狀態資料重新建立頁面。 如需詳細資訊，請參閱 使用伺服器控制項管理瀏覽器歷程記錄。