ScriptManager Klas

Definitie

Beheert ASP.NET Ajax-scriptbibliotheken en scriptbestanden, rendering van gedeeltelijke pagina's en het genereren van clientproxyklassen voor web- en toepassingsservices.

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
Overname
ScriptManager
Kenmerken
Implementeringen

Voorbeelden

In de volgende voorbeelden ziet u verschillende scenario's voor het gebruik van het ScriptManager besturingselement.

Updates voor Partial-Page inschakelen

In het volgende voorbeeld ziet u hoe u het ScriptManager besturingselement kunt gebruiken om updates voor gedeeltelijke pagina's in te schakelen. In dit voorbeeld bevinden een Calendar en een DropDownList besturingselement zich in een UpdatePanel besturingselement. De waarde van de UpdateMode eigenschap is Alwaysstandaard , en de waarde van de ChildrenAsTriggers eigenschap is true. Onderliggende besturingselementen van het paneel veroorzaken daarom een asynchrone 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>

Fouten bijwerken Partial-Page verwerken en script registreren

In het volgende voorbeeld ziet u hoe u aangepaste foutafhandeling kunt bieden tijdens updates van gedeeltelijke pagina's. Wanneer er een fout optreedt tijdens updates van gedeeltelijke pagina's, wordt standaard een JavaScript-berichtvak weergegeven. In dit voorbeeld ziet u hoe u aangepaste foutafhandeling gebruikt door een handler voor de AsyncPostBackError gebeurtenis op te geven en door de AsyncPostBackErrorMessage eigenschap in te stellen in de gebeurtenis-handler. U kunt de AllowCustomErrorsRedirect eigenschap ook instellen om op te geven hoe de sectie aangepaste fouten van het Web.config-bestand wordt gebruikt wanneer er een fout optreedt tijdens updates van gedeeltelijke pagina's. In dit voorbeeld wordt de standaardwaarde van de AllowCustomErrorsRedirect eigenschap gebruikt. Dit betekent dat als het Web.config-bestand een customErrors-element bevat, dat element bepaalt hoe fouten worden weergegeven. Zie customErrors-element (ASP.NET Settings Schema) voor meer informatie.

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

De datum en tijd die worden weergegeven in de browser globaliseren

In het volgende voorbeeld ziet u hoe u de EnableScriptGlobalization eigenschap instelt, zodat een clientscript een cultuurspecifieke datum en tijd in de browser kan weergeven. In het voorbeeld is het Culture kenmerk van de @Page-instructie ingesteld op auto. Als gevolg hiervan bepaalt de eerste taal die is opgegeven in de huidige browserinstellingen de cultuur en ui-cultuur voor de pagina. Zie voor meer informatie Hoe to: De cultuur en ui-cultuur instellen voor ASP.NET globalisatie van webpagina's.

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

Opmerkingen

In dit onderwerp:

Introduction

Het ScriptManager-besturingselement is centraal in Ajax-functionaliteit in ASP.NET. Het besturingselement beheert alle ASP.NET Ajax-resources op een pagina. Dit omvat het downloaden van Microsoft Ajax-bibliotheekscripts naar de browser en het coördineren van gedeeltelijke pagina-updates die zijn ingeschakeld met behulp van UpdatePanel-besturingselementen. Bovendien kunt u met het ScriptManager besturingselement het volgende doen:

  • Registreer het script dat compatibel is met updates van gedeeltelijke pagina's. Als u afhankelijkheden tussen uw script en de kernbibliotheek wilt beheren, wordt elk script dat u registreert, geladen na het Microsoft Ajax Library-script.

  • Geef op of scripts voor release of foutopsporing naar de browser worden verzonden.

  • Geef toegang tot webservicemethoden via een script door webservices te registreren bij het ScriptManager besturingselement.

  • Geef toegang tot ASP.NET verificatie-, rol- en profieltoepassingsservices van clientscripts door deze services te registreren bij het besturingselement ScriptManager.

  • Schakel cultuurspecifieke weergave van ECMAScript-datum-, numerieke en tekenreeksfuncties in de browser in.

  • Toegang tot lokalisatiebronnen voor ingesloten scriptbestanden of voor zelfstandige scriptbestanden met behulp van de ResourceUICultures eigenschap van het ScriptReference besturingselement.

  • Registreer serverbesturingselementen die de IExtenderControl of IScriptControl interfaces met het ScriptManager besturingselement implementeren, zodat het script dat is vereist voor clientonderdelen en gedrag wordt weergegeven.

Partial-Page rendering

De mogelijkheid van een ASP.NET pagina ter ondersteuning van gedeeltelijke paginaweergave wordt bepaald door de volgende factoren:

U kunt de waarde van de EnablePartialRendering eigenschap tijdens runtime tijdens of vóór de gebeurtenis van de pagina Init overschrijven. Als u deze eigenschap probeert te wijzigen nadat de gebeurtenis van Init de pagina is opgetreden, wordt er een InvalidOperationException uitzondering gegenereerd.

Wanneer het weergeven van gedeeltelijke pagina's wordt ondersteund, wordt het script voor het ScriptManager weergeven van asynchrone postbacks en updates van gedeeltelijke pagina's ingeschakeld. De regio's van de pagina die moeten worden bijgewerkt, worden aangewezen met behulp van UpdatePanel besturingselementen. Het ScriptManager besturingselement verwerkt de asynchrone postbacks en vernieuwt alleen de regio's van de pagina die moeten worden bijgewerkt. Zie Partial-Page Overzicht van rendering voor meer informatie over het weergeven van gedeeltelijke pagina's. Zie UpdatePanel Control Overview voor meer informatie over de voorwaarden die een update veroorzaken.

Het ScriptManager-besturingselement gebruiken met basispagina's, gebruikersbesturingselementen en andere onderliggende onderdelen

Een pagina kan slechts één ScriptManager besturingselement in de hiërarchie bevatten. Als u services en scripts wilt registreren voor geneste pagina's, gebruikersbesturingselementen of onderdelen wanneer de bovenliggende pagina al een ScriptManager besturingselement heeft, gebruikt u het ScriptManagerProxy besturingselement. Zie Het besturingselement UpdatePanel gebruiken met basispagina's voor meer informatie.

Scriptbeheer en registratie

ScriptManager Met het besturingselement kunt u een script registreren dat vervolgens wordt weergegeven als onderdeel van de pagina. De ScriptManager controleregistratiemethoden kunnen worden onderverdeeld in de volgende drie categorieën:

  • Registratiemethoden die garanderen dat scriptafhankelijkheden op de Microsoft Ajax-bibliotheek worden onderhouden.

  • Registratiemethoden die niet afhankelijk zijn van de Microsoft Ajax-bibliotheek, maar die compatibel zijn met UpdatePanel-besturingselementen.

  • Registratiemethoden die ondersteuning bieden voor het werken met UpdatePanel besturingselementen.

Zie Aangepast clientscript maken en gebruiken met behulp van de Microsoft Ajax-bibliotheek voor meer informatie over het maken en gebruiken van Ajax-scripts in ASP.NET.

Script registreren dat afhankelijk is van de Microsoft Ajax-bibliotheek

U kunt de volgende methoden gebruiken om scriptbestanden te registreren op een manier die garandeert dat eventuele afhankelijkheden van de Microsoft Ajax-bibliotheek worden onderhouden.

Method Definition
RegisterScriptControl Registreert een serverbeheer waarmee de interface wordt geïmplementeerd die wordt gebruikt voor het IScriptControl definiëren van een Sys.Component-clientobject . Het ScriptManager besturingselement geeft een script weer dat ondersteuning biedt voor het clientobject.
RegisterExtenderControl Registreert een serverbeheer waarmee de interface wordt geïmplementeerd die wordt gebruikt voor het IExtenderControl definiëren van een Sys.Component-clientobject . Het ScriptManager besturingselement geeft een script weer dat ondersteuning biedt voor het clientobject.

Compatibele scripts registreren Partial-Page bijwerken

U kunt de volgende methoden gebruiken om scriptbestanden te registreren die niet afhankelijk zijn van de Microsoft Ajax-bibliotheek, maar die compatibel zijn met UpdatePanel-besturingselementen. Deze methoden komen overeen met vergelijkbare methoden van het ClientScriptManager besturingselement. Als u een script weergeeft voor gebruik in een UpdatePanel besturingselement, moet u de methoden van het ScriptManager besturingselement aanroepen.

Method Definition
RegisterArrayDeclaration Voegt een waarde toe aan een JavaScript-matrix. Als de matrix niet bestaat, wordt deze gemaakt.
RegisterClientScriptBlock Geeft een script element weer na de openingstag <form> van de pagina. Het script wordt opgegeven als een tekenreeksparameter.
RegisterClientScriptInclude Geeft een script element weer na de openingstag <form> van de pagina. De scriptinhoud wordt opgegeven door het src kenmerk in te stellen op een URL die verwijst naar een scriptbestand.
RegisterClientScriptResource Geeft een script element weer na de openingstag <form> van de pagina. De scriptinhoud wordt opgegeven met een resourcenaam in een assembly. Het src kenmerk wordt automatisch gevuld met een URL door een aanroep naar een HTTP-handler waarmee het benoemde script uit de assembly wordt opgehaald.
RegisterExpandoAttribute Geeft een aangepast kenmerkpaar voor de naam/waarde (een expando) weer in de markeringen voor een opgegeven besturingselement.
RegisterHiddenField Geeft een verborgen veld weer.
RegisterOnSubmitStatement Registreert een script dat wordt uitgevoerd als reactie op de gebeurtenis van submit het form element. Het onSubmit kenmerk verwijst naar het opgegeven script.
RegisterStartupScript Hiermee wordt een opstartscriptblok weergegeven vlak voor de afsluitende </form> tag van de pagina. Het script dat moet worden weergegeven, wordt opgegeven als een tekenreeksparameter.

Wanneer u methoden registreert, geeft u een type/sleutelpaar voor dat script op. Als een script met hetzelfde type/sleutelpaar al is geregistreerd, wordt er geen nieuw script geregistreerd. Als u een script registreert met een type/resourcenaampaar dat al bestaat, wordt het script element dat verwijst naar de resource niet opnieuw toegevoegd. Wanneer u een expando-kenmerk van een eerder geregistreerd kenmerk registreert, wordt er een uitzondering gegenereerd. Dubbele registratie van matrixwaarden is toegestaan.

Wanneer u de RegisterClientScriptInclude of de RegisterClientScriptResource methode aanroept, moet u voorkomen dat u een script registreert dat inlinefuncties uitvoert. Registreer in plaats daarvan een script dat functiedefinities bevat, zoals gebeurtenishandlers of aangepaste klassedefinities voor uw toepassing.

Registratiemethoden voor UpdatePanel-besturingselementen

U kunt de volgende methoden gebruiken om updates van gedeeltelijke pagina's aan te passen wanneer u besturingselementen gebruikt UpdatePanel .

Method Definition
RegisterAsyncPostBackControl Registreert een besturingselement als trigger voor asynchrone postbacks.
RegisterDataItem Hiermee worden aangepaste gegevens verzonden naar besturingselementen tijdens het weergeven van gedeeltelijke pagina's.
RegisterDispose Registreert een verwijderingsscript voor een besturingselement dat zich in een UpdatePanel besturingselement bevindt. Het script wordt uitgevoerd wanneer het UpdatePanel besturingselement wordt bijgewerkt of verwijderd. De verwijderingsmethode wordt gebruikt voor clientonderdelen die deel uitmaken van de Microsoft Ajax-bibliotheek en die resources moeten vrij maken wanneer een onderdeel niet meer wordt gebruikt.
RegisterPostBackControl Registreert een besturingselement als trigger voor een volledige terugpost. Deze methode wordt gebruikt voor besturingselementen in een UpdatePanel besturingselement dat anders asynchrone postbacks zou uitvoeren.

Webserviceverwijzingen

U kunt een webservice registreren die moet worden aangeroepen vanuit het clientscript door een ServiceReference object te maken en toe te voegen aan de Services verzameling van het ScriptManager besturingselement. ASP.NET genereert een clientproxyobject voor elk ServiceReference-object in de verzameling Services. U kunt programmatisch objecten toevoegen ServiceReference aan de Services verzameling om webservices tijdens runtime te registreren.

Zie Exposing Web Services to Client Script in ASP.NET AJAX and Calling Web Services from Client Script in ASP.NET AJAX voor meer informatie over het openen van webservices in script.

Localization

Het ScriptManager besturingselement genereert verwijzingen op de weergegeven pagina die verwijst naar de juiste gelokaliseerde scriptbestanden. Dit zijn scriptbestanden die zijn ingesloten in assembly's of zelfstandige scriptbestanden.

Wanneer de EnableScriptLocalization eigenschap is ingesteld trueop, haalt het ScriptManager besturingselement gelokaliseerde resources (zoals gelokaliseerde tekenreeksen) op voor de huidige cultuur, als deze bestaan. Het ScriptManager besturingselement biedt de volgende functionaliteit voor het gebruik van gelokaliseerde resources:

  • Scriptbestanden die zijn ingesloten in een assembly. Het ScriptManager besturingselement bepaalt welk cultuurspecifiek scriptbestand of terugvalcultuurscriptbestand naar de browser moet worden verzonden. Dit doet u met behulp van het cultuurspecifieke NeutralResourcesLanguageAttribute assemblykenmerk, de resources die zijn verpakt met de assembly en de UI-cultuur van de browser (indien van toepassing).

  • Zelfstandige scriptbestanden. Het ScriptManager besturingselement definieert de lijst met UI-culturen die worden ondersteund met behulp van de ResourceUICultures eigenschap van het ScriptReference object.

  • In de foutopsporingsmodus. Het ScriptManager besturingselement probeert een cultuurspecifiek scriptbestand weer te geven dat foutopsporingsgegevens bevat. Als de pagina zich bijvoorbeeld in de foutopsporingsmodus bevindt en de huidige cultuur is ingesteld op en-MX, geeft het besturingselement een scriptbestand weer met een naam zoals scriptname.en-MX.debug.js, als het bestand bestaat. Als het bestand niet bestaat, wordt het foutopsporingsbestand voor de juiste terugvalcultuur weergegeven

Zie Overzicht van het lokaliseren van resources voor onderdeelbibliotheken voor meer informatie over het lokaliseren van resources.

Foutafhandeling

Wanneer er een paginafout optreedt tijdens asynchrone postbacks, wordt de AsyncPostBackError gebeurtenis gegenereerd. De manier waarop fouten op de server naar de client worden verzonden, is afhankelijk van de AllowCustomErrorsRedirect eigenschap, de AsyncPostBackErrorMessage eigenschap en de sectie aangepaste fouten van het Web.config-bestand. Zie Aanpassen van foutafhandeling voor UpdatePanel-besturingselementen voor meer informatie.

Declaratieve syntaxis

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

Constructors

Name Description
ScriptManager()

Initialiseert een nieuw exemplaar van de ScriptManager klasse.

Eigenschappen

Name Description
Adapter

Hiermee haalt u de browserspecifieke adapter voor het besturingselement op.

(Overgenomen van Control)
AjaxFrameworkAssembly

Hiermee haalt u de Ajax-frameworkassembly op die onderdelen op de pagina worden gebruikt.

AjaxFrameworkMode

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft hoe clientscripts van de Microsoft Ajax-clientbibliotheek op de client worden opgenomen.

AllowCustomErrorsRedirect

Hiermee wordt een waarde opgehaald of ingesteld die bepaalt of de sectie aangepaste fouten van het bestand Web.config wordt gebruikt tijdens een fout in een asynchrone postback.

AppRelativeTemplateSourceDirectory

Hiermee haalt u de toepassingsgerelateerde virtuele map op van het Page of UserControl object dat dit besturingselement bevat.

(Overgenomen van Control)
AsyncPostBackErrorMessage

Hiermee wordt het foutbericht dat naar de client wordt verzonden, opgevraagd of ingesteld wanneer er een niet-verwerkte server-uitzondering optreedt tijdens een asynchrone postback.

AsyncPostBackSourceElementID

Hiermee haalt u de unieke id op van het besturingselement dat de asynchrone postback heeft veroorzaakt.

AsyncPostBackTimeout

Hiermee wordt een waarde opgehaald of ingesteld die de tijd in seconden aangeeft voordat er een time-out optreedt voor asynchrone postbacks als er geen antwoord wordt ontvangen.

AuthenticationService

Hiermee haalt u het AuthenticationServiceManager object op dat is gekoppeld aan het huidige ScriptManager exemplaar.

BindingContainer

Hiermee haalt u het besturingselement op dat de gegevensbinding van dit besturingselement bevat.

(Overgenomen van Control)
ChildControlsCreated

Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het serverbesturingselement zijn gemaakt.

(Overgenomen van Control)
ClientID

Hiermee haalt u de besturingselement-id op voor HTML-markeringen die worden gegenereerd door ASP.NET.

(Overgenomen van Control)
ClientIDMode

Hiermee wordt het algoritme opgehaald of ingesteld dat wordt gebruikt om de waarde van de ClientID eigenschap te genereren.

(Overgenomen van Control)
ClientIDSeparator

Hiermee haalt u een tekenwaarde op die het scheidingsteken vertegenwoordigt dat in de ClientID eigenschap wordt gebruikt.

(Overgenomen van Control)
ClientNavigateHandler

Hiermee haalt u de naam op van de methode waarmee de gebeurtenis Sys.Application.navigate op de client wordt verwerkt of ingesteld.

CompositeScript

Hiermee haalt u een verwijzing op naar het samengestelde script dat ondersteuning biedt voor de webpagina.

Context

Hiermee wordt het HttpContext object opgehaald dat is gekoppeld aan het serverbeheer voor de huidige webaanvraag.

(Overgenomen van Control)
Controls

Hiermee haalt u een ControlCollection object op dat de onderliggende besturingselementen vertegenwoordigt voor een opgegeven serverbesturingselement in de UI-hiërarchie.

(Overgenomen van Control)
DataItemContainer

Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataItemContainergeïmplementeerd.

(Overgenomen van Control)
DataKeysContainer

Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataKeysControlgeïmplementeerd.

(Overgenomen van Control)
DesignMode

Hiermee wordt een waarde opgehaald die aangeeft of een besturingselement wordt gebruikt op een ontwerpoppervlak.

(Overgenomen van Control)
EmptyPageUrl

Hiermee haalt u een URL op of stelt u deze in op een lege webpagina.

EnableCdn

Bepaalt of op de huidige pagina clientscriptverwijzingen van CDN-paden (Content Delivery Network) worden geladen.

EnableCdnFallback

Hiermee kan een lokale kopie van een script worden geladen in het geval dat het CDN (Content Delivery Network) niet beschikbaar is.

EnableHistory

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de webpagina geschiedenispuntbeheer ondersteunt.

EnablePageMethods

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of openbare statische paginamethoden op een ASP.NET pagina kunnen worden aangeroepen vanuit het clientscript.

EnablePartialRendering

Hiermee haalt u een waarde op die gedeeltelijke weergave van een pagina mogelijk maakt, zodat u regio's van de pagina afzonderlijk kunt bijwerken met behulp van UpdatePanel besturingselementen.

EnableScriptGlobalization

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het ScriptManager besturingselement script weergeeft dat ondersteuning biedt voor het parseren en opmaken van cultuurspecifieke informatie.

EnableScriptLocalization

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het ScriptManager besturingselement gelokaliseerde versies van scriptbestanden weergeeft.

EnableSecureHistoryState

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de geschiedenisstatustekenreeks moet worden versleuteld.

EnableTheming

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of thema's van toepassing zijn op dit besturingselement.

(Overgenomen van Control)
EnableViewState

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het serverbesturingselement de weergavestatus behoudt en de weergavestatus van onderliggende besturingselementen die het bevat, aan de aanvragende client.

(Overgenomen van Control)
Events

Hiermee haalt u een lijst met gedelegeerden van de gebeurtenis-handler op voor het besturingselement. Deze eigenschap is alleen-lezen.

(Overgenomen van Control)
HasChildViewState

Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het huidige serverbesturingselement instellingen voor de weergavestatus hebben.

(Overgenomen van Control)
ID

Hiermee wordt de programmatische id opgehaald of ingesteld die aan het serverbeheer is toegewezen.

(Overgenomen van Control)
IdSeparator

Hiermee haalt u het teken op dat wordt gebruikt om besturings-id's te scheiden.

(Overgenomen van Control)
IsChildControlStateCleared

Hiermee wordt een waarde opgehaald die aangeeft of besturingselementen in dit besturingselement de controlestatus hebben.

(Overgenomen van Control)
IsDebuggingEnabled

Hiermee wordt een waarde opgehaald die aangeeft of de foutopsporingsversies van clientscriptbibliotheken worden weergegeven.

IsInAsyncPostBack

Hiermee wordt een waarde opgehaald die aangeeft of de huidige postback wordt uitgevoerd in de gedeeltelijke renderingmodus.

IsNavigating

Hiermee wordt een waarde opgehaald die aangeeft of een Navigate gebeurtenis momenteel wordt verwerkt.

IsTrackingViewState

Hiermee wordt een waarde opgehaald die aangeeft of het serverbeheer wijzigingen opslaat in de weergavestatus.

(Overgenomen van Control)
IsViewStateEnabled

Hiermee wordt een waarde opgehaald die aangeeft of de weergavestatus is ingeschakeld voor dit besturingselement.

(Overgenomen van Control)
LoadScriptsBeforeUI

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of scripts worden geladen vóór of na markeringen voor de paginagebruikersinterface.

LoadViewStateByID

Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement deelneemt aan het laden van de weergavestatus door ID in plaats van index.

(Overgenomen van Control)
NamingContainer

Hiermee wordt een verwijzing opgehaald naar de naamgevingscontainer van het serverbesturingselement, waarmee een unieke naamruimte wordt gemaakt voor het onderscheiden tussen serverbesturingselementen met dezelfde ID eigenschapswaarde.

(Overgenomen van Control)
Page

Hiermee haalt u een verwijzing op naar het Page exemplaar dat het serverbeheer bevat.

(Overgenomen van Control)
Parent

Hiermee haalt u een verwijzing op naar het bovenliggende besturingselement van het serverbeheer in de paginabeheerhiërarchie.

(Overgenomen van Control)
ProfileService

Hiermee haalt u het ProfileServiceManager object op dat is gekoppeld aan het huidige ScriptManager exemplaar.

RenderingCompatibility

Hiermee wordt een waarde opgehaald waarmee de ASP.NET versie wordt opgegeven waarmee HTML wordt weergegeven, compatibel is met.

(Overgenomen van Control)
RoleService

Hiermee haalt u het RoleServiceManager object op dat is gekoppeld aan het huidige ScriptManager exemplaar.

ScriptMode

Hiermee wordt een waarde opgehaald of ingesteld waarmee wordt aangegeven of foutopsporing of releaseversies van clientscriptbibliotheken worden weergegeven.

ScriptPath
Verouderd.

Hiermee haalt u het hoofdpad op van de locatie die wordt gebruikt om de paden te bouwen naar ASP.NET Ajax- en aangepaste scriptbestanden.

ScriptResourceMapping

Hiermee haalt u een ScriptResourceMapping object op.

Scripts

Hiermee haalt u een ScriptReferenceCollection object op dat de ScriptReference objecten bevat, die elk een scriptbestand vertegenwoordigt dat aan de client wordt weergegeven.

Services

Hiermee haalt u een ServiceReferenceCollection-object op dat een ServiceReference-object bevat voor elke webservice die ASP.NET beschikbaar maakt op de client voor Ajax-functionaliteit.

Site

Hiermee wordt informatie opgehaald over de container die als host fungeert voor het huidige besturingselement wanneer deze op een ontwerpoppervlak wordt weergegeven.

(Overgenomen van Control)
SkinID

Hiermee wordt de huid op de controle toegepast of ingesteld.

(Overgenomen van Control)
SupportsPartialRendering

Hiermee wordt een waarde opgehaald die aangeeft of de client gedeeltelijke pagina-rendering ondersteunt.

TemplateControl

Hiermee haalt u een verwijzing op naar de sjabloon die dit besturingselement bevat of stelt u deze in.

(Overgenomen van Control)
TemplateSourceDirectory

Hiermee haalt u de virtuele map op van de Page server of UserControl die het huidige serverbeheer bevat.

(Overgenomen van Control)
UniqueID

Hiermee haalt u de unieke, hiërarchisch gekwalificeerde id voor het serverbesturingselement op.

(Overgenomen van Control)
ValidateRequestMode

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement clientinvoer vanuit de browser controleert op mogelijk gevaarlijke waarden.

(Overgenomen van Control)
ViewState

Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een serverbeheer kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina.

(Overgenomen van Control)
ViewStateIgnoresCase

Hiermee wordt een waarde opgehaald die aangeeft of het StateBag object niet hoofdlettergevoelig is.

(Overgenomen van Control)
ViewStateMode

Hiermee haalt u de weergavestatusmodus van dit besturingselement op of stelt u deze in.

(Overgenomen van Control)
Visible

Overschrijft de Visible eigenschap die wordt overgenomen van de basisklasse Control om te voorkomen dat deze waarde wordt ingesteld.

Methoden

Name Description
AddedControl(Control, Int32)

Aangeroepen nadat een onderliggend besturingselement is toegevoegd aan de Controls verzameling van het Control object.

(Overgenomen van Control)
AddHistoryPoint(NameValueCollection, String)

Hiermee maakt u een geschiedenispunt en voegt u dit toe aan de geschiedenisstack van de browser, met behulp van de opgegeven statusgegevensverzameling en statustitel.

AddHistoryPoint(String, String, String)

Hiermee maakt u een geschiedenispunt en voegt u dit toe aan de geschiedenisstack van de browser, met behulp van de opgegeven statussleutel, statuswaarde en statustitel.

AddHistoryPoint(String, String)

Hiermee maakt u een geschiedenispunt en voegt u dit toe aan de geschiedenisstack van de browser, met behulp van de opgegeven statussleutel en statuswaarde.

AddParsedSubObject(Object)

Hiermee wordt het serverbesturingselement aangegeven dat een element, XML of HTML, is geparseerd en wordt het element toegevoegd aan het object van ControlCollection het serverbesturingselement.

(Overgenomen van Control)
ApplyStyleSheetSkin(Page)

De stijleigenschappen die in het paginamodel zijn gedefinieerd, worden toegepast op het besturingselement.

(Overgenomen van Control)
BeginRenderTracing(TextWriter, Object)

Begint met het traceren van ontwerptijd van renderinggegevens.

(Overgenomen van Control)
BuildProfileTree(String, Boolean)

Verzamelt informatie over het serverbesturingselement en levert deze aan de Trace eigenschap die moet worden weergegeven wanneer tracering is ingeschakeld voor de pagina.

(Overgenomen van Control)
ClearCachedClientID()

Hiermee stelt u de waarde in de cache in ClientID op null.

(Overgenomen van Control)
ClearChildControlState()

Hiermee verwijdert u de informatie over de controlestatus voor de onderliggende besturingselementen van het serverbesturingselement.

(Overgenomen van Control)
ClearChildState()

Hiermee verwijdert u de informatie over de weergavestatus en controlestatus voor alle onderliggende besturingselementen van het serverbesturingselement.

(Overgenomen van Control)
ClearChildViewState()

Hiermee verwijdert u de informatie over de weergavestatus voor alle onderliggende besturingselementen van het serverbesturingselement.

(Overgenomen van Control)
ClearEffectiveClientIDMode()

Hiermee stelt u de ClientIDMode eigenschap van het huidige besturingselementexemplaren en van alle onderliggende besturingselementen in op Inherit.

(Overgenomen van Control)
CreateChildControls()

Wordt aangeroepen door het ASP.NET paginaframework om serverbesturingselementen op de hoogte te stellen die gebruikmaken van implementatie op basis van samenstelling om onderliggende besturingselementen te maken die ze bevatten ter voorbereiding op het terug plaatsen of weergeven.

(Overgenomen van Control)
CreateControlCollection()

Hiermee maakt u een nieuw ControlCollection object voor het opslaan van de onderliggende besturingselementen (zowel letterlijk als server) van het serverbesturingselement.

(Overgenomen van Control)
DataBind()

Hiermee wordt een gegevensbron gekoppeld aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen.

(Overgenomen van Control)
DataBind(Boolean)

Hiermee koppelt u een gegevensbron aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen met een optie om de DataBinding gebeurtenis te genereren.

(Overgenomen van Control)
DataBindChildren()

Hiermee wordt een gegevensbron gekoppeld aan de onderliggende besturingselementen van het serverbesturingselement.

(Overgenomen van Control)
Dispose()

Hiermee kan een serverbesturing definitief worden opgeschoond voordat deze uit het geheugen wordt vrijgegeven.

(Overgenomen van Control)
EndRenderTracing(TextWriter, Object)

Hiermee wordt de ontwerptijd van het traceren van renderinggegevens beëindigd.

(Overgenomen van Control)
EnsureChildControls()

Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. Als dat niet het geval is, worden onderliggende besturingselementen gemaakt.

(Overgenomen van Control)
EnsureID()

Hiermee maakt u een id voor besturingselementen waaraan geen id is toegewezen.

(Overgenomen van Control)
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
FindControl(String, Int32)

Hiermee zoekt u in de huidige naamgevingscontainer naar een serverbeheer met het opgegeven en een geheel getal dat is opgegeven id in de pathOffset parameter, die de zoekopdracht helpt. U moet deze versie van de FindControl methode niet overschrijven.

(Overgenomen van Control)
FindControl(String)

Zoekt in de huidige naamgevingscontainer naar een serverbeheer met de opgegeven id parameter.

(Overgenomen van Control)
Focus()

Hiermee stelt u de invoerfocus in op een besturingselement.

(Overgenomen van Control)
GetCurrent(Page)

Hiermee haalt u het ScriptManager exemplaar voor een bepaald Page object op.

GetDesignModeState()

Hiermee haalt u ontwerptijdgegevens op voor een besturingselement.

(Overgenomen van Control)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetRegisteredArrayDeclarations()

Hiermee haalt u een alleen-lezen verzameling ECMAScript-matrixdeclaraties (JavaScript) op die eerder bij het Page object zijn geregistreerd.

GetRegisteredClientScriptBlocks()

Hiermee wordt een verzameling alleen-lezenscriptblokken opgehaald die eerder bij het ScriptManager besturingselement zijn geregistreerd.

GetRegisteredDisposeScripts()

Hiermee wordt een verzameling dispose alleen-lezen scripts opgehaald die eerder bij het Page object zijn geregistreerd.

GetRegisteredExpandoAttributes()

Hiermee wordt een alleen-lezen verzameling aangepaste (expando)-kenmerken opgehaald die eerder bij het Page object zijn geregistreerd.

GetRegisteredHiddenFields()

Hiermee wordt een alleen-lezen verzameling verborgen velden opgehaald die eerder bij het Page object zijn geregistreerd.

GetRegisteredOnSubmitStatements()

Hiermee wordt een verzameling onsubmit alleen-lezen instructies opgehaald die eerder bij het Page object zijn geregistreerd.

GetRegisteredStartupScripts()

Hiermee haalt u een alleen-lezen verzameling opstartscripts op die eerder bij het Page object zijn geregistreerd.

GetRouteUrl(Object)

Haalt de URL op die overeenkomt met een set routeparameters.

(Overgenomen van Control)
GetRouteUrl(RouteValueDictionary)

Haalt de URL op die overeenkomt met een set routeparameters.

(Overgenomen van Control)
GetRouteUrl(String, Object)

Haalt de URL op die overeenkomt met een set routeparameters en een routenaam.

(Overgenomen van Control)
GetRouteUrl(String, RouteValueDictionary)

Haalt de URL op die overeenkomt met een set routeparameters en een routenaam.

(Overgenomen van Control)
GetStateString()

Hiermee wordt een tekenreeks opgehaald die sleutel-waardeparen bevat die de status van de webpagina vertegenwoordigen.

GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
GetUniqueIDRelativeTo(Control)

Retourneert het voorvoegselgedeelte van de UniqueID eigenschap van het opgegeven besturingselement.

(Overgenomen van Control)
HasControls()

Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat.

(Overgenomen van Control)
HasEvents()

Retourneert een waarde die aangeeft of gebeurtenissen zijn geregistreerd voor het besturingselement of onderliggende besturingselementen.

(Overgenomen van Control)
IsLiteralContent()

Bepaalt of het serverbeheer alleen letterlijke inhoud bevat.

(Overgenomen van Control)
LoadControlState(Object)

Herstelt controlestatusgegevens van een vorige paginaaanvraag die door de SaveControlState() methode is opgeslagen.

(Overgenomen van Control)
LoadPostData(String, NameValueCollection)

Leest formuliergegevens die vanuit de browser naar de server worden gepost en bepaalt de bron van de asynchrone postback.

LoadViewState(Object)

Hiermee herstelt u informatie over de weergavestatus van een vorige paginaaanvraag die is opgeslagen door de SaveViewState() methode.

(Overgenomen van Control)
MapPathSecure(String)

Hiermee haalt u het fysieke pad op waarnaar een virtueel pad, ofwel absoluut of relatief, wordt toegewezen.

(Overgenomen van Control)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)

Hiermee wordt de AsyncPostBackError gebeurtenis gegenereerd.

OnBubbleEvent(Object, EventArgs)

Bepaalt of de gebeurtenis voor het serverbeheer wordt doorgegeven aan de hiërarchie van de ui-server van de pagina.

(Overgenomen van Control)
OnDataBinding(EventArgs)

Hiermee wordt de DataBinding gebeurtenis gegenereerd.

(Overgenomen van Control)
OnInit(EventArgs)

Hiermee wordt de Init gebeurtenis gegenereerd en wordt ervoor gezorgd dat er slechts één ScriptManager besturingselement op de pagina bestaat.

OnLoad(EventArgs)

Hiermee wordt de Load gebeurtenis gegenereerd.

(Overgenomen van Control)
OnPreRender(EventArgs)

Hiermee wordt de PreRender gebeurtenis gegenereerd en worden scriptbestanden en -services geregistreerd voor updates van gedeeltelijke pagina's.

OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)

Hiermee wordt de ResolveCompositeScriptReference gebeurtenis gegenereerd.

OnResolveScriptReference(ScriptReferenceEventArgs)

Hiermee wordt de ResolveScriptReference gebeurtenis gegenereerd voor elke scriptreferentie die wordt beheerd door het ScriptManager besturingselement.

OnUnload(EventArgs)

Hiermee wordt de Unload gebeurtenis gegenereerd.

(Overgenomen van Control)
OpenFile(String)

Hiermee wordt een Stream bestand gelezen.

(Overgenomen van Control)
RaiseBubbleEvent(Object, EventArgs)

Wijst alle bronnen van de gebeurtenis en de bijbehorende informatie toe aan het bovenliggende besturingselement.

(Overgenomen van Control)
RaisePostBackEvent(String)

Verwerkt een postback-gebeurtenis die wordt gegenereerd door het ScriptManager besturingselement en laadt de geschiedenisstatus van de webpagina.

RaisePostDataChangedEvent()

Hiermee worden gebeurtenissen voor het ScriptManager besturingselement gegenereerd wanneer het terug naar de server wordt geplaatst.

RegisterArrayDeclaration(Control, String, String)

Registreert een ECMAScript-matrixdeclaratie (JavaScript) met het ScriptManager besturingselement voor gebruik met een besturingselement dat zich in een UpdatePanel besturingselement bevindt en voegt de matrix toe aan de pagina.

RegisterArrayDeclaration(Page, String, String)

Registreert een ECMAScript-matrixdeclaratie (JavaScript) met het ScriptManager besturingselement voor gebruik met een besturingselement dat zich in een UpdatePanel besturingselement bevindt en voegt de matrix toe aan de pagina.

RegisterAsyncPostBackControl(Control)

Registreert een besturingselement als trigger voor asynchrone postbacks.

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

Registreert een clientscriptblok met het ScriptManager besturingselement voor gebruik met een besturingselement dat zich in een UpdatePanel besturingselement bevindt en voegt vervolgens het scriptblok toe aan de pagina.

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

Registreert een clientscriptblok met het ScriptManager besturingselement voor gebruik met een besturingselement dat zich in een UpdatePanel besturingselement bevindt en voegt vervolgens het scriptblok toe aan de pagina.

RegisterClientScriptInclude(Control, Type, String, String)

Registreert een clientscriptbestand met het ScriptManager besturingselement voor gebruik met een besturingselement dat zich in een UpdatePanel besturingselement bevindt en voegt vervolgens een scriptbestandsreferentie toe aan de pagina.

RegisterClientScriptInclude(Page, Type, String, String)

Registreert clientscript met het ScriptManager besturingselement telkens wanneer een asynchrone postback plaatsvindt en voegt vervolgens een scriptbestandsreferentie toe aan de pagina.

RegisterClientScriptResource(Control, Type, String)

Registreert het clientscript dat is ingesloten in een assembly met het ScriptManager besturingselement voor gebruik met een besturingselement dat deelneemt aan het weergeven van gedeeltelijke pagina's.

RegisterClientScriptResource(Page, Type, String)

Registreert een clientscriptbestand dat is ingesloten in een assembly met het ScriptManager besturingselement telkens wanneer een postback plaatsvindt.

RegisterDataItem(Control, String, Boolean)

Hiermee worden aangepaste gegevens naar een besturingselement verzonden tijdens het weergeven van gedeeltelijke pagina's en wordt aangegeven of de gegevens de JSON-indeling (JavaScript Object Notation) hebben.

RegisterDataItem(Control, String)

Hiermee worden aangepaste gegevens naar een besturingselement verzonden tijdens het weergeven van gedeeltelijke pagina's.

RegisterDispose(Control, String)

Registreert een dispose script voor een besturingselement dat zich in een UpdatePanel besturingselement bevindt. Het script wordt uitgevoerd wanneer het UpdatePanel besturingselement wordt bijgewerkt of verwijderd.

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

Registreert een naam/waardepaar met het ScriptManager besturingselement als een aangepast (expando)-kenmerk van een opgegeven besturingselement.

RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)

Registreert een extender-controle met het huidige ScriptManager exemplaar.

RegisterHiddenField(Control, String, String)

Registreert een verborgen veld met het ScriptManager besturingselement voor een besturingselement dat zich in een UpdatePanel besturingselement bevindt.

RegisterHiddenField(Page, String, String)

Registreert een verborgen veld met het ScriptManager besturingselement tijdens elke asynchrone postback.

RegisterNamedClientScriptResource(Control, String)

Registreert clientscript op resourcenaam die is ingesloten in een assembly met het ScriptManager besturingselement voor gebruik met een besturingselement dat deelneemt aan het weergeven van gedeeltelijke pagina's.

RegisterNamedClientScriptResource(Page, String)

Registreert clientscript op resourcenaam die is ingesloten in een assembly met het ScriptManager besturingselement voor gebruik met een besturingselement dat deelneemt aan het weergeven van gedeeltelijke pagina's.

RegisterOnSubmitStatement(Control, Type, String, String)

Registreert ECMAScript-code (JavaScript) met het ScriptManager besturingselement voor een besturingselement dat wordt gebruikt met een UpdatePanel besturingselement dat wordt uitgevoerd wanneer het formulier wordt verzonden.

RegisterOnSubmitStatement(Page, Type, String, String)

Registreert ECMAScript-code (JavaScript) met het ScriptManager besturingselement voor een besturingselement dat wordt gebruikt met een UpdatePanel besturingselement dat wordt uitgevoerd wanneer het formulier wordt verzonden.

RegisterPostBackControl(Control)

Registreert een besturingselement als trigger voor een terugpost. Deze methode wordt gebruikt voor het configureren van postback-besturingselementen in een UpdatePanel besturingselement dat anders asynchrone postbacks zou uitvoeren.

RegisterScriptControl<TScriptControl>(TScriptControl)

Registreert een scriptbeheer met het huidige ScriptManager exemplaar.

RegisterScriptDescriptors(IExtenderControl)

Roept terug naar een ExtenderControl klasse om exemplaarscripts te retourneren die moeten worden weergegeven ter ondersteuning van het clientobject dat een clientbeheer, onderdeel of gedrag vertegenwoordigt.

RegisterScriptDescriptors(IScriptControl)

Roept een ScriptControl klasse aan om exemplaarscripts te retourneren die moeten worden weergegeven ter ondersteuning van het clientobject dat een clientbeheer, onderdeel of gedrag vertegenwoordigt.

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

Registreert een opstartscriptblok voor een besturingselement dat zich in een UpdatePanel besturingselement bevindt met behulp van het ScriptManager besturingselement en voegt het scriptblok toe aan de pagina.

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

Registreert een opstartscriptblok voor elke asynchrone postback met het ScriptManager besturingselement en voegt het scriptblok toe aan de pagina.

RemovedControl(Control)

Aangeroepen nadat een onderliggend besturingselement is verwijderd uit de Controls verzameling van het Control object.

(Overgenomen van Control)
Render(HtmlTextWriter)

Geeft de inhoud van het ScriptManager besturingselement weer in de browser met behulp van het opgegeven HtmlTextWriter object.

RenderChildren(HtmlTextWriter)

Hiermee wordt de inhoud van de onderliggende elementen van een serverbeheer uitgevoerd naar een opgegeven HtmlTextWriter object, waarmee de inhoud wordt weggeschreven die op de client moet worden weergegeven.

(Overgenomen van Control)
RenderControl(HtmlTextWriter, ControlAdapter)

De server beheert inhoud naar een opgegeven HtmlTextWriter object met behulp van een opgegeven ControlAdapter object.

(Overgenomen van Control)
RenderControl(HtmlTextWriter)

Hiermee wordt inhoud van de server naar een opgegeven HtmlTextWriter object uitgevoerd en wordt traceringsinformatie over het besturingselement opgeslagen als tracering is ingeschakeld.

(Overgenomen van Control)
ResolveAdapter()

Hiermee haalt u de besturingsadapter op die verantwoordelijk is voor het weergeven van het opgegeven besturingselement.

(Overgenomen van Control)
ResolveClientUrl(String)

Hiermee haalt u een URL op die door de browser kan worden gebruikt.

(Overgenomen van Control)
ResolveUrl(String)

Converteert een URL naar een URL die bruikbaar is voor de aanvragende client.

(Overgenomen van Control)
SaveControlState()

Hiermee worden wijzigingen in de status van de servercontrole opgeslagen die zijn opgetreden sinds het moment dat de pagina op de server is geplaatst.

(Overgenomen van Control)
SaveViewState()

Hiermee worden wijzigingen in de weergavestatus van serverbeheer opgeslagen die zijn opgetreden sinds het moment dat de pagina op de server is geplaatst.

(Overgenomen van Control)
SetDesignModeState(IDictionary)

Hiermee stelt u ontwerptijdgegevens in voor een besturingselement.

(Overgenomen van Control)
SetFocus(Control)

Hiermee stelt u de browserfocus in op het opgegeven besturingselement.

SetFocus(String)

Hiermee stelt u de browserfocus in op het besturingselement dat is opgegeven door de id.

SetRenderMethodDelegate(RenderMethod)

Hiermee wijst u een gemachtigde van een gebeurtenishandler toe om het serverbeheer en de inhoud ervan weer te geven in het bovenliggende besturingselement.

(Overgenomen van Control)
SetTraceData(Object, Object, Object)

Hiermee stelt u traceringsgegevens in voor het traceren van renderinggegevens in ontwerptijd, met behulp van het traceringsobject, de traceringsgegevenssleutel en de traceringsgegevenswaarde.

(Overgenomen van Control)
SetTraceData(Object, Object)

Hiermee stelt u traceringsgegevens in voor ontwerptijdtracering van renderinggegevens, met behulp van de traceringsgegevenssleutel en de traceringsgegevenswaarde.

(Overgenomen van Control)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)
TrackViewState()

Veroorzaakt het bijhouden van wijzigingen in de weergavestatus in het serverbesturingselement, zodat deze kunnen worden opgeslagen in het object van StateBag het serverbesturingselement. Dit object is toegankelijk via de ViewState eigenschap.

(Overgenomen van Control)

gebeurtenis

Name Description
AsyncPostBackError

Treedt op wanneer er een paginafout optreedt tijdens een asynchrone postback.

DataBinding

Treedt op wanneer het serverbeheer wordt verbonden met een gegevensbron.

(Overgenomen van Control)
Disposed

Treedt op wanneer een serverbesturing wordt vrijgegeven uit het geheugen. Dit is de laatste fase van de levenscyclus van serverbeheer wanneer een ASP.NET pagina wordt aangevraagd.

(Overgenomen van Control)
Init

Treedt op wanneer het serverbeheer wordt geïnitialiseerd. Dit is de eerste stap in de levenscyclus.

(Overgenomen van Control)
Load

Treedt op wanneer het serverbeheer in het Page object wordt geladen.

(Overgenomen van Control)
Navigate

Treedt op wanneer de gebruiker op de knop Vorige of Doorsturen van de browser klikt.

PreRender

Vindt plaats nadat het object is geladen, maar voordat het Control wordt weergegeven.

(Overgenomen van Control)
ResolveCompositeScriptReference

Treedt op wanneer een samengesteld script is geregistreerd bij het ScriptManager besturingselement.

ResolveScriptReference

Treedt op wanneer een lid van de Scripts verzameling is geregistreerd bij het ScriptManager besturingselement.

Unload

Treedt op wanneer het serverbeheer uit het geheugen wordt verwijderd.

(Overgenomen van Control)

Expliciete interface-implementaties

Name Description
IControlBuilderAccessor.ControlBuilder

Zie voor een beschrijving van dit lid ControlBuilder.

(Overgenomen van Control)
IControlDesignerAccessor.GetDesignModeState()

Zie voor een beschrijving van dit lid GetDesignModeState().

(Overgenomen van Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Zie voor een beschrijving van dit lid SetDesignModeState(IDictionary).

(Overgenomen van Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Zie voor een beschrijving van dit lid SetOwnerControl(Control).

(Overgenomen van Control)
IControlDesignerAccessor.UserData

Zie voor een beschrijving van dit lid UserData.

(Overgenomen van Control)
IDataBindingsAccessor.DataBindings

Zie voor een beschrijving van dit lid DataBindings.

(Overgenomen van Control)
IDataBindingsAccessor.HasDataBindings

Zie voor een beschrijving van dit lid HasDataBindings.

(Overgenomen van Control)
IExpressionsAccessor.Expressions

Zie voor een beschrijving van dit lid Expressions.

(Overgenomen van Control)
IExpressionsAccessor.HasExpressions

Zie voor een beschrijving van dit lid HasExpressions.

(Overgenomen van Control)
IParserAccessor.AddParsedSubObject(Object)

Zie voor een beschrijving van dit lid AddParsedSubObject(Object).

(Overgenomen van Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Zie voor een beschrijving van dit lid LoadPostData(String, NameValueCollection).

IPostBackDataHandler.RaisePostDataChangedEvent()

Zie voor een beschrijving van dit lid RaisePostDataChangedEvent().

IPostBackEventHandler.RaisePostBackEvent(String)

Hiermee kan het ScriptManager besturingselement een postback-gebeurtenis verwerken en de geschiedenisstatus van de webpagina laden.

Extensiemethoden

Name Description
FindDataSourceControl(Control)

Retourneert de gegevensbron die is gekoppeld aan het gegevensbeheer voor het opgegeven besturingselement.

FindFieldTemplate(Control, String)

Retourneert de veldsjabloon voor de opgegeven kolom in de naamgevingscontainer van het opgegeven besturingselement.

FindMetaTable(Control)

Retourneert het metatable-object voor het bevattende gegevensbeheer.

Van toepassing op

Zie ook