Поделиться через

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Значение , falseчтобы заключить блок скрипта с <script> тегами и </script> тегами; в противном случае .

Исключения

ArgumentNullException

control равно null.

–или–

type равно null.

ArgumentException

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

Комментарии

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

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

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

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

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

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

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Значение , falseчтобы заключить блок скрипта с <script> тегами и </script> тегами; в противном случае .

Комментарии

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

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

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

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