ScriptManager クラス

定義

ASP.NET Ajax スクリプト ライブラリとスクリプト ファイル、部分ページ レンダリング、および Web サービスとアプリケーション サービスのクライアント プロキシ クラス生成を管理します。

public ref class ScriptManager : System::Web::UI::Control, System::Web::UI::IPostBackDataHandler, System::Web::UI::IPostBackEventHandler
[System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.ScriptManager.bmp")]
public class ScriptManager : System.Web.UI.Control, System.Web.UI.IPostBackDataHandler, System.Web.UI.IPostBackEventHandler
[<System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.ScriptManager.bmp")>]
type ScriptManager = class
    inherit Control
    interface IPostBackDataHandler
    interface IPostBackEventHandler
Public Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler
継承
ScriptManager
属性
実装

次の例は、 コントロールを使用するためのさまざまなシナリオを ScriptManager 示しています。

Partial-Page 更新の有効化

次の例は、 コントロールを使用 ScriptManager して部分ページ更新を有効にする方法を示しています。 この例では、 Calendar コントロールと DropDownList コントロールが コントロール内にあります UpdatePanel 。 既定では、 プロパティの UpdateMode 値は で Always、プロパティの ChildrenAsTriggers 値は です true。 したがって、パネルの子コントロールによって非同期ポストバックが発生します。


<%@ 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">
    void DropDownSelection_Change(Object sender, EventArgs e)
    {
        Calendar1.DayStyle.BackColor =
            System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
    }

    protected void Calendar1_SelectionChanged(object sender, EventArgs e)
    {
        SelectedDate.Text = 
            Calendar1.SelectedDate.ToString();
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
                               runat="server" />
            <asp:UpdatePanel ID="UpdatePanel1"
                             runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" 
                                  ShowTitle="True"
                                  OnSelectionChanged="Calendar1_SelectionChanged"
                                  runat="server" />
                    <div>
                        Background:
                        <br />
                        <asp:DropDownList ID="ColorList" 
                                          AutoPostBack="True" 
                                          OnSelectedIndexChanged="DropDownSelection_Change"
                                          runat="server">
                            <asp:ListItem Selected="True" Value="White"> 
                            White </asp:ListItem>
                            <asp:ListItem Value="Silver"> 
                            Silver </asp:ListItem>
                            <asp:ListItem Value="DarkGray"> 
                            Dark Gray </asp:ListItem>
                            <asp:ListItem Value="Khaki"> 
                            Khaki </asp:ListItem>
                            <asp:ListItem Value="DarkKhaki"> D
                            ark Khaki </asp:ListItem>
                        </asp:DropDownList>
                    </div>
                    <br />
                    Selected date:
                    <asp:Label ID="SelectedDate" 
                               runat="server">None.</asp:Label>
                </ContentTemplate>
            </asp:UpdatePanel>
            <br />
        </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

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

<script runat="server">
    Sub DropDownSelection_Change(ByVal Sender As Object, ByVal E As EventArgs)
        Calendar1.DayStyle.BackColor = _
        System.Drawing.Color.FromName(ColorList.SelectedItem.Value)
    End Sub

    Protected Sub Calendar1_SelectionChanged(ByVal Sender As Object, ByVal E As EventArgs)
        SelectedDate.Text = Calendar1.SelectedDate.ToString()
    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
                               runat="server" />
            <asp:UpdatePanel ID="UpdatePanel1"
                             runat="server">
                <ContentTemplate>
                    <asp:Calendar ID="Calendar1" 
                                  ShowTitle="True"
                                  OnSelectionChanged="Calendar1_SelectionChanged"
                                  runat="server" />
                    <div>
                        Background:
                        <br />
                        <asp:DropDownList ID="ColorList" 
                                          AutoPostBack="True" 
                                          OnSelectedIndexChanged="DropDownSelection_Change"
                                          runat="server">
                            <asp:ListItem Selected="True" Value="White"> 
                            White </asp:ListItem>
                            <asp:ListItem Value="Silver"> 
                            Silver </asp:ListItem>
                            <asp:ListItem Value="DarkGray"> 
                            Dark Gray </asp:ListItem>
                            <asp:ListItem Value="Khaki"> 
                            Khaki </asp:ListItem>
                            <asp:ListItem Value="DarkKhaki"> D
                            ark Khaki </asp:ListItem>
                        </asp:DropDownList>
                    </div>
                    <br />
                    Selected date:
                    <asp:Label ID="SelectedDate" 
                               runat="server">None.</asp:Label>
                </ContentTemplate>
            </asp:UpdatePanel>
            <br />
        </div>
    </form>
</body>
</html>

Partial-Page更新エラーの処理とスクリプトの登録

次の例は、部分ページ更新時にカスタム エラー処理を提供する方法を示しています。 既定では、部分ページ更新中にエラーが発生すると、JavaScript メッセージ ボックスが表示されます。 この例では、イベントのハンドラーを指定し、イベント ハンドラー AsyncPostBackError で プロパティを設定することで、カスタム エラー処理を AsyncPostBackErrorMessage 使用する方法を示します。 プロパティを AllowCustomErrorsRedirect 設定して、部分ページの更新中にエラーが発生したときに、Web.config ファイルのカスタム エラー セクションを使用する方法を指定することもできます。 この例では、 プロパティの既定値が AllowCustomErrorsRedirect 使用されます。 つまり、Web.config ファイルに customErrors 要素が含まれている場合、その要素によってエラーの表示方法が決まります。 詳細については、「 customErrors 要素 (ASP.NET 設定スキーマ)」を参照してください。

<%@ 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">

    protected void Button1_Click(object sender, EventArgs e)
    {
        try
        {
            int a = Int32.Parse(TextBox1.Text);
            int b = Int32.Parse(TextBox2.Text);
            int res = a / b;
            Label1.Text = res.ToString();
        }
        catch (Exception ex)
        {
            if (TextBox1.Text.Length > 0 && TextBox2.Text.Length > 0)
            {
                ex.Data["ExtraInfo"] = " You can't divide " +
                    TextBox1.Text + " by " + TextBox2.Text + ".";
            }
            throw ex;
        }
    }

    protected void ScriptManager1_AsyncPostBackError(object sender, AsyncPostBackErrorEventArgs e)
    {
        if (e.Exception.Data["ExtraInfo"] != null)
        {
            ScriptManager1.AsyncPostBackErrorMessage =
                e.Exception.Message +
                e.Exception.Data["ExtraInfo"].ToString();
        }
        else
        {
            ScriptManager1.AsyncPostBackErrorMessage =
                "An unspecified error occurred.";
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Error Handling Example</title>
    <style type="text/css">
    #UpdatePanel1 {
      width: 200px; height: 50px;
      border: solid 1px gray;
    }
    #AlertDiv{
    left: 40%; top: 40%;
    position: absolute; width: 200px;
    padding: 12px; 
    border: #000000 1px solid;
    background-color: white; 
    text-align: left;
    visibility: hidden;
    z-index: 99;
    }
    #AlertButtons{
    position: absolute; right: 5%; bottom: 5%;
    }
    </style>
</head>
<body id="bodytag">
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
            OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
            <Scripts>
            <asp:ScriptReference Path="ErrorHandling.js" />
            </Scripts>
            </asp:ScriptManager>
            <asp:UpdatePanel ID="UpdatePanel1" runat="server">
                <ContentTemplate>
                    <asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
                    /
                    <asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
                    =
                    <asp:Label ID="Label1" runat="server"></asp:Label><br />
                    <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
                </ContentTemplate>
            </asp:UpdatePanel>
            <div id="AlertDiv">
                <div id="AlertMessage">
                </div>
                <br />
                <div id="AlertButtons">
                    <input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
                </div>
            </div>
        </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>

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

<script runat="server">
    Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
        Try
            Dim a As Int32
            a = Int32.Parse(TextBox1.Text)
            Dim b As Int32
            b = Int32.Parse(TextBox2.Text)
            Dim res As Int32 = a / b
            Label1.Text = res.ToString()
        Catch ex As Exception
            If (TextBox1.Text.Length > 0 AndAlso TextBox2.Text.Length > 0) Then
                ex.Data("ExtraInfo") = " You can't divide " & _
                  TextBox1.Text & " by " & TextBox2.Text & "."
            End If
            Throw ex
        End Try

    End Sub
    Protected Sub ScriptManager1_AsyncPostBackError(ByVal sender As Object, ByVal e As System.Web.UI.AsyncPostBackErrorEventArgs)
        If (e.Exception.Data("ExtraInfo") <> Nothing) Then
            ScriptManager1.AsyncPostBackErrorMessage = _
               e.Exception.Message & _
               e.Exception.Data("ExtraInfo").ToString()
        Else
            ScriptManager1.AsyncPostBackErrorMessage = _
               "An unspecified error occurred."
        End If
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Error Handling Example</title>
    <style type="text/css">
    #UpdatePanel1 {
      width: 200px; height: 50px;
      border: solid 1px gray;
    }
    #AlertDiv{
    left: 40%; top: 40%;
    position: absolute; width: 200px;
    padding: 12px; 
    border: #000000 1px solid;
    background-color: white; 
    text-align: left;
    visibility: hidden;
    z-index: 99;
    }
    #AlertButtons{
    position: absolute; right: 5%; bottom: 5%;
    }
    </style>
</head>
<body id="bodytag">
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
            OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
            <Scripts>
            <asp:ScriptReference Path="ErrorHandling.js" />
            </Scripts>
            </asp:ScriptManager>

            <asp:UpdatePanel ID="UpdatePanel1" runat="server">
                <ContentTemplate>
                    <asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
                    /
                    <asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
                    =
                    <asp:Label ID="Label1" runat="server"></asp:Label><br />
                    <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
                </ContentTemplate>
            </asp:UpdatePanel>
            <div id="AlertDiv">
                <div id="AlertMessage">
                </div>
                <br />
                <div id="AlertButtons">
                    <input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
                </div>
            </div>
        </div>
    </form>
</body>
</html>

ブラウザーに表示される日付と時刻のグローバル化

次の例では、 プロパティを EnableScriptGlobalization 設定して、クライアント スクリプトがブラウザーにカルチャ固有の日付と時刻を表示できるようにする方法を示します。 この例では、 Culture@ Page ディレクティブの 属性が に auto設定されています。 その結果、現在のブラウザー設定で指定されている最初の言語によって、ページのカルチャと UI カルチャが決まります。 詳細については、「 方法: Web ページのグローバリゼーションのカルチャと UI カルチャ ASP.NET 設定する」を参照してください。

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>Globalization Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
        </asp:ScriptManager>
        <script type="text/javascript">
        function pageLoad() {
          Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
        }
        function formatDate() {
          var d = new Date();
          try {
            $get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
          }
          catch(e) {
            alert("Error:" + e.message);
          }
        }
        </script>
        <asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
        <ContentTemplate>
        <asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
        <asp:Button ID="Button1" runat="server" Text="Display Date" />

        <br />

        <asp:Label ID="Label1" runat="server"></asp:Label>
        </asp:Panel>
        </ContentTemplate>
        </asp:UpdatePanel>
    </form>
</body>
</html>
<%@ Page Language="VB" Culture="auto" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>Globalization Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
        </asp:ScriptManager>
        <script type="text/javascript">
        function pageLoad() {
          Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
        }
        function formatDate() {
          var d = new Date();
          try {
            $get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
          }
          catch(e) {
            alert("Error:" + e.message);
          }
        }
        </script>
        <asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
        <ContentTemplate>
        <asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
        <asp:Button ID="Button1" runat="server" Text="Display Date" />

        <br />

        <asp:Label ID="Label1" runat="server"></asp:Label>
        </asp:Panel>
        </ContentTemplate>
        </asp:UpdatePanel>
    </form>
</body>
</html>

注釈

このトピックの内容:

はじめに

コントロールは ScriptManager 、ASP.NET の Ajax 機能の中心です。 コントロールは、ページ上のすべての ASP.NET Ajax リソースを管理します。 これには、ブラウザーへの Microsoft Ajax ライブラリ スクリプトのダウンロードや、コントロールを使用 UpdatePanel して有効になっている部分ページ更新プログラムの調整が含まれます。 さらに、 コントロールを ScriptManager 使用すると、次の操作を行うことができます。

  • 部分ページ更新プログラムと互換性のあるスクリプトを登録します。 スクリプトとコア ライブラリの間の依存関係を管理するために、登録したスクリプトは Microsoft Ajax ライブラリ スクリプトの後に読み込まれます。

  • リリース スクリプトとデバッグ スクリプトのどちらをブラウザーに送信するかを指定します。

  • Web サービスを コントロールに登録して、スクリプトから Web サービス メソッドへのアクセスを ScriptManager 提供します。

  • クライアント スクリプトから ASP.NET 認証、ロール、プロファイル アプリケーション サービスへのアクセスを提供するには、これらのサービスを コントロールに ScriptManager 登録します。

  • ブラウザーで ECMAScript (JavaScript) の日付数値および文字列 関数のカルチャ固有の表示を有効にします。

  • コントロールの プロパティを使用して ResourceUICultures 、埋め込みスクリプト ファイルまたはスタンドアロン スクリプト ファイルのローカライズ リソースに ScriptReference アクセスします。

  • クライアント コンポーネントと動作に必要なスクリプトがレンダリングされるように、 または IScriptControl インターフェイスをScriptManager実装IExtenderControlするサーバー コントロールを コントロールに登録します。

Partial-Page レンダリング

部分ページ レンダリングをサポートする ASP.NET ページの機能は、次の要因によって制御されます。

プロパティの値は、実行時にページInitEnablePartialRenderingイベントの実行中または前にオーバーライドできます。 ページ Init のイベントが発生した後にこのプロパティを変更しようとすると、 InvalidOperationException 例外がスローされます。

部分ページレンダリングがサポートされている場合、 ScriptManager コントロールは非同期ポストバックと部分ページ更新を有効にするスクリプトをレンダリングします。 更新するページの領域は、コントロールを使用 UpdatePanel して指定されます。 コントロールは ScriptManager 非同期ポストバックを処理し、更新する必要があるページの領域のみを更新します。 部分ページ レンダリングの詳細については、「 部分ページ レンダリングの概要」を参照してください。 更新の原因となる条件の詳細については、「 UpdatePanel コントロールの概要」を参照してください。

マスター ページ、ユーザー コントロール、およびその他の子コンポーネントでの ScriptManager コントロールの使用

1 つのページに含めることができるコントロールは、階層内で 1 つだけ ScriptManager です。 親ページに既にコントロールがある場合に、入れ子になったページ、ユーザー コントロール、またはコンポーネントのサービスとスクリプトを ScriptManager 登録するには、 コントロールを使用します ScriptManagerProxy 。 詳細については、「 マスター ページでの UpdatePanel コントロールの使用」を参照してください。

スクリプトの管理と登録

ScriptManagerコントロールを使用すると、ページの一部としてレンダリングされるスクリプトを登録できます。 コントロールの登録方法は ScriptManager 、次の 3 つのカテゴリに分けることができます。

  • Microsoft Ajax ライブラリへのスクリプトの依存関係が維持されることを保証する登録メソッド。

  • Microsoft Ajax ライブラリに依存していないが、コントロールと UpdatePanel 互換性のある登録メソッド。

  • コントロールの操作 UpdatePanel をサポートする登録メソッド。

ASP.NET で Ajax スクリプトを作成して使用する方法の詳細については、「 Microsoft Ajax ライブラリを使用したカスタム クライアント スクリプトの作成」を参照してください。

Microsoft Ajax ライブラリに依存するスクリプトの登録

次のメソッドを使用すると、Microsoft Ajax ライブラリへの依存関係が維持されることを保証する方法でスクリプト ファイルを登録できます。

メソッド 定義
RegisterScriptControl Sys.Component クライアント オブジェクトの定義にIScriptControl使用されるインターフェイスを実装するサーバー コントロールを登録します。 コントロールは ScriptManager 、クライアント オブジェクトをサポートするスクリプトをレンダリングします。
RegisterExtenderControl Sys.Component クライアント オブジェクトの定義にIExtenderControl使用されるインターフェイスを実装するサーバー コントロールを登録します。 コントロールは ScriptManager 、クライアント オブジェクトをサポートするスクリプトをレンダリングします。

互換性のあるスクリプトPartial-Page更新プログラムを登録する

次のメソッドを使用して、Microsoft Ajax ライブラリに依存していないがコントロールと互換性のあるスクリプト ファイルを UpdatePanel 登録できます。 これらのメソッドは、コントロールの同様のメソッドに ClientScriptManager 対応しています。 コントロール内で使用するスクリプトをレンダリングする UpdatePanel 場合は、必ずコントロールのメソッドを ScriptManager 呼び出してください。

メソッド 定義
RegisterArrayDeclaration JavaScript 配列に値を追加します。 配列が存在しない場合は、作成されます。
RegisterClientScriptBlock ページの script 開始 <form> タグの後に要素をレンダリングします。 スクリプトは文字列パラメーターとして指定されます。
RegisterClientScriptInclude ページの script 開始 <form> タグの後に要素をレンダリングします。 スクリプトの内容は、 属性を src スクリプト ファイルを指す URL に設定することで指定されます。
RegisterClientScriptResource ページの script 開始 <form> タグの後に要素をレンダリングします。 スクリプトの内容は、アセンブリ内のリソース名で指定されます。 属性には src 、アセンブリから名前付きスクリプトを取得する HTTP ハンドラーの呼び出しによって、URL が自動的に設定されます。
RegisterExpandoAttribute 指定したコントロールのマークアップでカスタムの名前と値の属性ペア (expando) をレンダリングします。
RegisterHiddenField 非表示フィールドをレンダリングします。
RegisterOnSubmitStatement 要素submitの イベントに応答して実行されるスクリプトをform登録します。 属性は onSubmit 、指定されたスクリプトを参照します。
RegisterStartupScript ページの終了 </form> タグの直前にスタートアップ スクリプト ブロックをレンダリングします。 レンダリングするスクリプトは、文字列パラメーターとして指定されます。

メソッドを登録するときは、そのスクリプトの型とキーのペアを指定します。 同じ型とキーのペアを持つスクリプトが既に登録されている場合、新しいスクリプトは登録されません。 同様に、既に存在する型/リソース名のペアでスクリプトを登録した場合、リソースを script 参照する要素は再び追加されません。 以前に登録した属性の expando 属性を登録すると、例外がスローされます。 配列値の重複登録が許可されます。

または メソッドをRegisterClientScriptIncludeRegisterClientScriptResource呼び出すときは、インライン関数を実行するスクリプトを登録しないでください。 代わりに、アプリケーションのイベント ハンドラーやカスタム クラス定義などの関数定義を含むスクリプトを登録します。

UpdatePanel コントロールの登録メソッド

コントロールを使用する場合は、次のメソッドを使用 UpdatePanel して部分ページ更新をカスタマイズできます。

メソッド 定義
RegisterAsyncPostBackControl コントロールを非同期ポストバックのトリガーとして登録します。
RegisterDataItem 部分ページ レンダリング中にカスタム データをコントロールに送信します。
RegisterDispose コントロール内にあるコントロールの破棄スクリプトを UpdatePanel 登録します。 このスクリプトは、UpdatePanel コントロールが更新または削除されるときに実行されます。 dispose メソッドは、Microsoft Ajax ライブラリの一部であり、コンポーネントが使用されなくなったときにリソースを解放する必要があるクライアント コンポーネントに使用されます。
RegisterPostBackControl フル ポストバックのトリガーとしてコントロールを登録します。 このメソッドは、非同期ポストバックを実行する UpdatePanel コントロール内のコントロールに使用されます。

Web サービス参照

クライアント スクリプトから呼び出される Web サービスを登録するには、オブジェクトをServiceReference作成し、それをコントロールのScriptManagerコレクションにServices追加します。 ASP.NET は、コレクション内のオブジェクトごとに ServiceReference クライアント プロキシ オブジェクトを Services 生成します。 実行時に Web サービスを登録するために、Servicesプログラムによってオブジェクトをコレクションに追加ServiceReferenceできます。

スクリプトで Web サービスにアクセスする方法の詳細については、「 AJAX で Web サービスをクライアント スクリプトに公開する」および「ASP.NET ASP.NET AJAXクライアント スクリプトから Web サービスを呼び出す」を参照してください。

ローカリゼーション

コントロールは ScriptManager 、アセンブリまたはスタンドアロン スクリプト ファイルに埋め込まれたスクリプト ファイルである、適切なローカライズされたスクリプト ファイルを指す参照をレンダリングされたページに生成します。

プロパティが EnableScriptLocalizationtrueScriptManager設定されている場合、コントロールは、現在のカルチャのローカライズされたリソース (ローカライズされた文字列など) を取得します (存在する場合)。 コントロールには ScriptManager 、ローカライズされたリソースを使用するための次の機能が用意されています。

  • アセンブリに埋め込まれているスクリプト ファイル。 コントロールは ScriptManager 、ブラウザーに送信するカルチャ固有のスクリプト ファイルまたはフォールバック カルチャ スクリプト ファイルを決定します。 これは、カルチャ固有 NeutralResourcesLanguageAttribute のアセンブリ属性、アセンブリと共にパッケージ化されたリソース、およびブラウザーの UI カルチャ (存在する場合) を使用して行います。

  • スタンドアロン スクリプト ファイル。 コントロールは ScriptManager 、 オブジェクトの プロパティを使用 ResourceUICultures してサポートされる UI カルチャの一覧を ScriptReference 定義します。

  • デバッグ モード。 コントロールは ScriptManager 、デバッグ情報を含むカルチャ固有のスクリプト ファイルのレンダリングを試みます。 たとえば、ページがデバッグ モードで、現在のカルチャが en-MX に設定されている場合、ファイルが存在する場合、コントロールは .en-MX.debug.js などの scriptname名前を持つスクリプト ファイルをレンダリングします。 ファイルが存在しない場合は、適切なフォールバック カルチャのデバッグ ファイルがレンダリングされます

リソースをローカライズする方法の詳細については、「 コンポーネント ライブラリのリソースのローカライズの概要」を参照してください。

エラー処理

非同期ポストバック中にページ エラーが発生すると、 AsyncPostBackError イベントが発生します。 サーバー上のエラーをクライアントに送信する方法は、Web.config ファイルのプロパティ、AsyncPostBackErrorMessageプロパティ、およびカスタム エラー セクションによって異なりますAllowCustomErrorsRedirect。 詳細については、「 UpdatePanel コントロールのエラー処理のカスタマイズ」を参照してください。

宣言構文

<asp:ScriptManager  
    AllowCustomErrorsRedirect="True|False"  
    AsyncPostBackErrorMessage="string"  
    AsyncPostBackTimeout="integer"  
    AuthenticationService-Path="uri"  
    EnablePageMethods="True|False"  
    EnablePartialRendering="True|False"  
    EnableScriptGlobalization="True|False"  
    EnableScriptLocalization="True|False"  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    ID="string"  
    LoadScriptsBeforeUI="True|False"  
    OnAsyncPostBackError="AsyncPostBackError event handler"  
    OnDataBinding="DataBinding event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnResolveScriptReference="ResolveScriptReference event handler"  
    OnUnload="Unload event handler"  
    ProfileService-LoadProperties="string"  
    ProfileService-Path="uri"  
    RoleService-LoadRoles="True|False"  
    RoleService-Path="uri"  
    runat="server"  
    ScriptMode="Auto|Inherit|Debug|Release"  
    ScriptPath="string"  
    SkinID="string"  
    SupportsPartialRendering="True|False"  
    Visible="True|False"  
>  
        <AuthenticationService  
            Path="uri"  
        />  
        <ProfileService  
            LoadProperties="string"  
            Path="uri"  
        />  
        <RoleService  
            LoadRoles="True|False"  
            Path="uri"  
        />  
        <Scripts>  
            <asp:ScriptReference  
                Assembly="string"  
                IgnoreScriptPath="True|False"  
                Name="string"  
                NotifyScriptLoaded="True|False"  
                Path="string"  
                ResourceUICultures="string"  
                ScriptMode="Auto|Debug|Inherit|Release"  
            />  
        </Scripts>  
        <Services>  
            <asp:ServiceReference  
                InlineScript="True|False"  
                Path="string"  
            />  
        </Services>  
</asp:ScriptManager>  

コンストラクター

ScriptManager()

ScriptManager クラスの新しいインスタンスを初期化します。

プロパティ

Adapter

コントロール用のブラウザー固有のアダプターを取得します。

(継承元 Control)
AjaxFrameworkAssembly

ページのコンポーネントが使用する AJAX フレームワーク アセンブリを取得します。

AjaxFrameworkMode

Microsoft Ajax クライアント ライブラリのクライアント スクリプトをクライアントに含める方法を示す値を取得または設定します。

AllowCustomErrorsRedirect

非同期ポストバック中にエラーが発生したときに Web.config ファイルのカスタム エラー セクションを使用するかどうかを指定する値を取得または設定します。

AppRelativeTemplateSourceDirectory

このコントロールが含まれている Page オブジェクトまたは UserControl オブジェクトのアプリケーション相対の仮想ディレクトリを取得または設定します。

(継承元 Control)
AsyncPostBackErrorMessage

非同期ポストバック中に未処理のサーバー例外が発生するとクライアントに送信されるエラー メッセージを取得または設定します。

AsyncPostBackSourceElementID

非同期ポストバックを発生させたコントロールの一意の ID を取得します。

AsyncPostBackTimeout

応答がない場合に非同期ポストバックがタイムアウトするまでの時間 (秒単位) を表す値を取得または設定します。

AuthenticationService

現在の ScriptManager インスタンスに関連付けられている AuthenticationServiceManager オブジェクトを取得します。

BindingContainer

このコントロールのデータ バインディングを格納しているコントロールを取得します。

(継承元 Control)
ChildControlsCreated

サーバー コントロールの子コントロールが作成されたかどうかを示す値を取得します。

(継承元 Control)
ClientID

ASP.NET によって生成される HTML マークアップのコントロール ID を取得します。

(継承元 Control)
ClientIDMode

ClientID プロパティの値を生成するために使用されるアルゴリズムを取得または設定します。

(継承元 Control)
ClientIDSeparator

ClientID プロパティで使用される区切り記号を表す文字値を取得します。

(継承元 Control)
ClientNavigateHandler

クライアントで Sys.Application.navigate イベントを処理するメソッドの名前を取得または設定します。

CompositeScript

Web ページをサポートする複合スクリプトへの参照を取得します。

Context

現在の Web 要求に対するサーバー コントロールに関連付けられている HttpContext オブジェクトを取得します。

(継承元 Control)
Controls

UI 階層内の指定されたサーバー コントロールの子コントロールを表す ControlCollection オブジェクトを取得します。

(継承元 Control)
DataItemContainer

名前付けコンテナーが IDataItemContainer を実装している場合、名前付けコンテナーへの参照を取得します。

(継承元 Control)
DataKeysContainer

名前付けコンテナーが IDataKeysControl を実装している場合、名前付けコンテナーへの参照を取得します。

(継承元 Control)
DesignMode

コントロールがデザイン サーフェイスで使用されているかどうかを示す値を取得します。

(継承元 Control)
EmptyPageUrl

空白の Web ページの URL を取得または設定します。

EnableCdn

現在のページがクライアント スクリプト参照を CDN (Content Delivery Network) パスから読み込むかどうかを判断します。

EnableCdnFallback

CDN (Content Delivery Network) が使用できない場合にスクリプトのローカル コピーの読み込みを有効にします。

EnableHistory

Web ページが履歴ポイントの管理をサポートしているかどうかを示す値を取得または設定します。

EnablePageMethods

ASP.NET ページ内のパブリック静的ページ メソッドをクライアント スクリプトから 呼び出せるかどうかを示す値を取得または設定します。

EnablePartialRendering

ページの部分レンダリングを有効化する値を取得または設定します。これにより、UpdatePanel コントロールを使用してページの各部を個別に更新できるようになります。

EnableScriptGlobalization

ScriptManager コントロールが、カルチャ固有の情報の解析および書式設定をサポートするスクリプトをレンダリングするかどうかを示す値を取得または設定します。

EnableScriptLocalization

ScriptManager コントロールが、スクリプト ファイルのローカライズ バージョンをレンダリングするかどうかを示す値を取得または設定します。

EnableSecureHistoryState

履歴状態文字列を暗号化するかどうかを示す値を取得または設定します。

EnableTheming

テーマがこのコントロールに適用されるかどうかを示す値を取得または設定します。

(継承元 Control)
EnableViewState

要求元クライアントに対して、サーバー コントロールがそのビュー状態と、そこに含まれる任意の子のコントロールのビュー状態を保持するかどうかを示す値を取得または設定します。

(継承元 Control)
Events

コントロールのイベント ハンドラー デリゲートのリストを取得します。 このプロパティは読み取り専用です。

(継承元 Control)
HasChildViewState

現在のサーバー コントロールの子コントロールが、保存されたビューステートの設定を持っているかどうかを示す値を取得します。

(継承元 Control)
ID

サーバー コントロールに割り当てられたプログラム ID を取得または設定します。

(継承元 Control)
IdSeparator

コントロール ID を区別するために使用する文字を取得します。

(継承元 Control)
IsChildControlStateCleared

このコントロールに含まれているコントロールに、コントロールの状態が設定されているかどうかを示す値を取得します。

(継承元 Control)
IsDebuggingEnabled

クライアント スクリプト ライブラリのデバッグ バージョンがレンダリングされるかどうかを示す値を取得します。

IsInAsyncPostBack

部分レンダリング モードで現在のポストバックが実行されているかどうかを示す値を取得します。

IsNavigating

Navigate イベントが現在処理されているかどうかを示す値を取得します。

IsTrackingViewState

サーバー コントロールがビューステートの変更を保存しているかどうかを示す値を取得します。

(継承元 Control)
IsViewStateEnabled

このコントロールでビューステートが有効かどうかを示す値を取得します。

(継承元 Control)
LoadScriptsBeforeUI

ページ UI のマークアップが読み込まれる前と後のどちらにスクリプトが読み込まれるかを示す値を取得または設定します。

LoadViewStateByID

コントロールがインデックスではなく ID によりビューステートの読み込みを行うかどうかを示す値を取得します。

(継承元 Control)
NamingContainer

同じ ID プロパティ値を持つ複数のサーバー コントロールを区別するための一意の名前空間を作成する、サーバー コントロールの名前付けコンテナーへの参照を取得します。

(継承元 Control)
Page

サーバー コントロールを含んでいる Page インスタンスへの参照を取得します。

(継承元 Control)
Parent

ページ コントロールの階層構造における、サーバー コントロールの親コントロールへの参照を取得します。

(継承元 Control)
ProfileService

現在の ScriptManager インスタンスに関連付けられている ProfileServiceManager オブジェクトを取得します。

RenderingCompatibility

レンダリングされる HTML と互換性がある ASP.NET のバージョンを表す値を取得します。

(継承元 Control)
RoleService

現在の ScriptManager インスタンスに関連付けられている RoleServiceManager オブジェクトを取得します。

ScriptMode

クライアント スクリプト ライブラリのデバッグ バージョンまたはリリース バージョンがレンダリングされるかどうかを示す値を取得または設定します。

ScriptPath
古い.

ASP.NET AJAX およびカスタム スクリプト ファイルへのパスを作成するために使用される場所のルート パスを取得または設定します。

ScriptResourceMapping

ScriptResourceMapping オブジェクトを取得します。

Scripts

クライアントにレンダリングされるスクリプト ファイルをそれぞれ表す ScriptReference オブジェクトが格納された ScriptReferenceCollection オブジェクトを取得します。

Services

ASP.NET が AJAX 機能用にクライアントに公開している各 Web サービスに対応する ServiceReference オブジェクトが格納されている ServiceReferenceCollection オブジェクトを取得します。

Site

デザイン サーフェイスに現在のコントロールを表示するときに、このコントロールをホストするコンテナーに関する情報を取得します。

(継承元 Control)
SkinID

コントロールに適用するスキンを取得または設定します。

(継承元 Control)
SupportsPartialRendering

クライアントが部分ページ レンダリングをサポートしているかどうかを示す値を取得します。

TemplateControl

このコントロールを格納しているテンプレートへの参照を取得または設定します。

(継承元 Control)
TemplateSourceDirectory

現在のサーバー コントロールを格納している Page または UserControl の仮想ディレクトリを取得します。

(継承元 Control)
UniqueID

階層構造で修飾されたサーバー コントロールの一意の ID を取得します。

(継承元 Control)
ValidateRequestMode

ブラウザーからのクライアント入力の安全性をコントロールで調べるかどうかを示す値を取得または設定します。

(継承元 Control)
ViewState

同一のページに対する複数の要求にわたって、サーバー コントロールのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。

(継承元 Control)
ViewStateIgnoresCase

StateBag オブジェクトが大文字小文字を区別しないかどうかを示す値を取得します。

(継承元 Control)
ViewStateMode

このコントロールのビューステート モードを取得または設定します。

(継承元 Control)
Visible

基本 Control クラスから継承される Visible プロパティをオーバーライドして、この値が設定されないようにします。

メソッド

AddedControl(Control, Int32)

子コントロールが Control オブジェクトの Controls コレクションに追加された後に呼び出されます。

(継承元 Control)
AddHistoryPoint(NameValueCollection, String)

指定した状態データ コレクションおよび状態タイトルを使用して、履歴ポイントを作成し、ブラウザーの履歴スタックに追加します。

AddHistoryPoint(String, String)

指定した状態キーおよび状態値を使用して、履歴ポイントを作成し、ブラウザーの履歴スタックに追加します。

AddHistoryPoint(String, String, String)

指定した状態キー、状態値、および状態タイトルを使用して、履歴ポイントを作成し、ブラウザーの履歴スタックに追加します。

AddParsedSubObject(Object)

XML または HTML のいずれかの要素が解析されたことをサーバー コントロールに通知し、サーバー コントロールの ControlCollection オブジェクトに要素を追加します。

(継承元 Control)
ApplyStyleSheetSkin(Page)

ページのスタイル シートに定義されたスタイル プロパティをコントロールに適用します。

(継承元 Control)
BeginRenderTracing(TextWriter, Object)

レンダリング データのデザイン時のトレースを開始します。

(継承元 Control)
BuildProfileTree(String, Boolean)

ページのトレースが有効な場合、サーバー コントロールに関する情報を収集し、これを表示するために Trace プロパティに渡します。

(継承元 Control)
ClearCachedClientID()

キャッシュされた ClientID 値を null に設定します。

(継承元 Control)
ClearChildControlState()

サーバー コントロールのすべての子コントロールについて、コントロールの状態情報を削除します。

(継承元 Control)
ClearChildState()

サーバー コントロールのすべての子コントロールのビューステート情報およびコントロールの状態情報を削除します。

(継承元 Control)
ClearChildViewState()

サーバー コントロールのすべての子コントロールのビューステート情報を削除します。

(継承元 Control)
ClearEffectiveClientIDMode()

現在のコントロール インスタンスおよびすべての子コントロールの ClientIDMode プロパティを Inherit に設定します。

(継承元 Control)
CreateChildControls()

ASP.NET ページ フレームワークによって呼び出され、ポストバックまたはレンダリングの準備として、合成ベースの実装を使うサーバー コントロールに対し、それらのコントロールに含まれる子コントロールを作成するように通知します。

(継承元 Control)
CreateControlCollection()

サーバー コントロールの子コントロール (リテラルとサーバーの両方) を保持する新しい ControlCollection オブジェクトを作成します。

(継承元 Control)
DataBind()

呼び出されたサーバー コントロールとそのすべての子コントロールにデータ ソースをバインドします。

(継承元 Control)
DataBind(Boolean)

DataBinding イベントを発生させるオプションを指定して、呼び出されたサーバー コントロールとそのすべての子コントロールにデータ ソースをバインドします。

(継承元 Control)
DataBindChildren()

データ ソースをサーバー コントロールの子コントロールにバインドします。

(継承元 Control)
Dispose()

サーバー コントロールが、メモリから解放される前に最終的なクリーンアップを実行できるようにします。

(継承元 Control)
EndRenderTracing(TextWriter, Object)

レンダリング データのデザイン時のトレースを終了します。

(継承元 Control)
EnsureChildControls()

サーバー コントロールに子コントロールが含まれているかどうかを確認します。 含まれていない場合、子コントロールを作成します。

(継承元 Control)
EnsureID()

ID が割り当てられていないコントロールの ID を作成します。

(継承元 Control)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
FindControl(String)

指定した id パラメーターを使用して、サーバー コントロールの現在の名前付けコンテナーを検索します。

(継承元 Control)
FindControl(String, Int32)

指定した id および検索に役立つ pathOffset パラメーターに指定された整数を使用して、サーバー コントロールの現在の名前付けコンテナーを検索します。 この形式の FindControl メソッドはオーバーライドしないでください。

(継承元 Control)
Focus()

コントロールに入力フォーカスを設定します。

(継承元 Control)
GetCurrent(Page)

指定された Page オブジェクトの ScriptManager インスタンスを取得します。

GetDesignModeState()

コントロールのデザイン時データを取得します。

(継承元 Control)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetRegisteredArrayDeclarations()

Page オブジェクトに既に登録済みの ECMAScript (JavaScript) 配列宣言の読み取り専用のコレクションを取得します。

GetRegisteredClientScriptBlocks()

ScriptManager コントロールに既に登録済みのクライアント スクリプト ブロックの読み取り専用のコレクションを取得します。

GetRegisteredDisposeScripts()

Page オブジェクトに既に登録済みの dispose スクリプトの読み取り専用のコレクションを取得します。

GetRegisteredExpandoAttributes()

Page オブジェクトに既に登録済みのカスタム (expando) 属性の読み取り専用のコレクションを取得します。

GetRegisteredHiddenFields()

Page オブジェクトに既に登録済みの隠しフィールドの読み取り専用のコレクションを取得します。

GetRegisteredOnSubmitStatements()

Page オブジェクトに既に登録済みの onsubmit ステートメントの読み取り専用のコレクションを取得します。

GetRegisteredStartupScripts()

Page オブジェクトに既に登録済みの起動スクリプトの読み取り専用のコレクションを取得します。

GetRouteUrl(Object)

ルート パラメーターのセットに対応する URL を取得します。

(継承元 Control)
GetRouteUrl(RouteValueDictionary)

ルート パラメーターのセットに対応する URL を取得します。

(継承元 Control)
GetRouteUrl(String, Object)

ルート パラメーターのセットおよびルート名に対応する URL を取得します。

(継承元 Control)
GetRouteUrl(String, RouteValueDictionary)

ルート パラメーターのセットおよびルート名に対応する URL を取得します。

(継承元 Control)
GetStateString()

Web ページの状態を表すキーと値のペアが含まれる文字列を取得します。

GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
GetUniqueIDRelativeTo(Control)

指定されたコントロールの UniqueID プロパティのプレフィックス部分を返します。

(継承元 Control)
HasControls()

サーバー コントロールに子コントロールが含まれているかどうかを確認します。

(継承元 Control)
HasEvents()

コントロールまたは子コントロールに対してイベントが登録されているかどうかを示す値を返します。

(継承元 Control)
IsLiteralContent()

サーバー コントロールがリテラルな内容だけを保持しているかどうかを決定します。

(継承元 Control)
LoadControlState(Object)

SaveControlState() メソッドによって保存された前回のページ要求からコントロールの状態情報を復元します。

(継承元 Control)
LoadPostData(String, NameValueCollection)

ブラウザーからサーバーへポストされたフォーム データを読み取り、非同期ポストバックのソースを判断します。

LoadViewState(Object)

SaveViewState() メソッドによって保存された前回のページ要求からビューステート情報を復元します。

(継承元 Control)
MapPathSecure(String)

仮想パス (絶対パスまたは相対パス) の割り当て先の物理パスを取得します。

(継承元 Control)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)

AsyncPostBackError イベントを発生させます。

OnBubbleEvent(Object, EventArgs)

サーバー コントロールのイベントをページの UI サーバー コントロールの階層構造に渡すかどうかを決定します。

(継承元 Control)
OnDataBinding(EventArgs)

DataBinding イベントを発生させます。

(継承元 Control)
OnInit(EventArgs)

Init イベントを発生させ、ページ上に 1 つの ScriptManager コントロールのみ存在することを確認します。

OnLoad(EventArgs)

Load イベントを発生させます。

(継承元 Control)
OnPreRender(EventArgs)

PreRender イベントを発生させ、部分ページ更新用のスクリプト ファイルおよびサービスを登録します。

OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)

ResolveCompositeScriptReference イベントを発生させます。

OnResolveScriptReference(ScriptReferenceEventArgs)

ScriptManager コントロールによって管理される各スクリプト参照に対して ResolveScriptReference イベントを発生させます。

OnUnload(EventArgs)

Unload イベントを発生させます。

(継承元 Control)
OpenFile(String)

ファイルの読み込みで使用される Stream を取得します。

(継承元 Control)
RaiseBubbleEvent(Object, EventArgs)

イベントのソースおよびその情報をコントロールの親に割り当てます。

(継承元 Control)
RaisePostBackEvent(String)

ScriptManager コントロールによって発生させられたポストバック イベントを処理し、Web ページの履歴状態を読み込みます。

RaisePostDataChangedEvent()

サーバーへのポストバック時に、ScriptManager コントロールのイベントを発生させます。

RegisterArrayDeclaration(Control, String, String)

UpdatePanel コントロール内のコントロールで使用できるように ECMAScript (JavaScript) 配列宣言を ScriptManager コントロールに登録し、配列をページに追加します。

RegisterArrayDeclaration(Page, String, String)

UpdatePanel コントロール内のコントロールで使用できるように ECMAScript (JavaScript) 配列宣言を ScriptManager コントロールに登録し、配列をページに追加します。

RegisterAsyncPostBackControl(Control)

コントロールを非同期ポストバックのトリガーとして登録します。

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

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

RegisterClientScriptBlock(Page, Type, String, String, Boolean)

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

RegisterClientScriptInclude(Control, Type, String, String)

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

RegisterClientScriptInclude(Page, Type, String, String)

非同期ポストバックが発生するたびにクライアント スクリプトを ScriptManager コントロールに登録し、スクリプト ファイルの参照をページに追加します。

RegisterClientScriptResource(Control, Type, String)

部分ページ レンダリングに関係するコントロールで使用できるように、アセンブリに埋め込まれているクライアント スクリプトを ScriptManager コントロールに登録します。

RegisterClientScriptResource(Page, Type, String)

ポストバックが発生するたびに、アセンブリに埋め込まれているクライアント スクリプト ファイルを ScriptManager コントロールに登録します。

RegisterDataItem(Control, String)

部分ページ レンダリング中にカスタム データをコントロールに送信します。

RegisterDataItem(Control, String, Boolean)

部分ページ レンダリング中にカスタム データをコントロールに送信し、データが JSON (JavaScript Object Notation) 形式かどうかを指定します。

RegisterDispose(Control, String)

UpdatePanel コントロール内にあるコントロールに対して dispose スクリプトを登録します。 このスクリプトは、UpdatePanel コントロールが更新または削除されるときに実行されます。

RegisterExpandoAttribute(Control, String, String, String, Boolean)

指定されたコントロールのカスタム (expando) 属性として名前/値ペアを ScriptManager コントロールに登録します。

RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)

現在の ScriptManager インスタンスにエクステンダー コントロールを登録します。

RegisterHiddenField(Control, String, String)

UpdatePanel コントロール内のコントロールについて、隠しフィールドを ScriptManager コントロールに登録します。

RegisterHiddenField(Page, String, String)

非同期ポストバックのたびに、隠しフィールドを ScriptManager コントロールに登録します。

RegisterNamedClientScriptResource(Control, String)

部分ページ レンダリングに関係するコントロールで使用できるように、アセンブリに埋め込まれているクライアント スクリプトを、リソース名で ScriptManager コントロールに登録します。

RegisterNamedClientScriptResource(Page, String)

部分ページ レンダリングに関係するコントロールで使用できるように、アセンブリに埋め込まれているクライアント スクリプトを、リソース名で ScriptManager コントロールに登録します。

RegisterOnSubmitStatement(Control, Type, String, String)

フォームが送信されるときに実行される UpdatePanel コントロールと連携するコントロールについて、ECMAScript (JavaScript) コードを ScriptManager コントロールに登録します。

RegisterOnSubmitStatement(Page, Type, String, String)

フォームが送信されるときに実行される UpdatePanel コントロールと連携するコントロールについて、ECMAScript (JavaScript) コードを ScriptManager コントロールに登録します。

RegisterPostBackControl(Control)

コントロールをポストバックのトリガーとして登録します。 このメソッドは、本来は非同期ポストバックを実行する UpdatePanel コントロール内のポストバック コントロールを構成するために使用されます。

RegisterScriptControl<TScriptControl>(TScriptControl)

現在の ScriptManager インスタンスにスクリプト コントロールを登録します。

RegisterScriptDescriptors(IExtenderControl)

ExtenderControl クラスにコールバックして、クライアントのコントロール、コンポーネント、または動作を表すクライアント オブジェクトをサポートするためにレンダリングする必要があるインスタンス スクリプトを返します。

RegisterScriptDescriptors(IScriptControl)

ScriptControl クラスを呼び出して、クライアントのコントロール、コンポーネント、または動作を表すクライアント オブジェクトをサポートするためにレンダリングする必要があるインスタンス スクリプトを返します。

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

ScriptManager コントロールを使用して UpdatePanel 内のコントロールの起動スクリプト ブロックを登録し、スクリプト ブロックをページに追加します。

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

非同期ポストバックのたびに起動スクリプト ブロックを ScriptManager コントロールに登録し、スクリプト ブロックをページに追加します。

RemovedControl(Control)

Control オブジェクトの Controls コレクションから子コントロールが削除された後に呼び出されます。

(継承元 Control)
Render(HtmlTextWriter)

指定された HtmlTextWriter オブジェクトを使用して、ブラウザーに ScriptManager コントロールのコンテンツをレンダリングします。

RenderChildren(HtmlTextWriter)

提供された HtmlTextWriter オブジェクトに対してサーバー コントロールの子のコンテンツを出力すると、クライアントで表示されるコンテンツが記述されます。

(継承元 Control)
RenderControl(HtmlTextWriter)

指定の HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を保存します。

(継承元 Control)
RenderControl(HtmlTextWriter, ControlAdapter)

指定した ControlAdapter オブジェクトを使用して、指定した HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力します。

(継承元 Control)
ResolveAdapter()

指定したコントロールを表示するコントロール アダプターを取得します。

(継承元 Control)
ResolveClientUrl(String)

ブラウザーで使用できる URL を取得します。

(継承元 Control)
ResolveUrl(String)

要求側クライアントで使用できる URL に変換します。

(継承元 Control)
SaveControlState()

ページがサーバーにポスト バックされた時間以降に発生したすべてのサーバー コントロール状態の変化を保存します。

(継承元 Control)
SaveViewState()

ページがサーバーにポスト バックされた時間以降に発生した、サーバー コントロールのビューステートの変更を保存します。

(継承元 Control)
SetDesignModeState(IDictionary)

コントロールのデザイン時データを設定します。

(継承元 Control)
SetFocus(Control)

ブラウザーのフォーカスを、指定したコントロールに設定します。

SetFocus(String)

ブラウザーのフォーカスを、ID で指定されるコントロールに設定します。

SetRenderMethodDelegate(RenderMethod)

サーバー コントロールとその内容を親コントロールに表示するイベント ハンドラー デリゲートを割り当てます。

(継承元 Control)
SetTraceData(Object, Object)

トレース データ キーとトレース データ値を使用して、レンダリング データのデザイン時トレースのトレース データを設定します。

(継承元 Control)
SetTraceData(Object, Object, Object)

トレースされたオブジェクト、トレース データ キー、およびトレース データ値を使用して、レンダリング データのデザイン時トレースのトレース データを設定します。

(継承元 Control)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
TrackViewState()

サーバー コントロールにビューステートの変更を追跡させ、サーバー コントロールの StateBag オブジェクトに変更を格納できるようにします。 このオブジェクトは、ViewState プロパティによってアクセスできます。

(継承元 Control)

イベント

AsyncPostBackError

非同期ポストバックの実行中にページ エラーが発生すると発生します。

DataBinding

サーバー コントロールがデータ ソースに連結すると発生します。

(継承元 Control)
Disposed

サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。

(継承元 Control)
Init

サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。

(継承元 Control)
Load

サーバー コントロールが Page オブジェクトに読み込まれると発生します。

(継承元 Control)
Navigate

ユーザーがブラウザーの [戻る] ボタンまたは [進む] ボタンをクリックしたときに発生します。

PreRender

Control オブジェクトの読み込み後、表示を開始する前に発生します。

(継承元 Control)
ResolveCompositeScriptReference

複合スクリプトが ScriptManager コントロールに登録されるときに発生します。

ResolveScriptReference

Scripts コレクションのメンバーが ScriptManager コントロールに登録されるときに発生します。

Unload

サーバー コントロールがメモリからアンロードされると発生します。

(継承元 Control)

明示的なインターフェイスの実装

IControlBuilderAccessor.ControlBuilder

このメンバーの詳細については、「ControlBuilder」をご覧ください。

(継承元 Control)
IControlDesignerAccessor.GetDesignModeState()

このメンバーの詳細については、「GetDesignModeState()」をご覧ください。

(継承元 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

このメンバーの詳細については、「SetDesignModeState(IDictionary)」をご覧ください。

(継承元 Control)
IControlDesignerAccessor.SetOwnerControl(Control)

このメンバーの詳細については、「SetOwnerControl(Control)」をご覧ください。

(継承元 Control)
IControlDesignerAccessor.UserData

このメンバーの詳細については、「UserData」をご覧ください。

(継承元 Control)
IDataBindingsAccessor.DataBindings

このメンバーの詳細については、「DataBindings」をご覧ください。

(継承元 Control)
IDataBindingsAccessor.HasDataBindings

このメンバーの詳細については、「HasDataBindings」をご覧ください。

(継承元 Control)
IExpressionsAccessor.Expressions

このメンバーの詳細については、「Expressions」をご覧ください。

(継承元 Control)
IExpressionsAccessor.HasExpressions

このメンバーの詳細については、「HasExpressions」をご覧ください。

(継承元 Control)
IParserAccessor.AddParsedSubObject(Object)

このメンバーの詳細については、「AddParsedSubObject(Object)」をご覧ください。

(継承元 Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

このメンバーの詳細については、「LoadPostData(String, NameValueCollection)」をご覧ください。

IPostBackDataHandler.RaisePostDataChangedEvent()

このメンバーの詳細については、「RaisePostDataChangedEvent()」をご覧ください。

IPostBackEventHandler.RaisePostBackEvent(String)

ScriptManager コントロールでポストバック イベントの処理と Web ページの履歴状態の読み込みができるようにします。

拡張メソッド

FindDataSourceControl(Control)

指定されたコントロールのデータ コントロールに関連付けられているデータ ソースを返します。

FindFieldTemplate(Control, String)

指定されたコントロールの名前付けコンテナー内にある、指定された列のフィールド テンプレートを返します。

FindMetaTable(Control)

格納しているデータ コントロールのメタテーブル オブジェクトを返します。

適用対象

こちらもご覧ください