ScriptManager.AddHistoryPoint 方法

定義

命名空間:: System.Web.UI

組件:: System.Web.Extensions.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

建立一個歷史點並將其加入瀏覽器的歷史堆疊。

多載

名稱	Description
AddHistoryPoint(NameValueCollection, String)	建立一個歷史點，並利用指定的狀態資料收集和狀態標題，將其加入瀏覽器的歷史堆疊中。
AddHistoryPoint(String, String)	建立一個歷史點，並利用指定的狀態鍵和狀態值將其加入瀏覽器的歷史堆疊中。
AddHistoryPoint(String, String, String)	建立一個歷史點，並利用指定的狀態鍵、狀態值和狀態標題，將其加入瀏覽器的歷史堆疊中。

備註

這些方法過載讓你可以定義伺服器狀態，並且可以選擇在瀏覽器中設定歷史紀錄的標題。當你建立歷史點時，序列化且加密的資料會附加到網頁的網址後面，並包含一個條目進入瀏覽器的歷史堆疊中。當伺服器後續的導覽事件被觸發時，你可以利用狀態資料重新建立頁面。欲了解更多資訊，請參閱使用伺服器控制管理瀏覽器歷史。

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

將被加入瀏覽器歷史堆疊的文字作為此狀態的標題。

備註

當你想儲存多對狀態資料的鍵值對時，使用此方法建立歷史點。當你建立歷史點時，序列化且加密的資料會附加到網頁的網址後面，並包含一個條目進入瀏覽器的歷史堆疊中。若參數 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

鍵值對中用來識別網頁狀態的值部分。

備註

當你只想儲存一個值來識別狀態時，可以用這個方法建立歷史點。當你建立歷史點時，序列化且加密的資料會附加到網頁的網址後面，並包含一個條目進入瀏覽器的歷史堆疊中。網頁標題作為歷史堆疊中州條目的標題。

當伺服器後續的導覽事件被觸發時，你可以利用狀態資料重新建立頁面。欲了解更多資訊，請參閱使用伺服器控制管理瀏覽器歷史。

適用於

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

將被加入瀏覽器歷史堆疊的文字作為此狀態的標題。

備註

當你想儲存一個數值來識別州名和州名時，可以用這個方法建立歷史點。當你建立歷史點時，序列化且加密的資料會附加到網頁的網址後面，並包含一個條目進入瀏覽器的歷史堆疊中。若參數 title 為 null，則網頁標題作為歷史堆疊中狀態條目的標題。

當伺服器後續的導覽事件被觸發時，你可以利用狀態資料重新建立頁面。欲了解更多資訊，請參閱使用伺服器控制管理瀏覽器歷史。

適用於

意見反應

此頁面對您有幫助嗎？