ScriptManager.RegisterClientScriptResource Метод

Определение

Регистрирует встроенный в сборку клиентский скрипт с помощью элемента управления ScriptManager для использования с элементом управления, участвующем в частичной отрисовке страницы.Registers client script that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

Перегрузки

RegisterClientScriptResource(Control, Type, String)

Регистрирует встроенный в сборку клиентский скрипт с помощью элемента управления ScriptManager для использования с элементом управления, участвующем в частичной отрисовке страницы.Registers the client script that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

RegisterClientScriptResource(Page, Type, String)

Регистрирует встроенный в сборку клиентский скрипт с помощью элемента управления ScriptManager при каждой асинхронной обратной передаче.Registers a client script file that is embedded in an assembly with the ScriptManager control every time that a postback occurs.

RegisterClientScriptResource(Control, Type, String)

Регистрирует встроенный в сборку клиентский скрипт с помощью элемента управления ScriptManager для использования с элементом управления, участвующем в частичной отрисовке страницы.Registers the client script that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

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

Параметры

control
Control

Элемент управления, регистрирующий скрипт.The control that is registering the script.

type
Type

Тип клиентского скрипта.The type of the client script. Этот параметр обычно задается с оператором typeof (C#) или GetType (Visual Basic) для извлечения типа элемента управления, регистрирующего скрипт.This parameter is usually specified by using the typeof operator (C#) or the GetType operator (Visual Basic) to retrieve the type of the control that is registering the script.

resourceName
String

Идентификатор ресурса.An identifier for the resource.

Реализации

System.Web.UI.IScriptManager.RegisterClientScriptResource(System.Web.UI.Control,System.Type,System.String)

Исключения

Тип type клиентского ресурса равен null.The client resource type is null.

-или--or- Элемент управления, регистрирующий скрипт, равен null.The control that is registering the script is null.

Элемент управления, регистрирующий скрипт, не найден в дереве элементов управления страницы.The control that is registering the script is not in the page's control tree.

Комментарии

RegisterClientScriptResource Метод используется для регистрации скрипта, совместимого с частичной отрисовкой страницы и не имеющего зависимостей библиотеки Microsoft AJAX.You use the RegisterClientScriptResource method to register a script that is compatible with partial-page rendering and that has no Microsoft Ajax Library dependencies. Ресурсы скриптов, зарегистрированные с помощью этого метода, регистрируются только control в том случае, если представляет элемент UpdatePanel управления, который находится внутри обновляемого элемента управления.Script resources that are registered by using this method are registered only when control represents a control that is inside an UpdatePanel control that is updated. Чтобы зарегистрировать скрипт при каждом возникновении асинхронной обратной передачи, используйте RegisterStartupScript(Page, Type, String, String, Boolean) перегрузку этого метода.To register a script every time that an asynchronous postback occurs, use the RegisterStartupScript(Page, Type, String, String, Boolean) overload of this method.

Если требуется зарегистрировать блок скрипта, который не относится к частичным обновлениям страницы, и если требуется зарегистрировать блок сценария только один раз во время первоначальной отрисовки страницы, используйте RegisterClientScriptBlock метод ClientScriptManager класса.If you want to register a script block that does not pertain to partial-page updates, and if you want to register the script block only one time during initial page rendering, use the RegisterClientScriptBlock method of the ClientScriptManager class. Ссылку на ClientScriptManager объект можно получить ClientScript из свойства страницы.You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

Метод RegisterClientScriptResource используется, когда доступ к ресурсам из сборок осуществляется через обработчик HTTP.The RegisterClientScriptResource method is used when resources from assemblies are accessed through an HTTP handler. Этот метод включает содержимое URL-адреса ресурса в script элементе.This method includes the content of the resource URL in a script element.

Как, так RegisterClientScriptResource иметодзагружаютфайлыскриптоввбраузер.RegisterClientScriptIncludeBoth the RegisterClientScriptInclude and the RegisterClientScriptResource method load script files into the browser. Если скрипт с тем же типом и ключом (для файла скрипта) или одним и тем же типом и именем ресурса (для внедренного ресурса) уже загружен, сценарий не перезагружается.If a script with the same type and key (for a script file) or the same type and resource name (for an embedded resource) is already loaded, the script is not reloaded.

Дополнительно

RegisterClientScriptResource(Page, Type, String)

Регистрирует встроенный в сборку клиентский скрипт с помощью элемента управления ScriptManager при каждой асинхронной обратной передаче.Registers a client script file that is embedded in an assembly with the ScriptManager control every time that a postback occurs.

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

Параметры

page
Page

Объект страницы, регистрирующий скрипт.The page object that is registering the script.

type
Type

Тип клиентского скрипта.The type of the client script. Этот параметр обычно задается с оператором typeof (C#) или GetType (Visual Basic) для извлечения типа элемента управления, регистрирующего скрипт.This parameter is usually specified by using the typeof operator (C#) or the GetType operator (Visual Basic) to retrieve the type of the control that is registering the script.

resourceName
String

Идентификатор ресурса.An identifier for the resource.

Исключения

Тип type клиентского ресурса равен null.The client resource type is null.

- или --or- Страница, регистрирующая скрипт, равна null.The page that is registering the script is null.

Комментарии

При регистрации файла скрипта с помощью этого метода скрипт отображается при каждом выполнении асинхронной обратной передачи.When you register a script file with this method, the script is rendered every time that an asynchronous postback occurs. Чтобы зарегистрировать скрипт для элемента управления, находящегося внутри UpdatePanel элемента управления, чтобы скрипт регистрировался только UpdatePanel при обновлении элемента управления, используйте RegisterClientScriptResource(Control, Type, String) перегрузку этого метода.To register a script for a control that is inside an UpdatePanel control so that the script is registered only when the UpdatePanel control is updated, use the RegisterClientScriptResource(Control, Type, String) overload of this method.

Если требуется зарегистрировать блок скрипта, который не относится к частичным обновлениям страницы, и если требуется зарегистрировать блок сценария только один раз во время первоначальной отрисовки страницы, используйте RegisterClientScriptBlock метод ClientScriptManager класса.If you want to register a script block that does not pertain to partial-page updates, and if you want to register the script block only one time during initial page rendering, use the RegisterClientScriptBlock method of the ClientScriptManager class. Ссылку на ClientScriptManager объект можно получить ClientScript из свойства страницы.You can get a reference to the ClientScriptManager object from the ClientScript property of the page.

Дополнительно

Применяется к