ScriptManager.RegisterClientScriptResource 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 o script cliente que está embutido numa assembly com o ScriptManager controlo para ser usado com um controlo que participa na renderização de páginas parciais.
Sobrecargas
| Name | Description |
|---|---|
| RegisterClientScriptResource(Page, Type, String) |
Regista um ficheiro de script cliente que está embutido num assembly com o ScriptManager controlo sempre que ocorre um postback. |
| RegisterClientScriptResource(Control, Type, String) |
Regista o script cliente que está embutido numa assembleia com o ScriptManager controlo para ser usado com um controlo que participa na renderização parcial da página. |
RegisterClientScriptResource(Page, Type, String)
Regista um ficheiro de script cliente que está embutido num assembly com o ScriptManager controlo sempre que ocorre um postback.
public:
static void RegisterClientScriptResource(System::Web::UI::Page ^ page, Type ^ type, System::String ^ resourceName);
public static void RegisterClientScriptResource(System.Web.UI.Page page, Type type, string resourceName);
static member RegisterClientScriptResource : System.Web.UI.Page * Type * string -> unit
Public Shared Sub RegisterClientScriptResource (page As Page, type As Type, resourceName As String)
Parâmetros
- page
- Page
O objeto de página que está a registar o script.
- type
- Type
O tipo do 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.
- resourceName
- String
Um identificador para o recurso.
Exceções
Observações
Quando regista um ficheiro de script com este método, o script é renderizado sempre que ocorre um postback assíncrono. Para registar um script para um controlo que está dentro de um UpdatePanel controlo, de modo a que o script só seja registado quando o UpdatePanel controlo for atualizado, use a RegisterClientScriptResource(Control, Type, String) sobrecarga deste método.
Se quiser registar um bloco de script que não diz respeito a atualizações parciais de página, e se quiser registar o bloco de script apenas uma vez durante a renderização inicial da página, use o RegisterClientScriptBlock método da ClientScriptManager classe. Podes obter uma referência ao ClientScriptManager objeto a partir da ClientScript propriedade da página.
Ver também
Aplica-se a
RegisterClientScriptResource(Control, Type, String)
Regista o script cliente que está embutido numa assembleia com o ScriptManager controlo para ser usado com um controlo que participa na renderização parcial da página.
public:
static void RegisterClientScriptResource(System::Web::UI::Control ^ control, Type ^ type, System::String ^ resourceName);
public static void RegisterClientScriptResource(System.Web.UI.Control control, Type type, string resourceName);
static member RegisterClientScriptResource : System.Web.UI.Control * Type * string -> unit
Public Shared Sub RegisterClientScriptResource (control As Control, type As Type, resourceName As String)
Parâmetros
- control
- Control
O controlo que está a registar o script.
- type
- Type
O tipo do 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.
- resourceName
- String
Um identificador para o recurso.
Exceções
O recurso type do cliente é null.
-ou-
O controlo que regista o script é null.
O controlo que regista o script não está na árvore de controlo da página.
Observações
Utiliza-se o método RegisterClientScriptResource para registar um script compatível com renderização de páginas parciais e que não tenha dependências Microsoft da Ajax Library. Os recursos de script registados através deste método são registados apenas quando control representam um controlo que está dentro de um UpdatePanel controlo atualizado. Para registar um script sempre que ocorra um postback assíncrono, use a RegisterStartupScript(Page, Type, String, String, Boolean) sobrecarga deste método.
Se quiser registar um bloco de script que não diz respeito a atualizações parciais de página, e se quiser registar o bloco de script apenas uma vez durante a renderização inicial da página, use o RegisterClientScriptBlock método da ClientScriptManager classe. Podes obter uma referência ao ClientScriptManager objeto a partir da ClientScript propriedade da página.
O RegisterClientScriptResource método é usado quando recursos de assemblies são acedidos através de um handler HTTP. Este método inclui o conteúdo da URL do recurso num script elemento.
Tanto o RegisterClientScriptInclude como o RegisterClientScriptResource método carregam ficheiros de script no navegador. Se um script com o mesmo tipo e chave (para um ficheiro de script) ou com o mesmo tipo e nome de recurso (para um recurso embutido) já estiver carregado, o script não é recarregado.