ScriptManager.RegisterStartupScript Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Registra um bloco de script de inicialização com o controle ScriptManager e adiciona o bloco de script à página.

Sobrecargas

RegisterStartupScript(Control, Type, String, String, Boolean)	Registra um bloco de script de inicialização para um controle que está dentro de um UpdatePanel usando o controle ScriptManager e adiciona o bloco de script à página.
RegisterStartupScript(Page, Type, String, String, Boolean)	Registra um bloco de script de inicialização para cada postback assíncrono com o controle ScriptManager e adiciona o bloco de script à página.

RegisterStartupScript(Control, Type, String, String, Boolean)

Registra um bloco de script de inicialização para um controle que está dentro de um UpdatePanel usando o controle ScriptManager e adiciona o bloco de script à página.

public:
 static void RegisterStartupScript(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);

public static void RegisterStartupScript (System.Web.UI.Control control, Type type, string key, string script, bool addScriptTags);

static member RegisterStartupScript : System.Web.UI.Control * Type * string * string * bool -> unit

Public Shared Sub RegisterStartupScript (control As Control, type As Type, key As String, script As String, addScriptTags As Boolean)

Parâmetros

control

Control

O controle que está registrando o bloco de script de cliente.

type

Type

O tipo de bloco de script de cliente. Geralmente, este parâmetro é especificado com o operador typeof (C#) ou GetType (Visual Basic) para recuperar o tipo do controle que está registrando o script.

key

String

Um identificador exclusivo para o bloco de script.

script

String

O script a ser registrado.

addScriptTags

Boolean

true para circunscrever o bloco de script nas marcas <script> e </script>; caso contrário, false.

Exceções

ArgumentNullException

control é null.

- ou - type é null.

ArgumentException

control não está na árvore de controle da página.

Comentários

Você usa o RegisterStartupScript método para registrar um bloco de script de inicialização para uma página compatível com renderização de página parcial e que não tem dependências da Biblioteca do Microsoft Ajax. Os blocos de script de inicialização registrados usando esse método são enviados para a página somente quando o controle que está registrando o bloco estiver dentro de um UpdatePanel controle que está sendo atualizado. Para registrar um bloco de script de inicialização sempre que ocorrer um postback assíncrono, use a RegisterStartupScript(Page, Type, String, String, Boolean) sobrecarga desse método.

Se você quiser registrar um script de inicialização que não se refere a atualizações de página parcial e se quiser registrar o script apenas uma vez durante a renderização inicial da página, use o RegisterStartupScript método da ClientScriptManager classe. Você pode obter uma referência ao ClientScriptManager objeto da ClientScript propriedade da página.

O bloco de script que é renderizado pelo RegisterStartupScript método é executado quando a página termina de carregar, mas antes que o evento cliente onload da página seja acionado. Os blocos de script de inicialização estão localizados na parte inferior da página ASP.NET renderizada pouco antes da </form> marca.

Os blocos de script de inicialização registrados usando RegisterStartupScript não têm a garantia de serem saídas na mesma ordem em que estão registrados. Se a ordem dos blocos de script de inicialização for importante, use um StringBuilder objeto para coletar os blocos de script em uma única cadeia de caracteres e registre-os todos como um único script de inicialização.

Confira também

• RegisterStartupScript(Page, Type, String, String, Boolean)

RegisterStartupScript(Page, Type, String, String, Boolean)

Registra um bloco de script de inicialização para cada postback assíncrono com o controle ScriptManager e adiciona o bloco de script à página.

public:
 static void RegisterStartupScript(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);

public static void RegisterStartupScript (System.Web.UI.Page page, Type type, string key, string script, bool addScriptTags);

static member RegisterStartupScript : System.Web.UI.Page * Type * string * string * bool -> unit

Public Shared Sub RegisterStartupScript (page As Page, type As Type, key As String, script As String, addScriptTags As Boolean)

Parâmetros

page

Page

O objeto da página que está registrando o bloco de script de cliente.

type

Type

O tipo de bloco de script de cliente. Geralmente, este parâmetro é especificado com o operador typeof (C#) ou GetType (Visual Basic) para recuperar o tipo do controle que está registrando o script.

key

String

Um identificador exclusivo para o bloco de script.

script

String

O script a ser registrado.

addScriptTags

Boolean

true para circunscrever o bloco de script nas marcas <script> e </script>; caso contrário, false.

Comentários

Você usa esse método para registrar um bloco de script de inicialização que é incluído sempre que ocorre um postback assíncrono. Para registrar um bloco de script para um controle que está dentro de um UpdatePanel controle para que o bloco de script seja registrado somente quando o UpdatePanel controle for atualizado, use a RegisterStartupScript(Control, Type, String, String, Boolean) sobrecarga desse método.

Se você quiser registrar um script de inicialização que não se refere a atualizações de página parcial e se quiser registrar o script apenas uma vez durante a renderização inicial da página, use o RegisterStartupScript método da ClientScriptManager classe. Você pode obter uma referência ao ClientScriptManager objeto da ClientScript propriedade da página.

Confira também

• RegisterStartupScript(Control, Type, String, String, Boolean)