ScriptManager.RegisterClientScriptInclude Метод

Ссылка

Определение

Пространство имен:: System.Web.UI

Сборка:: System.Web.Extensions.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

RegisterClientScriptInclude(Control, Type, String, String)

RegisterClientScriptInclude(Page, Type, String, String)

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

RegisterClientScriptInclude(Control, Type, String, String)

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

Public Shared Sub RegisterClientScriptInclude (control As Control, type As Type, key As String, url As String)

Параметры

control: Control

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

type: Type

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

key: String

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

url: String

URL-адрес файла скрипта.

Исключения

ArgumentNullException

Тип type файла клиентского скрипта равен null.

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

ArgumentException

Элемент управления, регистрирующий файл скрипта, не найден в дереве элементов управления страницы.

-или- url имеет значение null.

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

Примеры

<%@ 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 для регистрации файла скрипта клиента для страницы или части страницы, которая участвует в частичном обновлении страницы. Файлы скриптов клиента, зарегистрированные с помощью этого метода, отправляются на страницу только в том случае, если control элемент управления представляет элемент управления, который находится внутри обновляемого UpdatePanel элемента управления. Чтобы зарегистрировать файл скрипта при каждом выполнении асинхронной обратной передачи, используйте перегрузку RegisterClientScriptInclude(Page, Type, String, String) этого метода.

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

Метод RegisterClientScriptInclude регистрирует файл клиентского скрипта на странице путем отрисовки script элемента, открывающий тег которого содержит src атрибут. Параметр url используется для задания атрибута src . Чтобы разрешить URL-адреса, используйте ResolveClientUrl метод. Этот метод использует контекст URL-адреса, который вызывается для разрешения пути.

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

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

RegisterClientScriptInclude(Page, Type, String, String)

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

RegisterClientScriptInclude(Page, Type, String, String)

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

Public Shared Sub RegisterClientScriptInclude (page As Page, type As Type, key As String, url As String)

Параметры

page: Page

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

type: Type

key: String

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

url: String

URL-адрес файла скрипта.

Исключения

ArgumentNullException

Тип type файла клиентского скрипта равен null.

-или- Страница, регистрирующая файл скрипта, равна null.

ArgumentException

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

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

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

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

RegisterClientScriptBlock(Control, Type, String, String, Boolean)

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

ScriptManager.RegisterClientScriptInclude Метод

Определение

Перегрузки

RegisterClientScriptInclude(Control, Type, String, String)

Параметры

Исключения

Примеры

Комментарии

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

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

RegisterClientScriptInclude(Page, Type, String, String)

Параметры

Исключения

Комментарии

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

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

Дополнительные ресурсы