ScriptManager.RegisterStartupScript Метод

Определение

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

System.Web.UI

Сборка:

System.Web.Extensions.dll

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

Перегрузки

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

RegisterStartupScript(Control, Type, String, String, Boolean)

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

public:
 static void RegisterStartupScript(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);

public static void RegisterStartupScript (System.Web.UI.Control control, Type type, string key, string script, bool addScriptTags);

static member RegisterStartupScript : System.Web.UI.Control * Type * string * string * bool -> unit

Public Shared Sub RegisterStartupScript (control As Control, type As Type, key As String, script As String, addScriptTags As Boolean)

Параметры

control

Control

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

type

Type

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

key

String

Уникальный идентификатор для блока скрипта.

script

String

Скрипт для регистрации.

addScriptTags

Boolean

true для заключения блока скрипта в теги <script> и </script>; в противном случае — false.

Исключения

ArgumentNullException

control имеет значение null.

-или-

type имеет значение null.

ArgumentException

Элемент управления control не найден в дереве элементов управления страницы.

Комментарии

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

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

Блок скрипта, отображаемый методом RegisterStartupScript , выполняется после завершения загрузки страницы, но до возникновения клиентского onload события страницы. Блоки скриптов запуска находятся в нижней части отображаемой страницы ASP.NET непосредственно перед тегом </form> .

Блоки скриптов запуска, зарегистрированные с помощью , RegisterStartupScript не гарантированно будут выводиться в том же порядке, в котором они зарегистрированы. Если порядок блоков скрипта запуска важен, используйте StringBuilder объект для сбора блоков скриптов в одной строке, а затем зарегистрируйте их как один скрипт запуска.

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

• RegisterStartupScript(Page, Type, String, String, Boolean)

RegisterStartupScript(Page, Type, String, String, Boolean)

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

public:
 static void RegisterStartupScript(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ script, bool addScriptTags);

public static void RegisterStartupScript (System.Web.UI.Page page, Type type, string key, string script, bool addScriptTags);

static member RegisterStartupScript : System.Web.UI.Page * Type * string * string * bool -> unit

Public Shared Sub RegisterStartupScript (page As Page, type As Type, key As String, script As String, addScriptTags As Boolean)

Параметры

page

Page

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

type

Type

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

key

String

Уникальный идентификатор для блока скрипта.

script

String

Скрипт для регистрации.

addScriptTags

Boolean

true для заключения блока скрипта в теги <script> и </script>; в противном случае — false.

Комментарии

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

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

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

• RegisterStartupScript(Control, Type, String, String, Boolean)