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) этого метода.

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

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

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

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

• RegisterClientScriptResource(Page, Type, String)
• WebResourceAttribute