ScriptManager.RegisterClientScriptInclude Метод

Определение

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

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

Важно!

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

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

Перегрузки

Имя	Описание
RegisterClientScriptInclude(Control, Type, String, String)	Регистрирует файл скрипта клиента с элементом управления для использования с ScriptManager элементом управления, который находится внутри UpdatePanel элемента управления, а затем добавляет ссылку на файл скрипта на страницу.
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) перегрузку этого метода.

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

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

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

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

RegisterClientScriptInclude(Page, Type, String, String)

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

RegisterClientScriptInclude(Page, Type, String, String)

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

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)

Параметры

Исключения

Комментарии

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

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