ScriptManager.RegisterStartupScript Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Regista um bloco de script de arranque com o ScriptManager controlo e adiciona o bloco de script à página.
Sobrecargas
| Name | Description |
|---|---|
| RegisterStartupScript(Control, Type, String, String, Boolean) |
Regista um bloco de script de arranque para um controlo que está dentro de um UpdatePanel usando o ScriptManager controlo, e adiciona o bloco de script à página. |
| RegisterStartupScript(Page, Type, String, String, Boolean) |
Regista um bloco de script de arranque para cada postback assíncrono com o ScriptManager controlo e adiciona o bloco de script à página. |
RegisterStartupScript(Control, Type, String, String, Boolean)
Regista um bloco de script de arranque para um controlo que está dentro de um UpdatePanel usando o ScriptManager controlo, 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 controlo que regista o bloco de script cliente.
- type
- Type
O tipo do bloco de script do cliente. Este parâmetro é normalmente especificado usando o operador typeof (C#) ou o operador GetType (Visual Basic) para recuperar o tipo do controlo que está a registar o script.
- key
- String
Um identificador único para o bloco de script.
- script
- String
O guião para registar.
- addScriptTags
- Boolean
true para encerrar o bloco de script com <script> e </script> etiquetas; caso contrário, false.
Exceções
control não está na árvore de controlo da página.
Observações
Utiliza-se o método RegisterStartupScript para registar um bloco de script de arranque para uma página compatível com renderização parcial e que não tenha dependências Microsoft da Ajax Library. Os blocos de script de arranque registados através deste método só são enviados para a página quando o controlo que regista o bloco está dentro de um UpdatePanel controlo que está a ser atualizado. Para registar um bloco de script de arranque sempre que ocorre um postback assíncrono, use a RegisterStartupScript(Page, Type, String, String, Boolean) sobrecarga deste método.
Se quiser registar um script de arranque que não esteja relacionado com atualizações parciais da página, e se quiser registar o script apenas uma vez durante a renderização inicial da página, use o RegisterStartupScript método da ClientScriptManager classe. Podes obter uma referência ao ClientScriptManager objeto a partir da ClientScript propriedade da página.
O bloco de script que é renderizado pelo RegisterStartupScript método executa-se quando a página termina de carregar, mas antes de o evento cliente onload da página ser gerado. Os blocos de script de arranque estão localizados na parte inferior da página de ASP.NET renderizada, mesmo antes da etiqueta </form>.
Os blocos de script de arranque registados por usar RegisterStartupScript não têm garantia de serem produzidos na mesma ordem em que são registados. Se a ordem dos blocos de script de arranque for importante, use um StringBuilder objeto para reunir os blocos de script numa única cadeia e depois regista-os todos como um único script de arranque.
Ver também
Aplica-se a
RegisterStartupScript(Page, Type, String, String, Boolean)
Regista um bloco de script de arranque para cada postback assíncrono com o ScriptManager controlo 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 de página que está a registar o bloco de script do cliente.
- type
- Type
O tipo do bloco de script do cliente. Este parâmetro é normalmente especificado usando o operador typeof (C#) ou o operador GetType (Visual Basic) para recuperar o tipo do controlo que está a registar o script.
- key
- String
Um identificador único para o bloco de script.
- script
- String
O guião para registar.
- addScriptTags
- Boolean
true para encerrar o bloco de script com <script> e </script> etiquetas; caso contrário, false.
Observações
Utiliza-se este método para registar um bloco de script de arranque que é incluído sempre que ocorre um postback assíncrono. Para registar um bloco de script para um controlo que está dentro de um UpdatePanel controlo, de modo a que o bloco de script só seja registado quando o UpdatePanel controlo for atualizado, use a RegisterStartupScript(Control, Type, String, String, Boolean) sobrecarga deste método.
Se quiser registar um script de arranque que não esteja relacionado com atualizações parciais da página, e se quiser registar o script apenas uma vez durante a renderização inicial da página, use o RegisterStartupScript método da ClientScriptManager classe. Podes obter uma referência ao ClientScriptManager objeto a partir da ClientScript propriedade da página.