ScriptManager Třída

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.Extensions.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Spravuje ASP.NET knihovny skriptů Ajax a soubory skriptů, vykreslování částečných stránek a generování tříd proxy klientů pro webové a aplikační služby.

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

Dědičnost: Object

Control
ScriptManager

Atributy: ToolboxBitmapAttribute

Implementuje: IPostBackDataHandler IPostBackEventHandler

Příklady

Následující příklady ukazují různé scénáře použití ScriptManager ovládacího prvku.

Povolení aktualizací Partial-Page

Následující příklad ukazuje, jak pomocí ScriptManager ovládacího prvku povolit částečné aktualizace stránky. V tomto příkladu Calendar DropDownList jsou ovládací prvek a uvnitř UpdatePanel ovládacího prvku. Ve výchozím nastavení je hodnota UpdateMode vlastnosti a hodnota ChildrenAsTriggers vlastnosti je true.Always Proto podřízené ovládací prvky panelu způsobit asynchronní postback.


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

Zpracování chyb aktualizace Partial-Page a registrace skriptu

Následující příklad ukazuje, jak zajistit vlastní zpracování chyb během částečné aktualizace stránky. Pokud při částečné aktualizaci stránky dojde k chybě, ve výchozím nastavení se zobrazí okno se zprávou JavaScriptu. Tento příklad ukazuje, jak použít vlastní zpracování chyb poskytnutím obslužné rutiny AsyncPostBackError události a nastavením AsyncPostBackErrorMessage vlastnosti v obslužné rutině události. Můžete také nastavit AllowCustomErrorsRedirect vlastnost a určit, jak se bude používat část vlastních chyb souboru Web.config, když dojde k chybě během částečné aktualizace stránky. V tomto příkladu se používá výchozí hodnota AllowCustomErrorsRedirect vlastnosti . To znamená, že pokud Web.config soubor obsahuje element customErrors , určuje tento prvek způsob zobrazení chyb. Další informace najdete v tématu customErrors – element (ASP.NET schéma nastavení).

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

Globalizace data a času zobrazeného v prohlížeči

Následující příklad ukazuje, jak nastavit EnableScriptGlobalization vlastnost tak, aby klientský skript mohl zobrazit datum a čas specifické pro jazykovou verzi v prohlížeči. V příkladu Culture je atribut direktivy @ Page nastavený na autohodnotu . V důsledku toho první jazyk zadaný v aktuálním nastavení prohlížeče určuje jazykovou verzi a jazykovou verzi uživatelského rozhraní pro stránku. Další informace najdete v tématu Postupy: Nastavení jazykové verze a jazykové verze uživatelského rozhraní pro ASP.NET globalizaci webové stránky.

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

Poznámky

V tomto tématu:

Úvod
Vykreslování části stránky
Používání ovládacího prvku ScriptManager s hlavními stránkami, uživatelskými ovládacími prvky a ostatními podřízenými komponentami
Správa a registrace skriptu
Odkazy na webové služby
Lokalizace
Zpracování chyb
Deklarativní syntaxe

Úvod

Ovládací ScriptManager prvek je ústředním ovládacího prvku pro funkce Ajax v ASP.NET. Ovládací prvek spravuje všechny ASP.NET prostředky Ajax na stránce. To zahrnuje stahování skriptů Microsoft Ajax Library do prohlížeče a koordinaci aktualizací částečných stránek, které jsou povoleny pomocí UpdatePanel ovládacích prvků. Ovládací prvek navíc ScriptManager umožňuje provádět následující akce:

Zaregistrujte skript, který je kompatibilní s aktualizacemi částečných stránek. Aby bylo možné spravovat závislosti mezi skriptem a základní knihovnou, všechny skripty, které zaregistrujete, se načtou po skriptu knihovny Microsoft Ajax Library.
Určete, jestli se do prohlížeče odesílají skripty verze nebo ladění.
Poskytněte přístup k metodám webové služby ze skriptu registrací webových služeb v ovládacím ScriptManager prvku .
Poskytnutí přístupu k ASP.NET aplikačním službám ověřování, rolí a profilů z klientského skriptu registrací těchto služeb v ovládacím ScriptManager prvku.
Povolte v prohlížeči zobrazení funkcí ECMAScript (JavaScript) Date, Number a String specifické pro jazykovou verzi.
Přístup k lokalizačním prostředkům pro soubory vložených skriptů nebo k souborům samostatných skriptů ScriptReference pomocí ResourceUICultures vlastnosti ovládacího prvku.
Zaregistrovat ovládací prvky serveru, které implementují IExtenderControl rozhraní nebo IScriptControl s ScriptManager ovládacím prvku tak, aby se vykresloval skript vyžadovaný klientskými součástmi a chováním.

Vykreslování části stránky

Schopnost ASP.NET stránky podporovat vykreslování částečných stránek se řídí následujícími faktory:

Vlastnost ScriptManager ovládacího prvku EnablePartialRendering musí být true (výchozí hodnota).
Na stránce musí být alespoň jeden UpdatePanel ovládací prvek.
Vlastnost SupportsPartialRendering musí být true (výchozí hodnota). SupportsPartialRendering Pokud vlastnost není explicitně nastavena, její hodnota je založena na možnostech prohlížeče.

Hodnotu EnablePartialRendering vlastnosti můžete přepsat v době běhu během nebo před událostí stránky Init . Pokud se pokusíte změnit tuto vlastnost poté, co Init došlo k události stránky, InvalidOperationException vyvolá se výjimka.

Pokud je podporováno vykreslování částečné stránky, ScriptManager ovládací prvek vykreslí skript pro povolení asynchronního zpětného odeslání a částečné aktualizace stránky. Oblasti stránky, která se má aktualizovat, jsou určeny pomocí UpdatePanel ovládacích prvků. Ovládací ScriptManager prvek zpracovává asynchronní zpětná vazba a aktualizuje pouze oblasti stránky, které je třeba aktualizovat. Další informace o vykreslování částečných stránek najdete v tématu Přehled vykreslování částečné stránky. Další informace o podmínkách, které způsobují aktualizaci, naleznete v tématu UpdatePanel Přehled ovládacího prvku.

Používání ovládacího prvku ScriptManager s hlavními stránkami, uživatelskými ovládacími prvky a ostatními podřízenými komponentami

Stránka může obsahovat pouze jeden ScriptManager ovládací prvek ve své hierarchii. Pokud chcete zaregistrovat služby a skripty pro vnořené stránky, uživatelské ovládací prvky nebo komponenty, pokud nadřazená stránka už ovládací prvek má ScriptManager , použijte tento ScriptManagerProxy ovládací prvek. Další informace najdete v tématu Použití ovládacího prvku UpdatePanel se stránkami předlohy.

Správa a registrace skriptu

Ovládací ScriptManager prvek umožňuje zaregistrovat skript, který se pak vykreslí jako součást stránky. Metody ScriptManager registrace ovládacích prvků lze rozdělit do následujících tří kategorií:

Metody registrace, které zaručují zachování závislostí skriptů na knihovně Microsoft Ajax Library.
Metody registrace, které nejsou závislé na knihovně Microsoft Ajax Library, ale jsou kompatibilní s ovládacími UpdatePanel prvky.
Metody registrace, které podporují práci s ovládacími UpdatePanel prvky.

Další informace o vytváření a používání skriptu Ajax v ASP.NET naleznete v tématu Vytvoření vlastního klientského skriptu pomocí knihovny Microsoft Ajax Library.

Registrace skriptu, který je závislý na knihovně Microsoft Ajax Library

Následující metody můžete použít k registraci souborů skriptu způsobem, který zaručuje zachování všech závislostí na knihovně Microsoft Ajax Library.

Metoda	Definice
RegisterScriptControl	Zaregistruje ovládací prvek serveru, který implementuje IScriptControl rozhraní, které se používá k definování objektu klienta Sys.Component . Ovládací ScriptManager prvek vykreslí skript, který podporuje objekt klienta.
RegisterExtenderControl	Zaregistruje ovládací prvek serveru, který implementuje IExtenderControl rozhraní, které se používá k definování objektu klienta Sys.Component . Ovládací ScriptManager prvek vykreslí skript, který podporuje objekt klienta.

Registrace skriptů kompatibilních s částečnou aktualizací stránky

Následující metody můžete použít k registraci souborů skriptů, které nejsou závislé na knihovně Microsoft Ajax Library, ale jsou kompatibilní s ovládacími UpdatePanel prvky. Tyto metody odpovídají podobným metodám ClientScriptManager ovládacího prvku. Pokud vykreslujete skript pro použití uvnitř UpdatePanel ovládacího prvku, ujistěte se, že voláte metody ScriptManager ovládacího prvku.

Metoda	Definice
RegisterArrayDeclaration	Přidá hodnotu do pole JavaScriptu. Pokud pole neexistuje, vytvoří se.
RegisterClientScriptBlock	Vykreslí `script` prvek za počáteční `<form>` značkou stránky. Skript je zadaný jako řetězcový parametr.
RegisterClientScriptInclude	Vykreslí `script` prvek za počáteční `<form>` značkou stránky. Obsah skriptu je určen nastavením atributu `src` na adresu URL, která odkazuje na soubor skriptu.
RegisterClientScriptResource	Vykreslí `script` prvek za počáteční `<form>` značkou stránky. Obsah skriptu je zadán s názvem prostředku v sestavení. Atribut `src` je automaticky naplněn adresou URL voláním obslužné rutiny HTTP, která načte pojmenovaný skript ze sestavení.
RegisterExpandoAttribute	Vykreslí vlastní dvojici atributu název/hodnota (expando) v kódu pro zadaný ovládací prvek.
RegisterHiddenField	Vykreslí skryté pole.
RegisterOnSubmitStatement	Zaregistruje skript, který se spustí v reakci na událost elementu `formsubmit` . Atribut `onSubmit` odkazuje na zadaný skript.
RegisterStartupScript	Vykreslí blok spouštěcího skriptu těsně před zavírací `</form>` značkou stránky. Skript pro vykreslení je zadaný jako řetězcový parametr.

Při registraci metod zadáte dvojici typ/klíč pro daný skript. Pokud je již skript se stejným typem a párem klíčů zaregistrovaný, nový skript se nezaregistruje. Podobně platí, že pokud zaregistrujete skript s již existující dvojicí typu a názvu prostředku, prvek, který odkazuje na prostředek, script se znovu nepřidá. Při registraci expando atributu dříve zaregistrovaného atributu je vyvolán výjimka. Duplicitní registrace hodnot pole je povolena.

Při volání RegisterClientScriptInclude metody nebo RegisterClientScriptResource se vyhněte registraci skriptu, který spouští vložené funkce. Místo toho zaregistrujte skript, který obsahuje definice funkcí, jako jsou obslužné rutiny událostí nebo definice vlastních tříd pro vaši aplikaci.

Metody registrace pro ovládací prvky UpdatePanel

Při použití UpdatePanel ovládacích prvků můžete použít následující metody k přizpůsobení aktualizací částečných stránek.

Metoda	Definice
RegisterAsyncPostBackControl	Zaregistruje ovládací prvek jako trigger pro asynchronní zpětné operace.
RegisterDataItem	Odesílá vlastní data ovládacím prvkům během vykreslování části stránky.
RegisterDispose	Zaregistruje skript dispose pro ovládací prvek, který je uvnitř UpdatePanel ovládacího prvku. Skript se spustí při UpdatePanel aktualizaci nebo odstranění ovládacího prvku. Metoda Dispose se používá pro klientské součásti, které jsou součástí knihovny Microsoft Ajax Library a které musí uvolnit prostředky, když komponenta již není používána.
RegisterPostBackControl	Zaregistruje ovládací prvek jako trigger pro úplné zpětné odeslání. Tato metoda se používá pro ovládací prvky uvnitř UpdatePanel ovládacího prvku, který by jinak prováděl asynchronní zpětné operace.

Odkazy na webové služby

Webovou službu, která se má volat z klientského skriptu, můžete zaregistrovat tak, že ServiceReference vytvoříte objekt a přidáte ho ScriptManager do Services kolekce ovládacího prvku. ASP.NET vygeneruje objekt proxy klienta pro každý ServiceReference objekt v kolekci Services . Do kolekce můžete programově přidat ServiceReference objekty Services pro registraci webových služeb za běhu.

Další informace o přístupu k webovým službám ve skriptu naleznete v tématech Vystavení webových služeb pro klientský skript v ASP.NET AJAX a Volání webových služeb z klientského skriptu v ASP.NET AJAX.

Lokalizace

Ovládací ScriptManager prvek generuje odkazy na vykreslené stránce, které odkazují na příslušné soubory lokalizovaných skriptů, což jsou buď soubory skriptů vložené do sestavení, nebo samostatné soubory skriptu.

EnableScriptLocalization Pokud je vlastnost nastavena na truehodnotu , ScriptManager ovládací prvek načte lokalizované prostředky (například lokalizované řetězce) pro aktuální jazykovou verzi, pokud existují. Ovládací ScriptManager prvek poskytuje následující funkce pro použití lokalizovaných prostředků:

Soubory skriptů, které jsou vloženy v sestavení. Ovládací ScriptManager prvek určuje, který soubor skriptu specifické pro jazykovou verzi nebo záložní jazykovou verzi se má odeslat do prohlížeče. Provádí to pomocí atributu sestavení specifického pro jazykovou NeutralResourcesLanguageAttribute verzi, prostředků zabalených se sestavením a jazykové verze uživatelského rozhraní prohlížeče (pokud existuje).
Soubory samostatných skriptů. Ovládací ScriptManager prvek definuje seznam jazykových verzí uživatelského rozhraní, které jsou podporovány pomocí ResourceUICultures vlastnosti objektu ScriptReference .
V režimu ladění. Ovládací ScriptManager prvek se pokusí vykreslit soubor skriptu specifické pro jazykovou verzi, který obsahuje informace o ladění. Pokud je například stránka v režimu ladění a aktuální jazyková verze je nastavena na en-MX, ovládací prvek vykreslí soubor skriptu, který má název, například scriptname.en-MX.debug.js, pokud soubor existuje. Pokud soubor neexistuje, vykreslí se ladicí soubor pro příslušnou záložní jazykovou verzi.

Další informace o tom, jak lokalizovat prostředky, najdete v tématu Lokalizace prostředků pro knihovny komponent – přehled.

Zpracování chyb

Pokud dojde k chybě stránky během asynchronního AsyncPostBackError postbacku, událost je vyvolána. Způsob, jakým se chyby na serveru odesílají klientovi, závisí na AllowCustomErrorsRedirect vlastnosti, AsyncPostBackErrorMessage vlastnosti a části vlastních chyb Web.config souboru. Další informace najdete v tématu Přizpůsobení zpracování chyb pro ovládací prvky UpdatePanel.

Deklarativní syntaxe

<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>

Konstruktory

ScriptManager()

Inicializuje novou instanci ScriptManager třídy .

Vlastnosti

Adapter	Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control)
AjaxFrameworkAssembly	Získá ajax rozhraní sestavení, které součásti na stránce použít.
AjaxFrameworkMode	Získá nebo nastaví hodnotu, která určuje, jak klientské skripty klientské knihovny Microsoft Ajax budou zahrnuty v klientovi.
AllowCustomErrorsRedirect	Získá nebo nastaví hodnotu, která určuje, zda vlastní chyby oddíl Web.config souboru je použit během chyby v asynchronní postback.
AppRelativeTemplateSourceDirectory	Získá nebo nastaví aplikace relativní virtuální adresář nebo UserControl objektuPage, který obsahuje tento ovládací prvek. (Zděděno od Control)
AsyncPostBackErrorMessage	Získá nebo nastaví chybovou zprávu, která je odeslána klientovi, když dojde k neošetřené výjimce serveru během asynchronní postback.
AsyncPostBackSourceElementID	Získá jedinečné ID ovládacího prvku, který způsobil asynchronní postback.
AsyncPostBackTimeout	Získá nebo nastaví hodnotu, která označuje čas v sekundách před vypršením časového limitu asynchronního zpětného odeslání, pokud není přijata žádná odpověď.
AuthenticationService	AuthenticationServiceManager Získá objekt, který je přidružen k aktuální ScriptManager instanci.
BindingContainer	Získá ovládací prvek, který obsahuje datové vazby tohoto ovládacího prvku. (Zděděno od Control)
ChildControlsCreated	Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClientID	Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET. (Zděděno od Control)
ClientIDMode	Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti. (Zděděno od Control)
ClientIDSeparator	Získá hodnotu znaku představující znak oddělovače použitý ve ClientID vlastnosti. (Zděděno od Control)
ClientNavigateHandler	Získá nebo nastaví název metody, která zpracovává Sys.Application.navigate událost v klientovi.
CompositeScript	Získá odkaz na složený skript, který podporuje webovou stránku.
Context	HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control)
Controls	ControlCollection Získá objekt, který představuje podřízené ovládací prvky pro zadaný server ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od Control)
DataItemContainer	Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer. (Zděděno od Control)
DataKeysContainer	Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl. (Zděděno od Control)
DesignMode	Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše. (Zděděno od Control)
EmptyPageUrl	Získá nebo nastaví adresu URL na prázdnou webovou stránku.
EnableCdn	Určuje, zda aktuální stránka načte odkazy na klientské skripty z cest CDN (Content Delivery Network).
EnableCdnFallback	Umožňuje načtení místní kopie skriptu v případě, že cdn (Content Delivery Network) není k dispozici.
EnableHistory	Získá nebo nastaví hodnotu, která označuje, zda webová stránka podporuje správu bodu historie.
EnablePageMethods	Získá nebo nastaví hodnotu, která označuje, zda veřejné statické metody stránky v ASP.NET stránku lze volat z klientského skriptu.
EnablePartialRendering	Získá nebo nastaví hodnotu, která umožňuje částečné vykreslování stránky, což zase umožňuje aktualizovat oblasti stránky jednotlivě pomocí UpdatePanel ovládacích prvků.
EnableScriptGlobalization	Získá nebo nastaví hodnotu, která označuje, zda ScriptManager ovládací prvek vykresluje skript, který podporuje parsování a formátování informací specifických pro jazykovou verzi.
EnableScriptLocalization	Získá nebo nastaví hodnotu, která označuje, zda ScriptManager ovládací prvek vykreslí lokalizované verze souborů skriptu.
EnableSecureHistoryState	Získá nebo nastaví hodnotu, která označuje, zda se má šifrovat řetězec stavu historie.
EnableTheming	Získá nebo nastaví hodnotu označující, zda motivy použít pro tento ovládací prvek. (Zděděno od Control)
EnableViewState	Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, pro žádajícího klienta. (Zděděno od Control)
Events	Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control)
HasChildViewState	Získá hodnotu označující, zda podřízené ovládací prvky aktuálního serveru mají uložené nastavení stavu zobrazení. (Zděděno od Control)
ID	Získá nebo nastaví programový identifikátor přiřazený k ovládacímu prvku serveru. (Zděděno od Control)
IdSeparator	Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control)
IsChildControlStateCleared	Získá hodnotu označující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav řízení. (Zděděno od Control)
IsDebuggingEnabled	Získá hodnotu, která označuje, zda ladicí verze knihoven klientských skriptů budou vykresleny.
IsInAsyncPostBack	Získá hodnotu, která označuje, zda aktuální postback je provedena v režimu částečného vykreslování.
IsNavigating	Získá hodnotu, která označuje, zda Navigate je událost právě zpracována.
IsTrackingViewState	Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení. (Zděděno od Control)
IsViewStateEnabled	Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control)
LoadScriptsBeforeUI	Získá nebo nastaví hodnotu, která označuje, zda jsou skripty načteny před nebo po načtení kódu uživatelského rozhraní stránky.
LoadViewStateByID	Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu ID zobrazení místo indexu. (Zděděno od Control)
NamingContainer	Získá odkaz na názvový kontejner ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro rozdíl mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control)
Page	Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control)
Parent	Získá odkaz na serverový ovládací prvek nadřazený ovládací prvek v hierarchii ovládacích prvků stránky. (Zděděno od Control)
ProfileService	ProfileServiceManager Získá objekt, který je přidružen k aktuální ScriptManager instanci.
RenderingCompatibility	Získá hodnotu, která určuje ASP.NET verze, která vykreslí HTML bude kompatibilní s. (Zděděno od Control)
RoleService	RoleServiceManager Získá objekt, který je přidružen k aktuální ScriptManager instanci.
ScriptMode	Získá nebo nastaví hodnotu, která určuje, zda jsou vykresleny ladicí nebo vydané verze knihoven klientských skriptů.
ScriptPath	Zastaralé. Získá nebo nastaví kořenovou cestu umístění, které se používá k sestavení cest k ASP.NET Ajax a soubory vlastních skriptů.
ScriptResourceMapping	ScriptResourceMapping Získá objekt.
Scripts	ScriptReferenceCollection Získá objekt, který obsahuje ScriptReference objekty, z nichž každý představuje soubor skriptu vykreslený klientovi.
Services	ServiceReferenceCollection Získá objekt, který obsahuje ServiceReference objekt pro každou webovou službu, která ASP.NET zveřejňuje na klientovi pro funkce Ajax.
Site	Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše. (Zděděno od Control)
SkinID	Získá nebo nastaví vzhled pro použití ovládacího prvku. (Zděděno od Control)
SupportsPartialRendering	Získá hodnotu, která označuje, zda klient podporuje vykreslování částečné stránky.
TemplateControl	Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control)
TemplateSourceDirectory	Získá virtuální adresář Page nebo UserControl , který obsahuje aktuální serverový ovládací prvek. (Zděděno od Control)
UniqueID	Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku. (Zděděno od Control)
ValidateRequestMode	Získá nebo nastaví hodnotu, která označuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení serverového ovládacího prvku napříč více požadavky na stejnou stránku. (Zděděno od Control)
ViewStateIgnoresCase	Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control)
ViewStateMode	Získá nebo nastaví režim zobrazení stavu tohoto ovládacího prvku. (Zděděno od Control)
Visible	Visible Přepíše vlastnost, která je zděděna ze základní Control třídy, aby se zabránilo nastavení této hodnoty.

Metody

AddedControl(Control, Int32)	Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control)
AddHistoryPoint(NameValueCollection, String)	Vytvoří bod historie a přidá ho do zásobníku historie prohlížeče pomocí zadaného názvu shromažďování dat stavu a stavu.
AddHistoryPoint(String, String)	Vytvoří bod historie a přidá ho do zásobníku historie prohlížeče pomocí zadaného klíče stavu a hodnoty stavu.
AddHistoryPoint(String, String, String)	Vytvoří bod historie a přidá ho do zásobníku historie prohlížeče pomocí zadaného klíče stavu, hodnoty stavu a názvu stavu.
AddParsedSubObject(Object)	Upozorní ovládací prvek serveru, že byl analyzován prvek XML nebo HTML, a přidá element do objektu ovládacího prvku ControlCollection serveru. (Zděděno od Control)
ApplyStyleSheetSkin(Page)	Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control)
BeginRenderTracing(TextWriter, Object)	Zahájí trasování vykreslování dat v době návrhu. (Zděděno od Control)
BuildProfileTree(String, Boolean)	Shromáždí informace o ovládacím prvku serveru a doručí je do Trace vlastnosti, která se má zobrazit, když je pro stránku povolené trasování. (Zděděno od Control)
ClearCachedClientID()	Nastaví hodnotu v ClientID mezipaměti na `null`. (Zděděno od Control)
ClearChildControlState()	Odstraní informace o stavu řízení pro podřízené ovládací prvky serveru. (Zděděno od Control)
ClearChildState()	Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control)
ClearChildViewState()	Odstraní informace o stavu zobrazení všech podřízených ovládacích prvků serveru. (Zděděno od Control)
ClearEffectiveClientIDMode()	ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control)
CreateChildControls()	Volá se rozhraním ASP.NET stránky, aby upozornily ovládací prvky serveru, které používají implementaci založenou na složení k vytvoření všech podřízených ovládacích prvků, které obsahují při přípravě na publikování zpět nebo vykreslování. (Zděděno od Control)
CreateControlCollection()	Vytvoří nový ControlCollection objekt, který bude obsahovat podřízené ovládací prvky (literál i server) serverového ovládacího prvku. (Zděděno od Control)
DataBind()	Vytvoří vazbu zdroje dat na vyvoláný serverový ovládací prvek a všechny jeho podřízené ovládací prvky. (Zděděno od Control)
DataBind(Boolean)	Vytvoří vazbu zdroje dat na vyvoláný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control)
DataBindChildren()	Sváže zdroj dat s podřízenými ovládacími prvky serverového ovládacího prvku. (Zděděno od Control)
Dispose()	Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control)
EndRenderTracing(TextWriter, Object)	Ukončí trasování vykreslovaných dat v době návrhu. (Zděděno od Control)
EnsureChildControls()	Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control)
EnsureID()	Vytvoří identifikátor ovládacích prvků, které nemají přiřazený identifikátor. (Zděděno od Control)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FindControl(String)	Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek pomocí zadaného `id` parametru. (Zděděno od Control)
FindControl(String, Int32)	Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným `id` a celočíselným číslem zadaným v parametru `pathOffset` , který pomáhá při hledání. Tuto verzi metody byste neměli FindControl přepsat. (Zděděno od Control)
Focus()	Nastaví fokus vstupu na ovládací prvek. (Zděděno od Control)
GetCurrent(Page)	ScriptManager Získá instanci pro daný Page objekt.
GetDesignModeState()	Získá data v době návrhu pro ovládací prvek. (Zděděno od Control)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetRegisteredArrayDeclarations()	Načte kolekci ECMAScript (JavaScript) deklarace pole jen pro čtení, které byly dříve registrovány s objektem Page .
GetRegisteredClientScriptBlocks()	Načte kolekci bloků klientských skriptů, které byly dříve zaregistrovány pomocí ovládacího prvku jen pro ScriptManager čtení.
GetRegisteredDisposeScripts()	Načte kolekci `dispose` skriptů jen pro čtení, které byly dříve zaregistrovány s objektem Page .
GetRegisteredExpandoAttributes()	Načte kolekci vlastních atributů (expando) jen pro čtení, které byly dříve zaregistrovány s objektem Page .
GetRegisteredHiddenFields()	Načte kolekci skrytých polí jen pro čtení, která byla dříve zaregistrována s objektem Page .
GetRegisteredOnSubmitStatements()	Načte kolekci `onsubmit` příkazů jen pro čtení, které byly dříve zaregistrovány s objektem Page .
GetRegisteredStartupScripts()	Načte kolekci spouštěcích skriptů jen pro čtení, které byly dříve zaregistrovány s objektem Page .
GetRouteUrl(Object)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(String, Object)	Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control)
GetRouteUrl(String, RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control)
GetStateString()	Načte řetězec, který obsahuje páry klíč/hodnota, které představují stav webové stránky.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
GetUniqueIDRelativeTo(Control)	Vrátí předponu vlastnosti UniqueID zadaného ovládacího prvku. (Zděděno od Control)
HasControls()	Určuje, jestli serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky. (Zděděno od Control)
HasEvents()	Vrátí hodnotu označující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control)
IsLiteralContent()	Určuje, jestli serverový ovládací prvek obsahuje pouze obsah literálu. (Zděděno od Control)
LoadControlState(Object)	Obnoví informace o stavu řízení z předchozího požadavku stránky, který byl uložen metodou SaveControlState() . (Zděděno od Control)
LoadPostData(String, NameValueCollection)	Čte data formuláře, která jsou odeslána z prohlížeče na server, a určuje zdroj asynchronního postbacku.
LoadViewState(Object)	Obnoví informace o stavu zobrazení z předchozí žádosti o stránku, která byla uložena metodou SaveViewState() . (Zděděno od Control)
MapPathSecure(String)	Načte fyzickou cestu, na kterou se mapuje virtuální cesta, absolutní nebo relativní. (Zděděno od Control)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)	AsyncPostBackError Vyvolá událost.
OnBubbleEvent(Object, EventArgs)	Určuje, zda je událost serverového ovládacího prvku předána hierarchii ovládacích prvků serveru uživatelského rozhraní stránky. (Zděděno od Control)
OnDataBinding(EventArgs)	DataBinding Vyvolá událost. (Zděděno od Control)
OnInit(EventArgs)	Init Vyvolá událost a zajistí, že na stránce existuje pouze jeden ScriptManager ovládací prvek.
OnLoad(EventArgs)	Load Vyvolá událost. (Zděděno od Control)
OnPreRender(EventArgs)	PreRender Vyvolá událost a zaregistruje soubory skriptů a služby pro částečné aktualizace stránky.
OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)	ResolveCompositeScriptReference Vyvolá událost.
OnResolveScriptReference(ScriptReferenceEventArgs)	ResolveScriptReference Vyvolá událost pro každý odkaz na skript, který je spravován ovládacím ScriptManager prvku.
OnUnload(EventArgs)	Unload Vyvolá událost. (Zděděno od Control)
OpenFile(String)	Stream Získá zvyk ke čtení souboru. (Zděděno od Control)
RaiseBubbleEvent(Object, EventArgs)	Přiřadí všechny zdroje události a její informace nadřazené ovládacímu prvku. (Zděděno od Control)
RaisePostBackEvent(String)	Zpracuje událost postback vyvolanou ovládacím ScriptManager prvek a načte stav historie webové stránky.
RaisePostDataChangedEvent()	Vyvolá události pro ScriptManager ovládací prvek při odeslání zpět na server.
RegisterArrayDeclaration(Control, String, String)	Zaregistruje deklaraci pole ECMAScript (JavaScript) s ovládacím ScriptManager prvku pro použití s ovládacím prvek, který je uvnitř UpdatePanel ovládacího prvku, a přidá pole na stránku.
RegisterArrayDeclaration(Page, String, String)	Zaregistruje deklaraci pole ECMAScript (JavaScript) s ovládacím ScriptManager prvku pro použití s ovládacím prvek, který je uvnitř UpdatePanel ovládacího prvku, a přidá pole na stránku.
RegisterAsyncPostBackControl(Control)	Zaregistruje ovládací prvek jako trigger pro asynchronní zpětné operace.
RegisterClientScriptBlock(Control, Type, String, String, Boolean)	Zaregistruje blok klientského skriptu s ovládacím ScriptManager prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a poté přidá blok skriptu na stránku.
RegisterClientScriptBlock(Page, Type, String, String, Boolean)	Zaregistruje blok klientského skriptu s ovládacím ScriptManager prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a poté přidá blok skriptu na stránku.
RegisterClientScriptInclude(Control, Type, String, String)	Zaregistruje soubor klientského skriptu s ovládacím ScriptManager prvku pro použití s ovládacím prvku, který je uvnitř UpdatePanel ovládacího prvku, a poté přidá odkaz na soubor skriptu na stránku.
RegisterClientScriptInclude(Page, Type, String, String)	Zaregistruje klientský skript s ovládacím ScriptManager prvku pokaždé, když dojde k asynchronnímu zpětnému odeslání, a poté přidá odkaz na soubor skriptu na stránku.
RegisterClientScriptResource(Control, Type, String)	Registruje klientský skript, který je vložen v sestavení s ovládacím ScriptManager prvku pro použití s ovládacím prvek, který se účastní vykreslování částečné stránky.
RegisterClientScriptResource(Page, Type, String)	Zaregistruje soubor klientského skriptu, který je vložen v sestavení s ovládacím ScriptManager prvku při každém výskytu zpětného odeslání.
RegisterDataItem(Control, String)	Odesílá vlastní data do ovládacího prvku během vykreslování části stránky.
RegisterDataItem(Control, String, Boolean)	Odesílá vlastní data do ovládacího prvku během vykreslování částečné stránky a určuje, jestli jsou data ve formátu JSON (JavaScript Object Notation).
RegisterDispose(Control, String)	Zaregistruje `dispose` skript pro ovládací prvek, který je uvnitř ovládacího UpdatePanel prvku. Skript se spustí při UpdatePanel aktualizaci nebo odstranění ovládacího prvku.
RegisterExpandoAttribute(Control, String, String, String, Boolean)	Zaregistruje dvojici název/hodnota s ovládacím ScriptManager prvku jako vlastní atribut (expando) zadaného ovládacího prvku.
RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)	Zaregistruje rozšiřující ovládací prvek s aktuální ScriptManager instancí.
RegisterHiddenField(Control, String, String)	Zaregistruje skryté pole s ovládacím ScriptManager prvku, který je uvnitř UpdatePanel ovládacího prvku.
RegisterHiddenField(Page, String, String)	Registruje skryté pole s ovládacím ScriptManager prvku během každého asynchronního postback.
RegisterNamedClientScriptResource(Control, String)	Registruje klientský skript podle názvu prostředku, který je vložen v sestavení s ovládacím ScriptManager prvku pro použití s ovládacím prvek, který se účastní vykreslování částečné stránky.
RegisterNamedClientScriptResource(Page, String)	Registruje klientský skript podle názvu prostředku, který je vložen v sestavení s ovládacím ScriptManager prvku pro použití s ovládacím prvek, který se účastní vykreslování částečné stránky.
RegisterOnSubmitStatement(Control, Type, String, String)	Registruje kód ECMAScript (JavaScript) s ovládacím ScriptManager prvku, který se používá s ovládacím UpdatePanel prvek, který se spustí při odeslání formuláře.
RegisterOnSubmitStatement(Page, Type, String, String)	Registruje kód ECMAScript (JavaScript) s ovládacím ScriptManager prvku, který se používá s ovládacím UpdatePanel prvek, který se spustí při odeslání formuláře.
RegisterPostBackControl(Control)	Zaregistruje ovládací prvek jako aktivační událost pro zpětné odeslání. Tato metoda se používá ke konfiguraci postback ovládacích prvků uvnitř UpdatePanel ovládacího prvku, který by jinak prováděl asynchronní postbacks.
RegisterScriptControl<TScriptControl>(TScriptControl)	Zaregistruje ovládací prvek skriptu s aktuální ScriptManager instancí.
RegisterScriptDescriptors(IExtenderControl)	Volá zpět do ExtenderControl třídy pro vrácení skriptů instance, které musí být vykresleny pro podporu objektu klienta, který představuje klientský ovládací prvek, součást nebo chování.
RegisterScriptDescriptors(IScriptControl)	ScriptControl Volá třídu pro vrácení skriptů instance, které musí být vykresleny pro podporu objektu klienta, který představuje klientský ovládací prvek, komponentu nebo chování.
RegisterStartupScript(Control, Type, String, String, Boolean)	Zaregistruje blok spouštěcího skriptu pro ovládací prvek, který je uvnitř objektu UpdatePanel pomocí ScriptManager ovládacího prvku, a přidá blok skriptu na stránku.
RegisterStartupScript(Page, Type, String, String, Boolean)	Zaregistruje blok spouštěcího skriptu pro každé asynchronní zpětné odeslání pomocí ScriptManager ovládacího prvku a přidá blok skriptu na stránku.
RemovedControl(Control)	Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control)
Render(HtmlTextWriter)	Vykreslí ScriptManager obsah ovládacího prvku do prohlížeče pomocí zadaného HtmlTextWriter objektu.
RenderChildren(HtmlTextWriter)	Vypíše obsah podřízených položek serverového ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control)
RenderControl(HtmlTextWriter)	Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povolené. (Zděděno od Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (Zděděno od Control)
ResolveAdapter()	Získá řídicí adaptér zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control)
ResolveClientUrl(String)	Získá adresu URL, kterou lze použít v prohlížeči. (Zděděno od Control)
ResolveUrl(String)	Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi. (Zděděno od Control)
SaveControlState()	Uloží všechny změny stavu ovládacího prvku serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Control)
SaveViewState()	Uloží všechny změny stavu zobrazení ovládacích prvků serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Control)
SetDesignModeState(IDictionary)	Nastaví data v době návrhu ovládacího prvku. (Zděděno od Control)
SetFocus(Control)	Nastaví fokus prohlížeče na zadaný ovládací prvek.
SetFocus(String)	Nastaví fokus prohlížeče na ovládací prvek určený pomocí ID.
SetRenderMethodDelegate(RenderMethod)	Přiřadí delegáta obslužné rutiny události, který vykresluje serverový ovládací prvek a jeho obsah do nadřazeného ovládacího prvku. (Zděděno od Control)
SetTraceData(Object, Object)	Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
SetTraceData(Object, Object, Object)	Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí trasovaného objektu, datového klíče trasování a hodnoty dat trasování. (Zděděno od Control)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrackViewState()	Způsobí sledování změn stavu zobrazení v ovládacím prvku serveru, aby mohly být uloženy v objektu ovládacího prvku StateBag serveru. Tento objekt je přístupný prostřednictvím ViewState vlastnosti . (Zděděno od Control)

Událost

AsyncPostBackError	Nastane, když dojde k chybě stránky během asynchronního postback.
DataBinding	Nastane, když ovládací prvek serveru vytvoří vazbu na zdroj dat. (Zděděno od Control)
Disposed	Nastane při uvolnění serverového ovládacího prvku z paměti, což je poslední fáze životního cyklu řízení serveru, když je požadována stránka ASP.NET. (Zděděno od Control)
Init	Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control)
Load	Nastane při načtení serverového ovládacího prvku do objektu Page . (Zděděno od Control)
Navigate	Vyvolá se, když uživatel klikne na tlačítko Zpět nebo Vpřed v prohlížeči.
PreRender	Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control)
ResolveCompositeScriptReference	Vyvolá se při registraci složeného skriptu v ovládacím ScriptManager prvku.
ResolveScriptReference	Vyvolá se při registraci člena Scripts kolekce pomocí ScriptManager ovládacího prvku .
Unload	Vyvolá se při uvolnění serverového ovládacího prvku z paměti. (Zděděno od Control)

Explicitní implementace rozhraní

IControlBuilderAccessor.ControlBuilder	Popis tohoto člena najdete v tématu ControlBuilder. (Zděděno od Control)
IControlDesignerAccessor.GetDesignModeState()	Popis tohoto člena najdete v tématu GetDesignModeState(). (Zděděno od Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Popis tohoto člena najdete v tématu SetDesignModeState(IDictionary). (Zděděno od Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Popis tohoto člena najdete v tématu SetOwnerControl(Control). (Zděděno od Control)
IControlDesignerAccessor.UserData	Popis tohoto člena najdete v tématu UserData. (Zděděno od Control)
IDataBindingsAccessor.DataBindings	Popis tohoto člena najdete v tématu DataBindings. (Zděděno od Control)
IDataBindingsAccessor.HasDataBindings	Popis tohoto člena najdete v tématu HasDataBindings. (Zděděno od Control)
IExpressionsAccessor.Expressions	Popis tohoto člena najdete v tématu Expressions. (Zděděno od Control)
IExpressionsAccessor.HasExpressions	Popis tohoto člena najdete v tématu HasExpressions. (Zděděno od Control)
IParserAccessor.AddParsedSubObject(Object)	Popis tohoto člena najdete v tématu AddParsedSubObject(Object). (Zděděno od Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Popis tohoto člena najdete v tématu LoadPostData(String, NameValueCollection).
IPostBackDataHandler.RaisePostDataChangedEvent()	Popis tohoto člena najdete v tématu RaisePostDataChangedEvent().
IPostBackEventHandler.RaisePostBackEvent(String)	Umožňuje ovládacímu ScriptManager prvku zpracovat událost postback a načíst stav historie webové stránky.

Metody rozšíření

FindDataSourceControl(Control)	Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek.
FindFieldTemplate(Control, String)	Vrátí šablonu pole pro zadaný sloupec v kontejneru názvů zadaného ovládacího prvku.
FindMetaTable(Control)	Vrátí objekt metatable pro ovládací prvek obsahující data.

Platí pro

Sdílet prostřednictvím