Compartilhar via


ScriptManager.AddHistoryPoint Método

Definição

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 de servidor subsequente for gerado. Para obter mais informações, consulte Gerenciando 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 de servidor subsequente for gerado. Para obter mais informações, consulte Gerenciando o histórico do navegador usando controles de servidor.

Aplica-se a

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 você quiser 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 de servidor subsequente for gerado. Para obter mais informações, consulte Gerenciando o histórico do navegador usando controles de servidor.

Aplica-se a

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 de servidor subsequente for gerado. Para obter mais informações, consulte Gerenciando o histórico do navegador usando controles de servidor.

Aplica-se a