ScriptManager.RegisterStartupScript ScriptManager.RegisterStartupScript ScriptManager.RegisterStartupScript Method

Определение

Регистрирует стартовый блок скрипта с помощью элемента управления ScriptManager и добавляет блок скрипта к странице.Registers a startup script block with the ScriptManager control and adds the script block to the page.

Перегрузки

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

Регистрирует стартовый блок скрипта для элемента управления, находящегося внутри UpdatePanel, используя элемент управления ScriptManager, и добавляет блок скрипта к странице.Registers a startup script block for a control that is inside an UpdatePanel by using the ScriptManager control, and adds the script block to the page.

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

Регистрирует стартовый блок скрипта для каждой асинхронной обратной передачи с помощью элемента управления ScriptManager и добавляет блок скрипта к странице.Registers a startup script block for every asynchronous postback with the ScriptManager control and adds the script block to the page.

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

Регистрирует стартовый блок скрипта для элемента управления, находящегося внутри UpdatePanel, используя элемент управления ScriptManager, и добавляет блок скрипта к странице.Registers a startup script block for a control that is inside an UpdatePanel by using the ScriptManager control, and adds the script block to the page.

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

Параметры

control
Control Control Control

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

type
Type Type Type

Тип блока клиентского скрипта.The type of the client script block. Этот параметр обычно задается с оператором 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.

key
String String String

Уникальный идентификатор для блока скрипта.A unique identifier for the script block.

script
String String String

Скрипт для регистрации.The script to register.

addScriptTags
Boolean Boolean Boolean

true для заключения блока скрипта в теги <script> и </script>; в противном случае — false.true to enclose the script block with <script> and </script> tags; otherwise, false.

Исключения

Свойство control имеет значение null.control is null.

-или--or- Свойство type имеет значение null.type is null.

Элемент управления control не найден в дереве элементов управления страницы.control is not in the page's control tree.

Комментарии

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

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

Блок скрипта, отображаемый RegisterStartupScript методом, выполняется после завершения загрузки страницы, но до возникновения события клиента onload страницы.The script block that is rendered by the RegisterStartupScript method executes when the page finishes loading but before the page's client onload event is raised. Блоки сценариев запуска находятся в нижней части отображаемой страницы ASP.NET непосредственно перед </form> тегом.Startup script blocks are located at the bottom of the rendered ASP.NET page just before the </form> tag.

Блоки сценариев запуска, зарегистрированные с помощью RegisterStartupScript , не обязательно должны выводиться в том же порядке, в котором они зарегистрированы.Startup script blocks that are registered by using RegisterStartupScript are not guaranteed to be output in the same order in which they are registered. Если важен порядок блоков сценариев запуска, используйте StringBuilder объект для сбора блоков сценария в одной строке, а затем зарегистрируйте их все как один сценарий запуска.If the order of the startup script blocks is important, use a StringBuilder object to gather the script blocks in a single string, and then register them all as a single startup script.

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

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

Регистрирует стартовый блок скрипта для каждой асинхронной обратной передачи с помощью элемента управления ScriptManager и добавляет блок скрипта к странице.Registers a startup script block for every asynchronous postback with the ScriptManager control and adds the script block to the page.

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

Параметры

page
Page Page Page

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

type
Type Type Type

Тип блока клиентского скрипта.The type of the client script block. Этот параметр обычно задается с оператором 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.

key
String String String

Уникальный идентификатор для блока скрипта.A unique identifier for the script block.

script
String String String

Скрипт для регистрации.The script to register.

addScriptTags
Boolean Boolean Boolean

true для заключения блока скрипта в теги <script> и </script>; в противном случае — false.true to enclose the script block with <script> and </script> tags; otherwise, false.

Комментарии

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

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

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

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