ScriptManager.RegisterClientScriptInclude ScriptManager.RegisterClientScriptInclude ScriptManager.RegisterClientScriptInclude Method

Определение

Регистрирует файл клиентского скрипта с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и затем добавляет ссылку на файл скрипта к странице.Registers a client script file with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds a script file reference to the page.

Перегрузки

RegisterClientScriptInclude(Control, Type, String, String) RegisterClientScriptInclude(Control, Type, String, String) RegisterClientScriptInclude(Control, Type, String, String)

Регистрирует файл клиентского скрипта с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и затем добавляет ссылку на файл скрипта к странице.Registers a client script file with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds a script file reference to the page.

RegisterClientScriptInclude(Page, Type, String, String) RegisterClientScriptInclude(Page, Type, String, String) RegisterClientScriptInclude(Page, Type, String, String)

Регистрирует клиентский скрипт с помощью элемента управления ScriptManager при каждой асинхронной обратной передаче, и затем добавляет ссылку на файл скрипта к странице.Registers client script with the ScriptManager control every time that an asynchronous postback occurs, and then adds a script file reference to the page.

RegisterClientScriptInclude(Control, Type, String, String) RegisterClientScriptInclude(Control, Type, String, String) RegisterClientScriptInclude(Control, Type, String, String)

Регистрирует файл клиентского скрипта с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и затем добавляет ссылку на файл скрипта к странице.Registers a client script file with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds a script file reference to the page.

public:
 static void RegisterClientScriptInclude(System::Web::UI::Control ^ control, Type ^ type, System::String ^ key, System::String ^ url);
public static void RegisterClientScriptInclude (System.Web.UI.Control control, Type type, string key, string url);
static member RegisterClientScriptInclude : System.Web.UI.Control * Type * string * string -> unit

Параметры

control
Control Control Control

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

type
Type Type Type

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

url
String String String

URL-адрес файла скрипта.The URL of the script file.

Исключения

Тип type файла клиентского скрипта равен null.The client script file type is null.

-или--or- Элемент управления, регистрирующий файл скрипта, равен null.The control that is registering the script file is null.

Элемент управления, регистрирующий файл скрипта, не найден в дереве элементов управления страницы.The control that is registering the script file is not in the page's control tree.

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

- или --or- Параметр url пуст.url is empty.

Примеры

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    public void Page_Load(Object sender, EventArgs e)
    {
        if (!IsPostBack)
            Calendar1.SelectedDate = DateTime.Today;
        
    }
    protected void Page_PreRender(object sender, EventArgs e)
    {
        ScriptManager.RegisterClientScriptInclude(
            this,
            typeof(Page),
            "AlertScript",
            ResolveClientUrl("~/scripts/script_alertdiv.js"));
    }
    protected void IncrementButton_Click(object sender, EventArgs e)
    {
        Calendar1.SelectedDate = Calendar1.SelectedDate.AddDays(1.0);
    }
    protected void DecrementButton_Click(object sender, EventArgs e)
    {
        Calendar1.SelectedDate = Calendar1.SelectedDate.AddDays(-1.0);
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>ScriptManager RegisterClientScriptInclude</title>
    <style type="text/css">
    div.MessageStyle
    {
      background-color: Green;
      top: 95%;
      left: 1%;
      position: absolute;
      visibility: hidden;
    }
    </style>
</head>
<body>
    <form id="Form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1"
                               runat="server"/>

            <script type="text/javascript">
            Sys.WebForms.PageRequestManager.instance.add_endRequest(Notify);
            </script>

            <asp:UpdatePanel ID="UpdatePanel1" UpdateMode="Conditional"
                runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" runat="server"/>
                    <br />
                    Change the selected date: 
                    <asp:Button runat="server" ID="DecrementButton" Text="-" OnClick="DecrementButton_Click" />
                    <asp:Button runat="server" ID="IncrementButton" Text="+" OnClick="IncrementButton_Click" />
                </ContentTemplate>
            </asp:UpdatePanel>

            <div id="NotifyDiv" class="MessageStyle">
                Updates are complete.
            </div>
        </div>
    </form>
</body>
</html>
function Notify(sender, arg)
{
    ActivateAlertDiv('visible', 'NotifyDiv');
    setTimeout("ActivateAlertDiv('hidden', 'NotifyDiv')", 1000);
}
function ActivateAlertDiv(visstring, elem)
{
    var adiv = document.getElementById(elem);
    adiv.style.visibility = visstring;
}

Комментарии

RegisterClientScriptInclude Метод используется для регистрации файла клиентского скрипта для страницы или части страницы, участвующей в частичном обновлении страницы.You use the RegisterClientScriptInclude method to register a client script file for a page or part of a page that is participating in partial-page updates. Файлы клиентских скриптов, зарегистрированные с помощью этого метода, отправляются на страницу только в control том случае, если объект представляет элемент UpdatePanel управления, который находится внутри обновляемого элемента управления.Client script files that are registered by using this method are sent to the page only when the control represents a control that is inside an UpdatePanel control that is being updated. Чтобы зарегистрировать файл скрипта при каждом возникновении асинхронной обратной передачи, RegisterClientScriptInclude(Page, Type, String, String) используйте перегрузку этого метода.To register a script file every time that an asynchronous postback occurs, use the RegisterClientScriptInclude(Page, Type, String, String) overload of this method.

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

Метод регистрирует файл клиентского скрипта на странице, выполнив script визуализацию элемента src , открывающий тег которого содержит атрибут. RegisterClientScriptIncludeThe RegisterClientScriptInclude method registers a client script file on the page by rendering a script element whose opening tag contains a src attribute. Параметр используется для src задания атрибута. urlThe url parameter is used to set the src attribute. Для разрешения URL-адресов используйте ResolveClientUrl метод.To resolve URLs, use the ResolveClientUrl method. Этот метод использует контекст URL-адреса, который вызывается для разрешения пути.This method uses the context of the URL it is called for to resolve the path.

Оба метода RegisterClientScriptResource и визуализируют файлы скриптов в браузере. RegisterClientScriptIncludeBoth the RegisterClientScriptInclude and RegisterClientScriptResource methods render script files to the browser. Если скрипт с тем же типом и ключом (для файла скрипта) или одним и тем же типом и именем ресурса (для внедренного ресурса) уже подготовлен, то скрипт не будет повторно подготовлен к просмотру.If a script with the same type and key (for a script file) or the same type and resource name (for an embedded resource) is already rendered, the script is not rendered again.

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

RegisterClientScriptInclude(Page, Type, String, String) RegisterClientScriptInclude(Page, Type, String, String) RegisterClientScriptInclude(Page, Type, String, String)

Регистрирует клиентский скрипт с помощью элемента управления ScriptManager при каждой асинхронной обратной передаче, и затем добавляет ссылку на файл скрипта к странице.Registers client script with the ScriptManager control every time that an asynchronous postback occurs, and then adds a script file reference to the page.

public:
 static void RegisterClientScriptInclude(System::Web::UI::Page ^ page, Type ^ type, System::String ^ key, System::String ^ url);
public static void RegisterClientScriptInclude (System.Web.UI.Page page, Type type, string key, string url);
static member RegisterClientScriptInclude : System.Web.UI.Page * Type * string * string -> unit

Параметры

page
Page Page Page

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

type
Type Type Type

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

url
String String String

URL-адрес файла скрипта.The URL of the script file.

Исключения

Тип type файла клиентского скрипта равен null.The client script file type is null.

- или --or- Страница, регистрирующая файл скрипта, равна null.The page that is registering the script file is null.

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

-или--or- Параметр url пуст.url is empty.

Комментарии

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

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

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

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