ScriptManager Klass

Definition

Namnområde:: System.Web.UI

Sammansättning:: System.Web.Extensions.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Hanterar ASP.NET Ajax-skriptbibliotek och skriptfiler, partiell sidåtergivning och klientproxyklassgenerering för webb- och programtjänster.

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

Arv: Object

Control
ScriptManager

Attribut: ToolboxBitmapAttribute

Implementeringar: IPostBackDataHandler IPostBackEventHandler

Exempel

I följande exempel visas olika scenarier för att använda ScriptManager kontrollen.

Aktivera Partial-Page uppdateringar

I följande exempel visas hur du använder ScriptManager kontrollen för att aktivera partiella siduppdateringar. I det här exemplet finns en Calendar och en DropDownList kontroll i en UpdatePanel kontroll. Som standard är värdet för UpdateMode egenskapen , och värdet för Always egenskapen är ChildrenAsTriggers.true Därför orsakar underordnade kontroller i panelen en asynkron 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>

Hantera Partial-Page uppdateringsfel och registrera skript

I följande exempel visas hur du tillhandahåller anpassad felhantering under partiella siduppdateringar. När ett fel inträffar under partiella siduppdateringar visas som standard en JavaScript-meddelanderuta. Det här exemplet visar hur du använder anpassad felhantering genom att tillhandahålla en hanterare för AsyncPostBackError händelsen och genom att ange AsyncPostBackErrorMessage egenskapen i händelsehanteraren. Du kan också ange AllowCustomErrorsRedirect egenskapen för att ange hur avsnittet med anpassade fel i Web.config-filen används när ett fel inträffar under partiella siduppdateringar. I det här exemplet används standardvärdet för AllowCustomErrorsRedirect egenskapen. Det innebär att om filen Web.config innehåller ett customErrors-element avgör det elementet hur fel visas. Mer information finns i elementet customErrors (ASP.NET Settings Schema).

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

Globalisera datum och tid som visas i webbläsaren

I följande exempel visas hur du anger EnableScriptGlobalization egenskapen så att klientskriptet kan visa ett kulturspecifikt datum och tid i webbläsaren. I exemplet Culture är attributet för @Page-direktivet inställt på auto. Därför avgör det första språk som anges i de aktuella webbläsarinställningarna kulturen och användargränssnittskulturen för sidan. Mer information finns i How to: Set the Culture and UI Culture for ASP.NET Web Page Globalization.

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

Kommentarer

I det här avsnittet:

Inledning
Partial-Page rendering
Använda ScriptManager-kontrollen med huvudsidor, användarkontroller och andra underordnade komponenter
Skripthantering och registrering
Webbtjänstreferenser
Lokalisering
Felhantering
Deklarativ syntax

Introduction

Kontrollen ScriptManager är central för Ajax-funktioner i ASP.NET. Kontrollen hanterar alla ASP.NET Ajax-resurser på en sida. Detta inkluderar nedladdning av Microsoft Ajax-biblioteksskript till webbläsaren och samordning av partiella siduppdateringar som är aktiverade med hjälp av kontrollerna UpdatePanel. Dessutom ScriptManager gör kontrollen att du kan göra följande:

Registrera skript som är kompatibelt med partiella siduppdateringar. För att hantera beroenden mellan skriptet och kärnbiblioteket läses alla skript som du registrerar in efter skriptet Microsoft Ajax-bibliotek.
Ange om versions- eller felsökningsskript ska skickas till webbläsaren.
Ge åtkomst till webbtjänstmetoder från skript genom att registrera webbtjänster med ScriptManager kontrollen.
Ge åtkomst till ASP.NET autentiserings-, roll- och profilprogramtjänster från klientskriptet genom att registrera dessa tjänster med kontrollen ScriptManager.
Aktivera kulturspecifik visning av funktionerna ECMAScript (JavaScript ),Number och String i webbläsaren.
Få åtkomst till lokaliseringsresurser för inbäddade skriptfiler eller för fristående skriptfiler med hjälp ResourceUICultures av kontrollens ScriptReference egenskap.
Registrera serverkontroller som implementerar IExtenderControl eller IScriptControl gränssnitt med ScriptManager kontrollen så att skript som krävs av klientkomponenter och beteenden återges.

Partial-Page rendering

Möjligheten för en ASP.NET sida att stödja delvis sidåtergivning styrs av följande faktorer:

Kontrollens ScriptManager EnablePartialRendering egenskap måste vara true (standardvärdet).
Det måste finnas minst en UpdatePanel kontroll på sidan.
Egenskapen SupportsPartialRendering måste vara true (standardvärdet). Om egenskapen SupportsPartialRendering inte anges explicit baseras dess värde på webbläsarfunktioner.

Du kan åsidosätta värdet för EnablePartialRendering egenskapen vid körning under eller före sidans Init händelse. Om du försöker ändra den här egenskapen när sidans Init händelse har inträffat utlöses ett InvalidOperationException undantag.

När delvis sidåtergivning stöds återger kontrollen skriptet ScriptManager för att aktivera asynkrona postbacks och partiella siduppdateringar. De regioner på sidan som ska uppdateras utses med hjälp UpdatePanel av kontroller. Kontrollen ScriptManager hanterar asynkrona postbacks och uppdaterar endast de regioner på sidan som måste uppdateras. Mer information om delvis sidåtergivning finns iPartial-Page renderingsöversikt. Mer information om de villkor som orsakar en uppdatering finns i Översikt över UpdatePanel-kontroll.

Använda ScriptManager-kontrollen med huvudsidor, användarkontroller och andra underordnade komponenter

En sida kan bara innehålla en ScriptManager kontroll i hierarkin. Om du vill registrera tjänster och skript för kapslade sidor, användarkontroller eller komponenter när den överordnade sidan redan har en ScriptManager kontroll använder du ScriptManagerProxy kontrollen. Mer information finns i Använda UpdatePanel-kontrollen med huvudsidor.

Skripthantering och registrering

Med ScriptManager kontrollen kan du registrera skript som sedan återges som en del av sidan. Kontrollregistreringsmetoderna ScriptManager kan delas in i följande tre kategorier:

Registreringsmetoder som garanterar att skriptberoenden på Microsoft Ajax-biblioteket underhålls.
Registreringsmetoder som inte är beroende av Microsoft Ajax-bibliotek, men som är kompatibla med UpdatePanel kontroller.
Registreringsmetoder som stöder arbete med UpdatePanel kontroller.

Mer information om hur du skapar och använder Ajax-skript i ASP.NET finns i Skapa anpassat klientskript med hjälp av Microsoft Ajax-bibliotek.

Registrera skript som är beroende av Microsoft Ajax-biblioteket

Du kan använda följande metoder för att registrera skriptfiler på ett sätt som garanterar att eventuella beroenden på Microsoft Ajax-biblioteket bevaras.

Metod	Definition
RegisterScriptControl	Registrerar en serverkontroll som implementerar gränssnittet IScriptControl som används för att definiera ett Sys.Component-klientobjekt . Kontrollen ScriptManager renderar skript som stöder klientobjektet.
RegisterExtenderControl	Registrerar en serverkontroll som implementerar gränssnittet IExtenderControl som används för att definiera ett Sys.Component-klientobjekt . Kontrollen ScriptManager renderar skript som stöder klientobjektet.

Registrera Partial-Page uppdatera kompatibla skript

Du kan använda följande metoder för att registrera skriptfiler som inte är beroende av Microsoft Ajax-biblioteket, men som är kompatibla med kontrollerna UpdatePanel. Dessa metoder motsvarar liknande metoder för ClientScriptManager kontrollen. Om du återger skript för användning i en UpdatePanel kontroll kontrollerar du att du anropar kontrollmetoderna ScriptManager .

Metod	Definition
RegisterArrayDeclaration	Lägger till ett värde i en JavaScript-matris. Om matrisen inte finns skapas den.
RegisterClientScriptBlock	Renderar ett `script` element efter sidans öppningstagg `<form>` . Skriptet anges som en strängparameter.
RegisterClientScriptInclude	Renderar ett `script` element efter sidans öppningstagg `<form>` . Skriptinnehållet anges genom att attributet anges `src` till en URL som pekar på en skriptfil.
RegisterClientScriptResource	Renderar ett `script` element efter sidans öppningstagg `<form>` . Skriptinnehållet anges med ett resursnamn i en sammansättning. Attributet `src` fylls automatiskt i med en URL av ett anrop till en HTTP-hanterare som hämtar det namngivna skriptet från sammansättningen.
RegisterExpandoAttribute	Renderar ett anpassat namn/värde-attributpar (en expando) i markeringen för en angiven kontroll.
RegisterHiddenField	Renderar ett dolt fält.
RegisterOnSubmitStatement	Registrerar ett skript som körs som svar på elementets `formsubmit` händelse. Attributet `onSubmit` refererar till det angivna skriptet.
RegisterStartupScript	Renderar ett startskriptblock precis före sidans avslutande `</form>` tagg. Skriptet som ska återges anges som en strängparameter.

När du registrerar metoder anger du ett typ-/nyckelpar för skriptet. Om ett skript med samma typ/nyckelpar redan har registrerats registreras inte ett nytt skript. Om du registrerar ett skript med ett typ-/resursnamnpar som redan finns läggs inte elementet script som refererar till resursen till igen. När du registrerar ett expando-attribut för ett tidigare registrerat attribut genereras ett undantag. Dubblettregistrering av matrisvärden tillåts.

När du anropar RegisterClientScriptInclude metoden eller RegisterClientScriptResource bör du undvika att registrera skript som kör infogade funktioner. Registrera i stället skript som innehåller funktionsdefinitioner som händelsehanterare eller anpassade klassdefinitioner för ditt program.

Registreringsmetoder för UpdatePanel-kontroller

Du kan använda följande metoder för att anpassa partiella siduppdateringar när du använder UpdatePanel kontroller.

Metod	Definition
RegisterAsyncPostBackControl	Registrerar en kontroll som en utlösare för asynkrona postbacks.
RegisterDataItem	Skickar anpassade data till kontroller under partiell återgivning av sidor.
RegisterDispose	Registrerar ett bortskaffningsskript för en kontroll som finns i en UpdatePanel kontroll. Skriptet körs när UpdatePanel kontrollen uppdateras eller tas bort. Metoden dispose används för klientkomponenter som ingår i Microsoft Ajax-biblioteket och som måste frigöra resurser när en komponent inte längre används.
RegisterPostBackControl	Registrerar en kontroll som en utlösare för en fullständig postback. Den här metoden används för kontroller i en UpdatePanel kontroll som annars skulle utföra asynkrona postbacks.

Webbtjänstreferenser

Du kan registrera en webbtjänst som ska anropas från klientskriptet genom att skapa ett ServiceReference objekt och lägga till det i Services kontrollens ScriptManager samling. ASP.NET genererar ett klientproxyobjekt för varje ServiceReference-objekt i samlingen Services. Du kan programmatiskt lägga till ServiceReference objekt i Services samlingen för att registrera webbtjänster vid körning.

Mer information om hur du kommer åt webbtjänster i skript finns i Exposing Web Services to Client Script in ASP.NET AJAX and Calling Web Services from Client Script in ASP.NET AJAX.

Lokalisering

Kontrollen ScriptManager genererar referenser på den renderade sidan som pekar på lämpliga lokaliserade skriptfiler, som antingen är skriptfiler inbäddade i sammansättningar eller fristående skriptfiler.

När egenskapen EnableScriptLocalization är inställd trueScriptManager på hämtar kontrollen lokaliserade resurser (till exempel lokaliserade strängar) för den aktuella kulturen, om de finns. Kontrollen ScriptManager innehåller följande funktioner för att använda lokaliserade resurser:

Skriptfiler som är inbäddade i en sammansättning. Kontrollen ScriptManager avgör vilken kulturspecifik eller återställningskulturskriptfil som ska skickas till webbläsaren. Det gör det med hjälp av det kulturspecifika NeutralResourcesLanguageAttribute sammansättningsattributet, resurserna som paketeras med sammansättningen och webbläsarens användargränssnittskultur (om det finns några).
Fristående skriptfiler. Kontrollen ScriptManager definierar listan över användargränssnittskulturer som stöds med hjälp ResourceUICultures av objektets ScriptReference egenskap.
I felsökningsläge. Kontrollen ScriptManager försöker återge en kulturspecifik skriptfil som innehåller felsökningsinformation. Om sidan till exempel är i felsökningsläge och den aktuella kulturen är inställd på en-MXåterger kontrollen en skriptfil som har ett namn som scriptname.en-MX.debug.js, om filen finns. Om filen inte finns återges felsökningsfilen för lämplig återställningskultur

Mer information om hur du lokaliserar resurser finns i Localizing Resources for Component Libraries Overview (Lokalisera resurser för komponentbibliotek– översikt).

Felhantering

När ett sidfel inträffar under asynkrona postbacks AsyncPostBackError utlöses händelsen. Hur fel på servern skickas till klienten beror på AllowCustomErrorsRedirect egenskapen, AsyncPostBackErrorMessage egenskapen och avsnittet med anpassade fel i Web.config-filen. Mer information finns i Anpassa felhantering för UpdatePanel-kontroller.

Deklarativ syntax

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

Konstruktorer

Name	Description
ScriptManager()	Initierar en ny instans av ScriptManager klassen.

Egenskaper

Name	Description
Adapter	Hämtar det webbläsarspecifika adaptern för kontrollen. (Ärvd från Control)
AjaxFrameworkAssembly	Hämtar ajax-ramverkssammansättningen som komponenter på sidan använder.
AjaxFrameworkMode	Hämtar eller anger ett värde som anger hur klientskript för Microsoft Ajax-klientbiblioteket ska inkluderas på klienten.
AllowCustomErrorsRedirect	Hämtar eller anger ett värde som avgör om avsnittet med anpassade fel i Web.config-filen används under ett fel i en asynkron postback.
AppRelativeTemplateSourceDirectory	Hämtar eller anger den programrelativa virtuella katalogen Page UserControl för eller -objektet som innehåller den här kontrollen. (Ärvd från Control)
AsyncPostBackErrorMessage	Hämtar eller anger felmeddelandet som skickas till klienten när ett ohanterat serverundansfel inträffar under en asynkron postback.
AsyncPostBackSourceElementID	Hämtar det unika ID:t för kontrollen som orsakade den asynkrona efteråterställningen.
AsyncPostBackTimeout	Hämtar eller anger ett värde som anger tiden, i sekunder, innan asynkrona postbacks överskrider tidsgränsen om inget svar tas emot.
AuthenticationService	Hämtar objektet AuthenticationServiceManager som är associerat med den aktuella ScriptManager instansen.
BindingContainer	Hämtar kontrollen som innehåller den här kontrollens databindning. (Ärvd från Control)
ChildControlsCreated	Hämtar ett värde som anger om serverkontrollens underordnade kontroller har skapats. (Ärvd från Control)
ClientID	Hämtar kontroll-ID:t för HTML-kod som genereras av ASP.NET. (Ärvd från Control)
ClientIDMode	Hämtar eller anger den algoritm som används för att generera värdet för ClientID egenskapen. (Ärvd från Control)
ClientIDSeparator	Hämtar ett teckenvärde som representerar det avgränsartecken som används i egenskapen ClientID . (Ärvd från Control)
ClientNavigateHandler	Hämtar eller anger namnet på den metod som hanterar händelsen Sys.Application.navigate på klienten.
CompositeScript	Hämtar en referens till det sammansatta skriptet som stöder webbsidan.
Context	Hämtar objektet HttpContext som är associerat med serverkontrollen för den aktuella webbbegäran. (Ärvd från Control)
Controls	Hämtar ett ControlCollection objekt som representerar de underordnade kontrollerna för en angiven serverkontroll i användargränssnittshierarkin. (Ärvd från Control)
DataItemContainer	Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataItemContainer. (Ärvd från Control)
DataKeysContainer	Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataKeysControl. (Ärvd från Control)
DesignMode	Hämtar ett värde som anger om en kontroll används på en designyta. (Ärvd från Control)
EmptyPageUrl	Hämtar eller anger en URL till en tom webbsida.
EnableCdn	Avgör om den aktuella sidan läser in klientskriptreferenser från CDN-sökvägar (Content Delivery Network).
EnableCdnFallback	Gör att lokal kopia av ett skript kan läsas in om CDN (Content Delivery Network) inte är tillgängligt.
EnableHistory	Hämtar eller anger ett värde som anger om webbsidan stöder hantering av historikpunkter.
EnablePageMethods	Hämtar eller anger ett värde som anger om offentliga statiska sidmetoder på en ASP.NET sida kan anropas från klientskriptet.
EnablePartialRendering	Hämtar eller anger ett värde som möjliggör partiell återgivning av en sida, vilket i sin tur gör att du kan uppdatera regioner på sidan individuellt med hjälp UpdatePanel av kontroller.
EnableScriptGlobalization	Hämtar eller anger ett värde som anger om ScriptManager kontrollen renderar skript som stöder parsning och formatering av kulturspecifik information.
EnableScriptLocalization	Hämtar eller anger ett värde som anger om ScriptManager kontrollen återger lokaliserade versioner av skriptfiler.
EnableSecureHistoryState	Hämtar eller anger ett värde som anger om historiktillståndssträngen ska krypteras.
EnableTheming	Hämtar eller anger ett värde som anger om teman ska gälla för den här kontrollen. (Ärvd från Control)
EnableViewState	Hämtar eller anger ett värde som anger om serverkontrollen bevarar sitt visningstillstånd och visningstillståndet för eventuella underordnade kontroller som den innehåller till den begärande klienten. (Ärvd från Control)
Events	Hämtar en lista över händelsehanterardelegater för kontrollen. Den här egenskapen är skrivskyddad. (Ärvd från Control)
HasChildViewState	Hämtar ett värde som anger om den aktuella serverkontrollens underordnade kontroller har några sparade vytillståndsinställningar. (Ärvd från Control)
ID	Hämtar eller anger den programmatiska identifierare som tilldelats serverkontrollen. (Ärvd från Control)
IdSeparator	Hämtar det tecken som används för att separera kontrollidentifierare. (Ärvd från Control)
IsChildControlStateCleared	Hämtar ett värde som anger om kontroller i den här kontrollen har kontrolltillstånd. (Ärvd från Control)
IsDebuggingEnabled	Hämtar ett värde som anger om felsökningsversionerna av klientskriptbiblioteken ska renderas.
IsInAsyncPostBack	Hämtar ett värde som anger om den aktuella återställningen körs i partiell återgivningsläge.
IsNavigating	Hämtar ett värde som anger om en Navigate händelse för närvarande hanteras.
IsTrackingViewState	Hämtar ett värde som anger om serverkontrollen sparar ändringar i visningstillståndet. (Ärvd från Control)
IsViewStateEnabled	Hämtar ett värde som anger om visningstillstånd är aktiverat för den här kontrollen. (Ärvd från Control)
LoadScriptsBeforeUI	Hämtar eller anger ett värde som anger om skript läses in före eller efter markering för sidgränssnittet läses in.
LoadViewStateByID	Hämtar ett värde som anger om kontrollen deltar i inläsningen av dess visningstillstånd i ID stället för index. (Ärvd från Control)
NamingContainer	Hämtar en referens till serverkontrollens namngivningscontainer, vilket skapar ett unikt namnområde för differentiering mellan serverkontroller med samma ID egenskapsvärde. (Ärvd från Control)
Page	Hämtar en referens till den Page instans som innehåller serverkontrollen. (Ärvd från Control)
Parent	Hämtar en referens till serverkontrollens överordnade kontroll i sidkontrollhierarkin. (Ärvd från Control)
ProfileService	Hämtar objektet ProfileServiceManager som är associerat med den aktuella ScriptManager instansen.
RenderingCompatibility	Hämtar ett värde som anger den ASP.NET version som renderad HTML kommer att vara kompatibel med. (Ärvd från Control)
RoleService	Hämtar objektet RoleServiceManager som är associerat med den aktuella ScriptManager instansen.
ScriptMode	Hämtar eller anger ett värde som anger om felsöknings- eller versionsversioner av klientskriptbibliotek återges.
ScriptPath	Föråldrad. Hämtar eller anger rotsökvägen för den plats som används för att skapa sökvägarna till ASP.NET Ajax- och anpassade skriptfiler.
ScriptResourceMapping	Hämtar ett ScriptResourceMapping objekt.
Scripts	Hämtar ett ScriptReferenceCollection objekt som innehåller objekten ScriptReference , som var och en representerar en skriptfil som återges till klienten.
Services	Hämtar ett ServiceReferenceCollection-objekt som innehåller ett ServiceReference-objekt för varje webbtjänst som ASP.NET exponerar på klienten för Ajax-funktioner.
Site	Hämtar information om containern som är värd för den aktuella kontrollen när den återges på en designyta. (Ärvd från Control)
SkinID	Hämtar eller ställer in huden för att applicera på kontrollen. (Ärvd från Control)
SupportsPartialRendering	Hämtar ett värde som anger om klienten stöder partiell återgivning av sidor.
TemplateControl	Hämtar eller anger en referens till mallen som innehåller den här kontrollen. (Ärvd från Control)
TemplateSourceDirectory	Hämtar den virtuella katalogen för Page eller UserControl som innehåller den aktuella serverkontrollen. (Ärvd från Control)
UniqueID	Hämtar den unika, hierarkiskt kvalificerade identifieraren för serverkontrollen. (Ärvd från Control)
ValidateRequestMode	Hämtar eller anger ett värde som anger om kontrollen kontrollerar klientindata från webbläsaren efter potentiellt farliga värden. (Ärvd från Control)
ViewState	Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för en serverkontroll över flera begäranden för samma sida. (Ärvd från Control)
ViewStateIgnoresCase	Hämtar ett värde som anger om objektet StateBag är skiftlägesokänsligt. (Ärvd från Control)
ViewStateMode	Hämtar eller anger visningstillståndsläget för den här kontrollen. (Ärvd från Control)
Visible	Åsidosätter egenskapen Visible som ärvs från basklassen Control för att förhindra att det här värdet anges.

Metoder

Name	Description
AddedControl(Control, Int32)	Anropas efter att en underordnad kontroll har lagts till i Controls Control objektets samling. (Ärvd från Control)
AddHistoryPoint(NameValueCollection, String)	Skapar en historikpunkt och lägger till den i webbläsarens historikstack med den angivna tillståndsdatainsamlingen och tillståndsrubriken.
AddHistoryPoint(String, String, String)	Skapar en historikpunkt och lägger till den i webbläsarens historikstacken med den angivna tillståndsnyckeln, tillståndsvärdet och tillståndsrubriken.
AddHistoryPoint(String, String)	Skapar en historikpunkt och lägger till den i webbläsarens historikstacken med den angivna tillståndsnyckeln och tillståndsvärdet.
AddParsedSubObject(Object)	Meddelar serverkontrollen att ett element, antingen XML eller HTML, parsades och lägger till elementet i serverkontrollens ControlCollection objekt. (Ärvd från Control)
ApplyStyleSheetSkin(Page)	Tillämpar formategenskaperna som definierats i sidformatmallen på kontrollen. (Ärvd från Control)
BeginRenderTracing(TextWriter, Object)	Påbörjar designtidsspårning av återgivningsdata. (Ärvd från Control)
BuildProfileTree(String, Boolean)	Samlar in information om serverkontrollen och levererar den till egenskapen Trace som ska visas när spårning är aktiverat för sidan. (Ärvd från Control)
ClearCachedClientID()	Anger det cachelagrade ClientID värdet till `null`. (Ärvd från Control)
ClearChildControlState()	Tar bort kontrolltillståndsinformationen för serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearChildState()	Tar bort informationen om visningstillstånd och kontrolltillstånd för alla serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearChildViewState()	Tar bort visningstillståndsinformationen för alla serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearEffectiveClientIDMode()	Anger egenskapen för ClientIDMode den aktuella kontrollinstansen och för eventuella underordnade kontroller till Inherit. (Ärvd från Control)
CreateChildControls()	Anropas av det ASP.NET sidramverket för att meddela serverkontroller som använder kompositionsbaserad implementering för att skapa underordnade kontroller som de innehåller som förberedelse för att publicera tillbaka eller återge. (Ärvd från Control)
CreateControlCollection()	Skapar ett nytt ControlCollection objekt som innehåller de underordnade kontrollerna (både literal och server) för serverkontrollen. (Ärvd från Control)
DataBind()	Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller. (Ärvd från Control)
DataBind(Boolean)	Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller med ett alternativ för att skapa händelsen DataBinding . (Ärvd från Control)
DataBindChildren()	Binder en datakälla till serverkontrollens underordnade kontroller. (Ärvd från Control)
Dispose()	Gör att en serverkontroll kan utföra slutlig rensning innan den frigörs från minnet. (Ärvd från Control)
EndRenderTracing(TextWriter, Object)	Avslutar designtidsspårning av återgivningsdata. (Ärvd från Control)
EnsureChildControls()	Avgör om serverkontrollen innehåller underordnade kontroller. Om den inte gör det skapar den underordnade kontroller. (Ärvd från Control)
EnsureID()	Skapar en identifierare för kontroller som inte har tilldelats någon identifierare. (Ärvd från Control)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
FindControl(String, Int32)	Söker i den aktuella namngivningscontainern efter en serverkontroll med det angivna `id` och ett heltal som anges i parametern `pathOffset` , vilket underlättar sökningen. Du bör inte åsidosätta den här versionen av FindControl metoden. (Ärvd från Control)
FindControl(String)	Söker i den aktuella namngivningscontainern efter en serverkontroll med den angivna `id` parametern. (Ärvd från Control)
Focus()	Anger indatafokus till en kontroll. (Ärvd från Control)
GetCurrent(Page)	Hämtar instansen ScriptManager för ett visst Page objekt.
GetDesignModeState()	Hämtar designtidsdata för en kontroll. (Ärvd från Control)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetRegisteredArrayDeclarations()	Hämtar en skrivskyddad samling ECMAScript-matrisdeklarationer (JavaScript) som tidigare registrerats med Page objektet.
GetRegisteredClientScriptBlocks()	Hämtar en skrivskyddad samling klientskriptblock som tidigare registrerats med ScriptManager kontrollen.
GetRegisteredDisposeScripts()	Hämtar en skrivskyddad samling `dispose` skript som tidigare har registrerats med Page objektet.
GetRegisteredExpandoAttributes()	Hämtar en skrivskyddad samling anpassade attribut (expando) som tidigare registrerats med Page objektet.
GetRegisteredHiddenFields()	Hämtar en skrivskyddad samling dolda fält som tidigare registrerats med Page objektet.
GetRegisteredOnSubmitStatements()	Hämtar en skrivskyddad samling `onsubmit` instruktioner som tidigare har registrerats med Page objektet.
GetRegisteredStartupScripts()	Hämtar en skrivskyddad samling startskript som tidigare registrerats med Page objektet.
GetRouteUrl(Object)	Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control)
GetRouteUrl(RouteValueDictionary)	Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control)
GetRouteUrl(String, Object)	Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control)
GetRouteUrl(String, RouteValueDictionary)	Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control)
GetStateString()	Hämtar en sträng som innehåller nyckel/värde-par som representerar webbsidans tillstånd.
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
GetUniqueIDRelativeTo(Control)	Returnerar den prefixade delen av UniqueID egenskapen för den angivna kontrollen. (Ärvd från Control)
HasControls()	Avgör om serverkontrollen innehåller några underordnade kontroller. (Ärvd från Control)
HasEvents()	Returnerar ett värde som anger om händelser har registrerats för kontrollen eller underordnade kontroller. (Ärvd från Control)
IsLiteralContent()	Avgör om serverkontrollen endast innehåller literalinnehåll. (Ärvd från Control)
LoadControlState(Object)	Återställer kontrolltillståndsinformation från en begäran från föregående sida som sparades av SaveControlState() metoden. (Ärvd från Control)
LoadPostData(String, NameValueCollection)	Läser formulärdata som publiceras från webbläsaren till servern och avgör källan till den asynkrona postbacken.
LoadViewState(Object)	Återställer visningstillståndsinformation från en begäran från föregående sida som sparades av SaveViewState() metoden. (Ärvd från Control)
MapPathSecure(String)	Hämtar den fysiska sökväg som en virtuell sökväg, antingen absolut eller relativ, mappar till. (Ärvd från Control)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)	Genererar händelsen AsyncPostBackError .
OnBubbleEvent(Object, EventArgs)	Avgör om händelsen för serverkontrollen skickas upp på sidans UI-serverkontrollhierarki. (Ärvd från Control)
OnDataBinding(EventArgs)	Genererar händelsen DataBinding . (Ärvd från Control)
OnInit(EventArgs)	Genererar händelsen Init och ser till att endast en ScriptManager kontroll finns på sidan.
OnLoad(EventArgs)	Genererar händelsen Load . (Ärvd från Control)
OnPreRender(EventArgs)	Genererar PreRender händelsen och registrerar skriptfiler och tjänster för partiella siduppdateringar.
OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)	Genererar händelsen ResolveCompositeScriptReference .
OnResolveScriptReference(ScriptReferenceEventArgs)	Genererar ResolveScriptReference händelsen för varje skriptreferens som hanteras av ScriptManager kontrollen.
OnUnload(EventArgs)	Genererar händelsen Unload . (Ärvd från Control)
OpenFile(String)	Hämtar en Stream som används för att läsa en fil. (Ärvd från Control)
RaiseBubbleEvent(Object, EventArgs)	Tilldelar alla källor till händelsen och dess information till kontrollens överordnade. (Ärvd från Control)
RaisePostBackEvent(String)	Bearbetar en postback-händelse som genereras av ScriptManager kontrollen och läser in historiktillståndet för webbsidan.
RaisePostDataChangedEvent()	Genererar händelser för kontrollen när den ScriptManager skickas tillbaka till servern.
RegisterArrayDeclaration(Control, String, String)	Registrerar en ECMAScript-matrisdeklaration (JavaScript) med ScriptManager kontrollen för användning med en kontroll som finns i en UpdatePanel kontroll och lägger till matrisen på sidan.
RegisterArrayDeclaration(Page, String, String)	Registrerar en ECMAScript-matrisdeklaration (JavaScript) med ScriptManager kontrollen för användning med en kontroll som finns i en UpdatePanel kontroll och lägger till matrisen på sidan.
RegisterAsyncPostBackControl(Control)	Registrerar en kontroll som en utlösare för asynkrona postbacks.
RegisterClientScriptBlock(Control, Type, String, String, Boolean)	Registrerar ett klientskriptblock med kontrollen ScriptManager för användning med en kontroll som finns i en UpdatePanel kontroll och lägger sedan till skriptblocket på sidan.
RegisterClientScriptBlock(Page, Type, String, String, Boolean)	Registrerar ett klientskriptblock med kontrollen ScriptManager för användning med en kontroll som finns i en UpdatePanel kontroll och lägger sedan till skriptblocket på sidan.
RegisterClientScriptInclude(Control, Type, String, String)	Registrerar en klientskriptfil med kontrollen ScriptManager för användning med en kontroll som finns i en UpdatePanel kontroll och lägger sedan till en skriptfilreferens på sidan.
RegisterClientScriptInclude(Page, Type, String, String)	Registrerar klientskriptet ScriptManager med kontrollen varje gång en asynkron postback inträffar och lägger sedan till en skriptfilreferens på sidan.
RegisterClientScriptResource(Control, Type, String)	Registrerar klientskriptet som är inbäddat i en sammansättning med ScriptManager kontrollen för användning med en kontroll som deltar i delvis sidåtergivning.
RegisterClientScriptResource(Page, Type, String)	Registrerar en klientskriptfil som är inbäddad i en sammansättning med ScriptManager kontrollen varje gång en postback inträffar.
RegisterDataItem(Control, String, Boolean)	Skickar anpassade data till en kontroll under partiell sidåtergivning och anger om data är i JSON-format (JavaScript Object Notation).
RegisterDataItem(Control, String)	Skickar anpassade data till en kontroll under partiell återgivning av sidor.
RegisterDispose(Control, String)	Registrerar ett `dispose` skript för en kontroll som finns i en UpdatePanel kontroll. Skriptet körs när UpdatePanel kontrollen uppdateras eller tas bort.
RegisterExpandoAttribute(Control, String, String, String, Boolean)	Registrerar ett namn/värde-par med ScriptManager kontrollen som ett anpassat attribut (expando) för en angiven kontroll.
RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)	Registrerar en utökarkontroll med den aktuella ScriptManager instansen.
RegisterHiddenField(Control, String, String)	Registrerar ett dolt fält med ScriptManager kontrollen för en kontroll som finns i en UpdatePanel kontroll.
RegisterHiddenField(Page, String, String)	Registrerar ett dolt fält med ScriptManager kontrollen under varje asynkron postback.
RegisterNamedClientScriptResource(Control, String)	Registrerar klientskriptet efter resursnamn som är inbäddat i en sammansättning med ScriptManager kontrollen för användning med en kontroll som deltar i delvis sidåtergivning.
RegisterNamedClientScriptResource(Page, String)	Registrerar klientskriptet efter resursnamn som är inbäddat i en sammansättning med ScriptManager kontrollen för användning med en kontroll som deltar i delvis sidåtergivning.
RegisterOnSubmitStatement(Control, Type, String, String)	Registrerar ECMAScript-kod (JavaScript) med ScriptManager kontrollen för en kontroll som används med en UpdatePanel kontroll som körs när formuläret skickas.
RegisterOnSubmitStatement(Page, Type, String, String)	Registrerar ECMAScript-kod (JavaScript) med ScriptManager kontrollen för en kontroll som används med en UpdatePanel kontroll som körs när formuläret skickas.
RegisterPostBackControl(Control)	Registrerar en kontroll som en utlösare för en postback. Den här metoden används för att konfigurera postback-kontroller i en UpdatePanel kontroll som annars skulle utföra asynkrona postbacks.
RegisterScriptControl<TScriptControl>(TScriptControl)	Registrerar en skriptkontroll med den aktuella ScriptManager instansen.
RegisterScriptDescriptors(IExtenderControl)	Anropar tillbaka till en ExtenderControl klass för att returnera instansskript som måste återges för att stödja klientobjektet som representerar en klientkontroll, komponent eller beteende.
RegisterScriptDescriptors(IScriptControl)	Anropar en ScriptControl klass för att returnera instansskript som måste återges för att stödja klientobjektet som representerar en klientkontroll, komponent eller beteende.
RegisterStartupScript(Control, Type, String, String, Boolean)	Registrerar ett startskriptblock för en kontroll som finns inuti en UpdatePanel med hjälp ScriptManager av kontrollen och lägger till skriptblocket på sidan.
RegisterStartupScript(Page, Type, String, String, Boolean)	Registrerar ett startskriptblock för varje asynkron postback med ScriptManager kontrollen och lägger till skriptblocket på sidan.
RemovedControl(Control)	Anropas efter att en underordnad Controls kontroll har tagits bort från objektets Control samling. (Ärvd från Control)
Render(HtmlTextWriter)	Renderar ScriptManager kontrollens innehåll till webbläsaren med hjälp av det angivna HtmlTextWriter objektet.
RenderChildren(HtmlTextWriter)	Matar ut innehållet i en serverkontrolls underordnade objekt till ett angivet HtmlTextWriter objekt som skriver innehållet som ska återges på klienten. (Ärvd från Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt med hjälp av ett angivet ControlAdapter objekt. (Ärvd från Control)
RenderControl(HtmlTextWriter)	Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt och lagrar spårningsinformation om kontrollen om spårning är aktiverat. (Ärvd från Control)
ResolveAdapter()	Hämtar kontrollkortet som ansvarar för att återge den angivna kontrollen. (Ärvd från Control)
ResolveClientUrl(String)	Hämtar en URL som kan användas av webbläsaren. (Ärvd från Control)
ResolveUrl(String)	Konverterar en URL till en som kan användas på den begärande klienten. (Ärvd från Control)
SaveControlState()	Sparar alla ändringar i serverkontrolltillståndet som har inträffat sedan sidan publicerades tillbaka till servern. (Ärvd från Control)
SaveViewState()	Sparar alla ändringar i visningstillståndet för serverkontroll som har inträffat sedan sidan publicerades tillbaka till servern. (Ärvd från Control)
SetDesignModeState(IDictionary)	Anger designtidsdata för en kontroll. (Ärvd från Control)
SetFocus(Control)	Anger webbläsarens fokus till den angivna kontrollen.
SetFocus(String)	Anger webbläsarens fokus till den kontroll som anges av ID.
SetRenderMethodDelegate(RenderMethod)	Tilldelar ett händelsehanterardelegat för att återge serverkontrollen och dess innehåll till den överordnade kontrollen. (Ärvd från Control)
SetTraceData(Object, Object, Object)	Anger spårningsdata för designtidsspårning av återgivningsdata, med hjälp av det spårade objektet, spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control)
SetTraceData(Object, Object)	Anger spårningsdata för designtidsspårning av återgivningsdata med hjälp av spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)
TrackViewState()	Orsakar spårning av visningstillståndsändringar i serverkontrollen så att de kan lagras i serverkontrollens StateBag objekt. Det här objektet är tillgängligt via egenskapen ViewState . (Ärvd från Control)

Händelser

Name	Description
AsyncPostBackError	Inträffar när det uppstår ett sidfel under en asynkron postback.
DataBinding	Inträffar när serverkontrollen binder till en datakälla. (Ärvd från Control)
Disposed	Inträffar när en serverkontroll frigörs från minnet, vilket är den sista fasen i serverkontrolllivscykeln när en ASP.NET sida begärs. (Ärvd från Control)
Init	Inträffar när serverkontrollen initieras, vilket är det första steget i dess livscykel. (Ärvd från Control)
Load	Inträffar när serverkontrollen läses in i Page objektet. (Ärvd från Control)
Navigate	Inträffar när användaren klickar på webbläsarens bakåt - eller framåtknapp .
PreRender	Inträffar efter att objektet Control har lästs in men före återgivningen. (Ärvd från Control)
ResolveCompositeScriptReference	Inträffar när ett sammansatt skript registreras med ScriptManager kontrollen.
ResolveScriptReference	Inträffar när en medlem i Scripts samlingen registreras med ScriptManager kontrollen.
Unload	Inträffar när serverkontrollen tas bort från minnet. (Ärvd från Control)

Explicita gränssnittsimplementeringar

Name	Description
IControlBuilderAccessor.ControlBuilder	En beskrivning av den här medlemmen finns i ControlBuilder. (Ärvd från Control)
IControlDesignerAccessor.GetDesignModeState()	En beskrivning av den här medlemmen finns i GetDesignModeState(). (Ärvd från Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	En beskrivning av den här medlemmen finns i SetDesignModeState(IDictionary). (Ärvd från Control)
IControlDesignerAccessor.SetOwnerControl(Control)	En beskrivning av den här medlemmen finns i SetOwnerControl(Control). (Ärvd från Control)
IControlDesignerAccessor.UserData	En beskrivning av den här medlemmen finns i UserData. (Ärvd från Control)
IDataBindingsAccessor.DataBindings	En beskrivning av den här medlemmen finns i DataBindings. (Ärvd från Control)
IDataBindingsAccessor.HasDataBindings	En beskrivning av den här medlemmen finns i HasDataBindings. (Ärvd från Control)
IExpressionsAccessor.Expressions	En beskrivning av den här medlemmen finns i Expressions. (Ärvd från Control)
IExpressionsAccessor.HasExpressions	En beskrivning av den här medlemmen finns i HasExpressions. (Ärvd från Control)
IParserAccessor.AddParsedSubObject(Object)	En beskrivning av den här medlemmen finns i AddParsedSubObject(Object). (Ärvd från Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	En beskrivning av den här medlemmen finns i LoadPostData(String, NameValueCollection).
IPostBackDataHandler.RaisePostDataChangedEvent()	En beskrivning av den här medlemmen finns i RaisePostDataChangedEvent().
IPostBackEventHandler.RaisePostBackEvent(String)	ScriptManager Gör att kontrollen kan bearbeta en postback-händelse och läsa in webbsidans historiktillstånd.

Tilläggsmetoder

Name	Description
FindDataSourceControl(Control)	Returnerar datakällan som är associerad med datakontrollen för den angivna kontrollen.
FindFieldTemplate(Control, String)	Returnerar fältmallen för den angivna kolumnen i den angivna kontrollens namngivningscontainer.
FindMetaTable(Control)	Returnerar metatabellobjektet för den innehållande datakontrollen.

Gäller för

Se även

Feedback

Var den här sidan till hjälp?