ScriptManager.RegisterClientScriptResource Метод

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.Extensions.dll

Регистрирует клиентский скрипт, внедренный в сборку с элементом управления для использования с ScriptManager элементом управления, участвующим в отрисовке частичной страницы.

Перегрузки

Имя	Описание
RegisterClientScriptResource(Page, Type, String)	Регистрирует файл скрипта клиента, внедренный в сборку, с ScriptManager помощью элемента управления при каждом выполнении обратной передачи.
RegisterClientScriptResource(Control, Type, String)	Регистрирует клиентский скрипт, внедренный в сборку с элементом управления для использования с ScriptManager элементом управления, участвующим в отрисовке частичной страницы.

RegisterClientScriptResource(Page, Type, String)

Регистрирует файл скрипта клиента, внедренный в сборку, с ScriptManager помощью элемента управления при каждом выполнении обратной передачи.

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)

Параметры

page

Page

Объект страницы, регистрирующий скрипт.

type

Type

Тип клиентского скрипта. Обычно этот параметр указывается с помощью оператора typeof (C#) или оператора GetType (Visual Basic) для получения типа элемента управления, регистрирующего скрипт.

resourceName

String

Идентификатор ресурса.

Исключения

ArgumentNullException

Клиентский ресурс type .null

–или–

Страница, регистрируемая скриптом null.

Комментарии

При регистрации файла скрипта с помощью этого метода скрипт выполняется отрисовка скрипта при каждом выполнении асинхронной обратной передачи. Чтобы зарегистрировать скрипт для элемента управления, который находится внутри UpdatePanel элемента управления, чтобы скрипт регистрировался только при UpdatePanel обновлении элемента управления, используйте RegisterClientScriptResource(Control, Type, String) перегрузку этого метода.

Если вы хотите зарегистрировать блок скрипта, который не относится к обновлениям частичной страницы, и если вы хотите зарегистрировать блок скрипта только один раз во время первоначальной ClientScriptManager отрисовки страниц, используйте RegisterClientScriptBlock метод класса. Ссылку на ClientScriptManager объект можно получить из ClientScript свойства страницы.

См. также раздел

• RegisterClientScriptResource(Control, Type, String)
• WebResourceAttribute

RegisterClientScriptResource(Control, Type, String)

Регистрирует клиентский скрипт, внедренный в сборку с элементом управления для использования с ScriptManager элементом управления, участвующим в отрисовке частичной страницы.

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)

Параметры

control

Control

Элемент управления, регистрирующий скрипт.

type

Type

Тип клиентского скрипта. Обычно этот параметр указывается с помощью оператора typeof (C#) или оператора GetType (Visual Basic) для получения типа элемента управления, регистрирующего скрипт.

resourceName

String

Идентификатор ресурса.

Исключения

ArgumentNullException

Клиентский ресурс type .null

–или–

Элемент управления, регистрирующий скрипт null.

ArgumentException

Элемент управления, регистрирующий скрипт, не находится в дереве элементов управления страницы.

Комментарии

Метод используется RegisterClientScriptResource для регистрации скрипта, совместимого с частичной отрисовкой страницы и не зависимостей библиотеки Microsoft Ajax. Ресурсы скриптов, зарегистрированные с помощью этого метода, регистрируются только при control представлении элемента управления, который находится внутри обновленного UpdatePanel элемента управления. Чтобы регистрировать скрипт при каждом возникновении асинхронной обратной передачи, используйте RegisterStartupScript(Page, Type, String, String, Boolean) перегрузку этого метода.

Если вы хотите зарегистрировать блок скрипта, который не относится к обновлениям частичной страницы, и если вы хотите зарегистрировать блок скрипта только один раз во время первоначальной ClientScriptManager отрисовки страниц, используйте RegisterClientScriptBlock метод класса. Ссылку на ClientScriptManager объект можно получить из ClientScript свойства страницы.

Метод RegisterClientScriptResource используется при доступе к ресурсам из сборок через обработчик HTTP. Этот метод включает содержимое URL-адреса ресурса в элементе script .

RegisterClientScriptInclude Файлы скриптов загрузки метода и RegisterClientScriptResource метода в браузер. Если скрипт с тем же типом и ключом (для файла скрипта) или тем же типом и именем ресурса (для внедренного ресурса) уже загружен, скрипт не перезагрузится.

См. также раздел

• RegisterClientScriptResource(Page, Type, String)
• WebResourceAttribute