ScriptManager.AddHistoryPoint Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Cria um ponto histórico e o adiciona à pilha histórica do navegador.

Sobrecargas

AddHistoryPoint(NameValueCollection, String)	Cria um ponto histórico e o adiciona à pilha de histórico do navegador, usando a coleta de dados de estado e o título do estado especificados.
AddHistoryPoint(String, String)	Cria um ponto histórico e o adiciona à pilha histórica do navegador, usando a chave e o valor de estado especificados.
AddHistoryPoint(String, String, String)	Cria um ponto histórico e o adiciona à pilha de histórico do navegador, usando a chave, o valor e o título de estado especificados.

Comentários

Essas sobrecargas de método permitem definir o estado do servidor e, opcionalmente, o título da entrada de histórico no navegador. Quando você cria um ponto de histórico, os dados serializados e criptografados são acrescentados à URL da página da Web e uma entrada é incluída na pilha de histórico do navegador. Você pode usar os dados de estado para recriar a página quando qualquer evento de navegação do servidor subsequente for acionado. Para obter mais informações, consulte Como gerenciar o histórico do navegador usando controles de servidor.

AddHistoryPoint(NameValueCollection, String)

Cria um ponto histórico e o adiciona à pilha de histórico do navegador, usando a coleta de dados de estado e o título do estado especificados.

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)

Parâmetros

state

NameValueCollection

Uma coleção de pares chave-valor que contêm os dados do estado.

title

String

O texto que será adicionado à pilha de histórico do navegador como o título desse estado.

Comentários

Use esse método para criar um ponto de histórico quando quiser salvar mais de um par chave/valor para os dados de estado. Quando você cria um ponto de histórico, os dados serializados e criptografados são acrescentados à URL da página da Web e uma entrada é incluída na pilha de histórico do navegador. Se o title parâmetro for null, o título da página da Web será usado como o título da entrada de estado na pilha de histórico.

Você pode usar os dados de estado para recriar a página quando qualquer evento de navegação do servidor subsequente for acionado. Para obter mais informações, consulte Como gerenciar o histórico do navegador usando controles de servidor.

AddHistoryPoint(String, String)

Cria um ponto histórico e o adiciona à pilha histórica do navegador, usando a chave e o valor de estado especificados.

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)

Parâmetros

key

String

A parte chave do par chave-valor que identifica o estado da página da Web.

value

String

A parte valor do par chave-valor que identifica o estado da página da Web.

Comentários

Use esse método para criar um ponto de histórico quando desejar apenas salvar um valor para identificar o estado. Quando você cria um ponto de histórico, os dados serializados e criptografados são acrescentados à URL da página da Web e uma entrada é incluída na pilha de histórico do navegador. O título da página da Web é usado como o título da entrada de estado na pilha de histórico.

Você pode usar os dados de estado para recriar a página quando qualquer evento de navegação do servidor subsequente for acionado. Para obter mais informações, consulte Como gerenciar o histórico do navegador usando controles de servidor.

AddHistoryPoint(String, String, String)

Cria um ponto histórico e o adiciona à pilha de histórico do navegador, usando a chave, o valor e o título de estado especificados.

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)

Parâmetros

key

String

A parte chave do par chave-valor que identifica o estado da página da Web.

value

String

A parte valor do par chave-valor que identifica o estado da página da Web.

title

String

O texto que será adicionado à pilha de histórico do navegador como o título desse estado.

Comentários

Use esse método para criar um ponto de histórico quando quiser salvar um valor para identificar o estado e um título para o estado. Quando você cria um ponto de histórico, os dados serializados e criptografados são acrescentados à URL da página da Web e uma entrada é incluída na pilha de histórico do navegador. Se o title parâmetro for null, o título da página da Web será usado como o título da entrada de estado na pilha de histórico.

Você pode usar os dados de estado para recriar a página quando qualquer evento de navegação do servidor subsequente for acionado. Para obter mais informações, consulte Como gerenciar o histórico do navegador usando controles de servidor.