ScriptManager.RegisterClientScriptInclude メソッド

リファレンス

定義

名前空間:: System.Web.UI

アセンブリ:: System.Web.Extensions.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

UpdatePanel コントロール内のコントロールで使用できるようにクライアントスクリプトファイルを ScriptManager コントロールに登録し、スクリプトファイルの参照をページに追加します。

オーバーロード

RegisterClientScriptInclude(Control, Type, String, String)	UpdatePanel コントロール内のコントロールで使用できるようにクライアントスクリプトファイルを ScriptManager コントロールに登録し、スクリプトファイルの参照をページに追加します。
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 使用して、部分ページ更新に参加しているページまたはページの一部のクライアントスクリプトファイルを登録します。このメソッドを使用して登録されたクライアントスクリプトファイルは、が更新されるコントロール内UpdatePanelにあるコントロールを表す場合controlにのみページに送信されます。非同期ポストバックが発生するたびにスクリプトファイルを登録するには、このメソッドのオーバーロードを RegisterClientScriptInclude(Page, Type, String, String) 使用します。

部分ページ更新に関連しないスクリプトブロックを登録する場合、および初期ページレンダリング中にスクリプトブロックを 1 回だけ登録する場合は、クラスのメソッドを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)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース