ScriptManager.RegisterStartupScript Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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
Aplica-se a
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.