ScriptManager.RegisterClientScriptResource Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Registra o script de cliente inserido em um assembly com o controle ScriptManager para uso com um controle que está participando da renderização parcial da página.

Sobrecargas

RegisterClientScriptResource(Page, Type, String)	Registra um arquivo de script de cliente inserido em um assembly com o controle ScriptManager sempre que um postback ocorre.
RegisterClientScriptResource(Control, Type, String)	Registra o script de cliente inserido em um assembly com o controle ScriptManager para uso com um controle que está participando da renderização parcial da página.

RegisterClientScriptResource(Page, Type, String)

Registra um arquivo de script de cliente inserido em um assembly com o controle ScriptManager sempre que um postback ocorre.

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á registrando o script.

type

Type

O tipo do 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.

resourceName

String

Um identificador para o recurso.

Exceções

ArgumentNullException

O type do recurso do cliente é null.

- ou - A página que está registrando o script é null.

Comentários

Quando você registra um arquivo de script com esse método, o script é renderizado sempre que ocorre um postback assíncrono. Para registrar um script para um controle que esteja dentro de um UpdatePanel controle para que o script seja registrado somente quando o UpdatePanel controle for atualizado, use a RegisterClientScriptResource(Control, Type, String) sobrecarga desse método.

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

Confira também

• RegisterClientScriptResource(Control, Type, String)
• WebResourceAttribute

RegisterClientScriptResource(Control, Type, String)

Registra o script de cliente inserido em um assembly com o controle ScriptManager para uso com um controle que está participando da 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 controle que está registrando o script.

type

Type

O tipo do 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.

resourceName

String

Um identificador para o recurso.

Exceções

ArgumentNullException

O type do recurso do cliente é null.

- ou - O controle que está registrando o script é null.

ArgumentException

O controle que está registrando o script não está na árvore de controle da página.

Comentários

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

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

O RegisterClientScriptResource método é usado quando recursos de assemblies são acessados por meio de um manipulador HTTP. Esse método inclui o conteúdo da URL do recurso em um script elemento.

O método e o RegisterClientScriptInclude RegisterClientScriptResource método carregam arquivos de script no navegador. Se um script com o mesmo tipo e chave (para um arquivo de script) ou o mesmo tipo e nome de recurso (para um recurso inserido) já estiver carregado, o script não será recarregado.

Confira também

• RegisterClientScriptResource(Page, Type, String)
• WebResourceAttribute