ScriptManager Classe

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.Extensions.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Gestisce ASP.NET librerie di script e file di script Ajax, rendering di pagine parziali e generazione di classi proxy client per servizi Web e applicazioni.

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

Ereditarietà: Object

Control
ScriptManager

Attributi: ToolboxBitmapAttribute

Implementazioni: IPostBackDataHandler IPostBackEventHandler

Esempio

Negli esempi seguenti vengono illustrati diversi scenari per l'uso del ScriptManager controllo .

Abilitazione degli aggiornamenti Partial-Page

Nell'esempio seguente viene illustrato come usare il ScriptManager controllo per abilitare gli aggiornamenti a pagina parziale. In questo esempio, un Calendar e un DropDownList controllo si trovano all'interno di un UpdatePanel controllo . Per impostazione predefinita, il valore della UpdateMode proprietà è Alwayse il valore della ChildrenAsTriggers proprietà è true. Pertanto, i controlli figlio del pannello causano un postback asincrono.


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

Gestione degli errori di aggiornamento Partial-Page e registrazione dello script

Nell'esempio seguente viene illustrato come fornire una gestione degli errori personalizzata durante gli aggiornamenti a pagina parziale. Per impostazione predefinita, quando si verifica un errore durante gli aggiornamenti a pagina parziale, viene visualizzata una finestra di messaggio JavaScript. In questo esempio viene illustrato come usare la gestione degli errori personalizzata fornendo un gestore per l'evento AsyncPostBackError e impostando la AsyncPostBackErrorMessage proprietà nel gestore eventi. È anche possibile impostare la AllowCustomErrorsRedirect proprietà per specificare la modalità di utilizzo della sezione degli errori personalizzati del file Web.config quando si verifica un errore durante gli aggiornamenti a pagina parziale. In questo esempio viene usato il valore predefinito della AllowCustomErrorsRedirect proprietà . Ciò significa che se il file Web.config contiene un elemento customErrors , tale elemento determina la modalità di visualizzazione degli errori. Per altre informazioni, vedere elemento customErrors (schema delle impostazioni ASP.NET).

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

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

<script runat="server">

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

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

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

<%@ Page Language="VB" %>

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

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

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

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

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

Globalizzazione della data e dell'ora visualizzate nel browser

Nell'esempio seguente viene illustrato come impostare la EnableScriptGlobalization proprietà in modo che lo script client possa visualizzare una data e un'ora specifiche delle impostazioni cultura nel browser. Nell'esempio l'attributo Culture della direttiva @ Page è impostato su auto. Di conseguenza, la prima lingua specificata nelle impostazioni correnti del browser determina le impostazioni cultura e le impostazioni cultura dell'interfaccia utente per la pagina. Per altre informazioni, vedere Procedura: Impostare le impostazioni cultura e le impostazioni cultura dell'interfaccia utente per ASP.NET globalizzazione delle pagine Web.

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

Commenti

In questo argomento:

Introduzione
renderingPartial-Page
Uso del controllo ScriptManager con pagine master, controlli utente e altri componenti figlio
Gestione e registrazione di script
Riferimenti al servizio Web
Localizzazione
gestione degli errori
Sintassi dichiarativa

Introduzione

Il ScriptManager controllo è fondamentale per la funzionalità Ajax in ASP.NET. Il controllo gestisce tutte le risorse ASP.NET Ajax in una pagina. Ciò include il download degli script della libreria Microsoft Ajax nel browser e il coordinamento degli aggiornamenti a pagina parziale abilitati tramite UpdatePanel controlli. Inoltre, il ScriptManager controllo consente di eseguire le operazioni seguenti:

Registrare lo script compatibile con gli aggiornamenti a pagina parziale. Per gestire le dipendenze tra lo script e la libreria principale, qualsiasi script registrato viene caricato dopo lo script della libreria Microsoft Ajax.
Specificare se gli script di rilascio o debug vengono inviati al browser.
Fornire l'accesso ai metodi del servizio Web dallo script registrando i servizi Web con il ScriptManager controllo .
Fornire l'accesso ai servizi di autenticazione, ruolo e profilatura di ASP.NET dallo script client registrando questi servizi con il ScriptManager controllo .
Abilitare la visualizzazione specifica delle impostazioni cultura delle funzioni Date, Number e String ECMAScript (JavaScript) nel browser.
Accedere alle risorse di localizzazione per i file di script incorporati o per i file di script autonomi usando la ResourceUICultures proprietà del ScriptReference controllo .
Registrare i controlli server che implementano le IExtenderControl interfacce o IScriptControl con il controllo in modo che venga eseguito il ScriptManager rendering dello script richiesto dai componenti client e dai comportamenti.

rendering Partial-Page

La possibilità di una pagina ASP.NET di supportare il rendering di pagine parziali è controllata dai fattori seguenti:

La ScriptManager proprietà del EnablePartialRendering controllo deve essere true (il valore predefinito).
Nella pagina deve essere presente almeno un UpdatePanel controllo.
La SupportsPartialRendering proprietà deve essere true (valore predefinito). Se la SupportsPartialRendering proprietà non è impostata in modo esplicito, il relativo valore è basato sulle funzionalità del browser.

È possibile eseguire l'override del valore della proprietà in fase di EnablePartialRendering esecuzione durante o prima dell'evento della Init pagina. Se si tenta di modificare questa proprietà dopo che si è verificato l'evento della Init pagina, viene generata un'eccezione InvalidOperationException .

Quando il rendering parziale della pagina è supportato, il controllo esegue il ScriptManager rendering dello script per abilitare postback asincroni e aggiornamenti di pagine parziali. Le aree della pagina da aggiornare vengono designate utilizzando UpdatePanel i controlli . Il ScriptManager controllo gestisce i postback asincroni e aggiorna solo le aree della pagina che devono essere aggiornate. Per altre informazioni sul rendering a pagina parziale, vedere Partial-Page Panoramica del rendering. Per altre informazioni sulle condizioni che causano un aggiornamento, vedere Cenni preliminari sul controllo UpdatePanel.

Uso del controllo ScriptManager con pagine master, controlli utente e altri componenti figlio

Una pagina può contenere un ScriptManager solo controllo nella gerarchia. Per registrare servizi e script per pagine annidate, controlli utente o componenti quando la pagina padre dispone già di un ScriptManager controllo, utilizzare il ScriptManagerProxy controllo . Per altre informazioni, vedere Uso del controllo UpdatePanel con le pagine master.

Gestione e registrazione di script

Il ScriptManager controllo consente di registrare lo script di cui viene quindi eseguito il rendering come parte della pagina. I ScriptManager metodi di registrazione del controllo possono essere suddivisi nelle tre categorie seguenti:

I metodi di registrazione che garantiscono che le dipendenze degli script nella libreria Microsoft Ajax vengano mantenute.
Metodi di registrazione che non dipendono dalla libreria Microsoft Ajax, ma compatibili con UpdatePanel i controlli.
Metodi di registrazione che supportano l'uso dei UpdatePanel controlli.

Per altre informazioni su come creare e usare script Ajax in ASP.NET, vedere Creazione di script client personalizzati tramite la libreria Microsoft Ajax.

Registrazione di script dipendenti dalla libreria Microsoft Ajax

È possibile utilizzare i metodi seguenti per registrare i file di script in modo da garantire che vengano mantenute tutte le dipendenze della libreria Microsoft Ajax.

metodo	Definizione
RegisterScriptControl	Registra un controllo server che implementa l'interfaccia IScriptControl utilizzata per definire un oggetto client Sys.Component . Il controllo esegue il ScriptManager rendering dello script che supporta l'oggetto client.
RegisterExtenderControl	Registra un controllo server che implementa l'interfaccia IExtenderControl utilizzata per definire un oggetto client Sys.Component . Il controllo esegue il ScriptManager rendering dello script che supporta l'oggetto client.

Registrazione di script compatibili con gli aggiornamenti di Partial-Page

È possibile usare i metodi seguenti per registrare i file di script che non dipendono dalla libreria Microsoft Ajax, ma compatibili con UpdatePanel i controlli. Questi metodi corrispondono a metodi simili del ClientScriptManager controllo. Se si esegue il rendering dello script da usare all'interno di un UpdatePanel controllo, assicurarsi di chiamare i metodi del ScriptManager controllo.

metodo	Definizione
RegisterArrayDeclaration	Aggiunge un valore a una matrice JavaScript. Se la matrice non esiste, viene creata.
RegisterClientScriptBlock	Esegue il rendering di un `script` elemento dopo il tag di apertura `<form>` della pagina. Lo script viene specificato come parametro stringa.
RegisterClientScriptInclude	Esegue il rendering di un `script` elemento dopo il tag di apertura `<form>` della pagina. Il contenuto dello script viene specificato impostando l'attributo `src` su un URL che punta a un file di script.
RegisterClientScriptResource	Esegue il rendering di un `script` elemento dopo il tag di apertura `<form>` della pagina. Il contenuto dello script viene specificato con un nome di risorsa in un assembly. L'attributo `src` viene popolato automaticamente con un URL tramite una chiamata a un gestore HTTP che recupera lo script denominato dall'assembly.
RegisterExpandoAttribute	Esegue il rendering di una coppia di attributi nome/valore personalizzata (expando) nel markup per un controllo specificato.
RegisterHiddenField	Esegue il rendering di un campo nascosto.
RegisterOnSubmitStatement	Registra uno script eseguito in risposta all'evento `form` dell'elemento `submit` . L'attributo `onSubmit` fa riferimento allo script specificato.
RegisterStartupScript	Esegue il rendering di un blocco di script di avvio subito prima del tag di chiusura `</form>` della pagina. Lo script di cui eseguire il rendering viene specificato come parametro stringa.

Quando si registrano i metodi, si specifica una coppia di tipi/chiavi per tale script. Se uno script con lo stesso tipo/coppia di chiavi è già registrato, non viene registrato un nuovo script. Analogamente, se si registra uno script con una coppia di nomi di tipo/risorsa già esistente, l'elemento script che fa riferimento alla risorsa non viene aggiunto di nuovo. Quando si registra un attributo expando di un attributo registrato in precedenza, viene generata un'eccezione. È consentita la registrazione duplicata dei valori di matrice.

Quando si chiama o RegisterClientScriptInclude il RegisterClientScriptResource metodo , evitare di registrare lo script che esegue funzioni inline. Registrare invece script che contiene definizioni di funzione come gestori eventi o definizioni di classi personalizzate per l'applicazione.

Metodi di registrazione per i controlli UpdatePanel

È possibile usare i metodi seguenti per personalizzare gli aggiornamenti a pagina parziale quando si usano UpdatePanel i controlli.

metodo	Definizione
RegisterAsyncPostBackControl	Registra un controllo come trigger per i postback asincroni.
RegisterDataItem	Invia dati personalizzati ai controlli durante il rendering di pagine parziali.
RegisterDispose	Registra uno script dispose per un controllo che si trova all'interno di un UpdatePanel controllo . Lo script viene eseguito quando il UpdatePanel controllo viene aggiornato o eliminato. Il metodo dispose viene usato per i componenti client che fanno parte della libreria Microsoft Ajax e che devono liberare risorse quando un componente non viene più usato.
RegisterPostBackControl	Registra un controllo come trigger per un postback completo. Questo metodo viene usato per i controlli all'interno di un UpdatePanel controllo che altrimenti esegue postback asincroni.

Riferimenti al servizio Web

È possibile registrare un servizio Web da chiamare dallo script client creando un ServiceReference oggetto e aggiungendolo alla Services raccolta del ScriptManager controllo. ASP.NET genera un oggetto proxy client per ogni ServiceReference oggetto nell'insieme Services . È possibile aggiungere ServiceReference oggetti alla raccolta a Services livello di codice per registrare i servizi Web in fase di esecuzione.

Per altre informazioni su come accedere ai servizi Web nello script, vedere Esposizione di servizi Web allo script client in ASP.NET AJAX e Chiamata di servizi Web da script client in ASP.NET AJAX.

Localization

Il ScriptManager controllo genera riferimenti nella pagina sottoposta a rendering che puntano ai file di script localizzati appropriati, ovvero file di script incorporati negli assembly o nei file di script autonomi.

Quando la EnableScriptLocalization proprietà è impostata su true, il ScriptManager controllo recupera le risorse localizzate (ad esempio le stringhe localizzate) per le impostazioni cultura correnti, se esistenti. Il ScriptManager controllo fornisce le funzionalità seguenti per l'uso di risorse localizzate:

File di script incorporati in un assembly. Il ScriptManager controllo determina quale file di script di impostazioni cultura o impostazioni cultura di fallback inviare al browser. Questa operazione viene eseguita usando l'attributo assembly specifico NeutralResourcesLanguageAttribute delle impostazioni cultura, le risorse incluse nell'assembly e le impostazioni cultura dell'interfaccia utente del browser (se presenti).
File di script autonomi. Il ScriptManager controllo definisce l'elenco delle impostazioni cultura dell'interfaccia utente supportate tramite la ResourceUICultures proprietà dell'oggetto ScriptReference .
In modalità di debug. Il controllo tenta di eseguire il ScriptManager rendering di un file di script specifico delle impostazioni cultura che contiene informazioni di debug. Ad esempio, se la pagina è in modalità di debug e le impostazioni cultura correnti sono impostate su en-MX, il controllo esegue il rendering di un file di script con un nome come scriptname.en-MX.debug.js, se il file esiste. Se il file non esiste, viene eseguito il rendering del file di debug per le impostazioni cultura di fallback appropriate

Per altre informazioni su come localizzare le risorse, vedere Localizing Resources for Component Libraries Overview.For more information about how to localize resources for Component Libraries Overview.

Gestione degli errori

Quando si verifica un errore di pagina durante i postback asincroni, viene generato l'evento AsyncPostBackError . Il modo in cui gli errori nel server vengono inviati al client dipende dalla AllowCustomErrorsRedirect proprietà, dalla AsyncPostBackErrorMessage proprietà e dalla sezione degli errori personalizzati del file Web.config. Per altre informazioni, vedere Personalizzazione della gestione degli errori per i controlli UpdatePanel.

Sintassi dichiarativa

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

Costruttori

Nome	Descrizione
ScriptManager()	Inizializza una nuova istanza della classe ScriptManager.

Proprietà

Nome	Descrizione
Adapter	Ottiene l'adattatore specifico del browser per il controllo . (Ereditato da Control)
AjaxFrameworkAssembly	Ottiene l'assembly del framework Ajax utilizzato dai componenti nella pagina.
AjaxFrameworkMode	Ottiene o imposta un valore che specifica il modo in cui gli script client della libreria client Microsoft Ajax verranno inclusi nel client.
AllowCustomErrorsRedirect	Ottiene o imposta un valore che determina se la sezione degli errori personalizzati del file Web.config viene utilizzata durante un errore in un postback asincrono.
AppRelativeTemplateSourceDirectory	Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl che contiene questo controllo. (Ereditato da Control)
AsyncPostBackErrorMessage	Ottiene o imposta il messaggio di errore inviato al client quando si verifica un'eccezione server non gestita durante un postback asincrono.
AsyncPostBackSourceElementID	Ottiene l'ID univoco del controllo che ha causato il postback asincrono.
AsyncPostBackTimeout	Ottiene o imposta un valore che indica il tempo, espresso in secondi, prima del timeout dei postback asincroni se non viene ricevuta alcuna risposta.
AuthenticationService	Ottiene l'oggetto AuthenticationServiceManager associato all'istanza corrente ScriptManager .
BindingContainer	Ottiene il controllo che contiene il data binding di questo controllo. (Ereditato da Control)
ChildControlsCreated	Ottiene un valore che indica se sono stati creati i controlli figlio del controllo server. (Ereditato da Control)
ClientID	Ottiene l'ID di controllo per il markup HTML generato da ASP.NET. (Ereditato da Control)
ClientIDMode	Ottiene o imposta l'algoritmo utilizzato per generare il valore della ClientID proprietà . (Ereditato da Control)
ClientIDSeparator	Ottiene un valore di carattere che rappresenta il carattere separatore utilizzato nella ClientID proprietà . (Ereditato da Control)
ClientNavigateHandler	Ottiene o imposta il nome del metodo che gestisce l'evento Sys.Application.navigate nel client.
CompositeScript	Ottiene un riferimento allo script composito che supporta la pagina Web.
Context	Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
Controls	Ottiene un ControlCollection oggetto che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da Control)
DataItemContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
DataKeysContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
DesignMode	Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control)
EmptyPageUrl	Ottiene o imposta un URL su una pagina Web vuota.
EnableCdn	Determina se la pagina corrente carica i riferimenti allo script client dai percorsi della rete CDN (Rete per la distribuzione di contenuti).
EnableCdnFallback	Consente il caricamento della copia locale di uno script nel caso in cui la rete cdn (rete per la distribuzione di contenuti) non sia disponibile.
EnableHistory	Ottiene o imposta un valore che indica se la pagina Web supporta la gestione dei punti di cronologia.
EnablePageMethods	Ottiene o imposta un valore che indica se i metodi di pagina statici pubblici in una pagina ASP.NET possono essere chiamati dallo script client.
EnablePartialRendering	Ottiene o imposta un valore che consente il rendering parziale di una pagina, che a sua volta consente di aggiornare le aree della pagina singolarmente usando UpdatePanel i controlli .
EnableScriptGlobalization	Ottiene o imposta un valore che indica se il controllo esegue il ScriptManager rendering dello script che supporta l'analisi e la formattazione di informazioni specifiche delle impostazioni cultura.
EnableScriptLocalization	Ottiene o imposta un valore che indica se il controllo esegue il ScriptManager rendering delle versioni localizzate dei file di script.
EnableSecureHistoryState	Ottiene o imposta un valore che indica se crittografare la stringa di stato della cronologia.
EnableTheming	Ottiene o imposta un valore che indica se i temi si applicano a questo controllo. (Ereditato da Control)
EnableViewState	Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione di tutti i controlli figlio contenuti, al client richiedente. (Ereditato da Control)
Events	Ottiene un elenco di delegati del gestore eventi per il controllo . Questa proprietà è di sola lettura. (Ereditato da Control)
HasChildViewState	Ottiene un valore che indica se i controlli figlio del controllo server corrente hanno impostazioni dello stato di visualizzazione salvate. (Ereditato da Control)
ID	Ottiene o imposta l'identificatore programmatico assegnato al controllo server. (Ereditato da Control)
IdSeparator	Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control)
IsChildControlStateCleared	Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo hanno uno stato di controllo. (Ereditato da Control)
IsDebuggingEnabled	Ottiene un valore che indica se verrà eseguito il rendering delle versioni di debug delle librerie di script client.
IsInAsyncPostBack	Ottiene un valore che indica se il postback corrente viene eseguito in modalità di rendering parziale.
IsNavigating	Ottiene un valore che indica se un Navigate evento è attualmente gestito.
IsTrackingViewState	Ottiene un valore che indica se il controllo server salva le modifiche apportate allo stato di visualizzazione. (Ereditato da Control)
IsViewStateEnabled	Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo. (Ereditato da Control)
LoadScriptsBeforeUI	Ottiene o imposta un valore che indica se gli script vengono caricati prima o dopo il markup per l'interfaccia utente della pagina.
LoadViewStateByID	Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione in ID base al posto dell'indice. (Ereditato da Control)
NamingContainer	Ottiene un riferimento al contenitore di denominazione del controllo server, che crea uno spazio dei nomi univoco per la differenziazione tra i controlli server con lo stesso ID valore della proprietà. (Ereditato da Control)
Page	Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control)
Parent	Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli pagina. (Ereditato da Control)
ProfileService	Ottiene l'oggetto ProfileServiceManager associato all'istanza corrente ScriptManager .
RenderingCompatibility	Ottiene un valore che specifica la versione ASP.NET con cui è stato eseguito il rendering del codice HTML sarà compatibile. (Ereditato da Control)
RoleService	Ottiene l'oggetto RoleServiceManager associato all'istanza corrente ScriptManager .
ScriptMode	Ottiene o imposta un valore che specifica se viene eseguito il rendering delle versioni di debug o di rilascio delle librerie di script client.
ScriptPath	Obsoleti. Ottiene o imposta il percorso radice del percorso utilizzato per compilare i percorsi per ASP.NET Ajax e i file di script personalizzati.
ScriptResourceMapping	Ottiene un ScriptResourceMapping oggetto .
Scripts	Ottiene un ScriptReferenceCollection oggetto che contiene gli ScriptReference oggetti , ognuno dei quali rappresenta un file di script di cui viene eseguito il rendering al client.
Services	Ottiene un ServiceReferenceCollection oggetto che contiene un ServiceReference oggetto per ogni servizio Web che ASP.NET espone nel client per la funzionalità Ajax.
Site	Ottiene informazioni sul contenitore che ospita il controllo corrente durante il rendering in un'area di progettazione. (Ereditato da Control)
SkinID	Ottiene o imposta l'interfaccia da applicare al controllo. (Ereditato da Control)
SupportsPartialRendering	Ottiene un valore che indica se il client supporta il rendering di pagine parziali.
TemplateControl	Ottiene o imposta un riferimento al modello che contiene questo controllo. (Ereditato da Control)
TemplateSourceDirectory	Ottiene la directory virtuale dell'oggetto Page o UserControl che contiene il controllo server corrente. (Ereditato da Control)
UniqueID	Ottiene l'identificatore univoco e qualificato gerarchicamente per il controllo server. (Ereditato da Control)
ValidateRequestMode	Ottiene o imposta un valore che indica se il controllo controlla l'input client dal browser per individuare valori potenzialmente pericolosi. (Ereditato da Control)
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste per la stessa pagina. (Ereditato da Control)
ViewStateIgnoresCase	Ottiene un valore che indica se l'oggetto StateBag non fa distinzione tra maiuscole e minuscole. (Ereditato da Control)
ViewStateMode	Ottiene o imposta la modalità dello stato di visualizzazione di questo controllo. (Ereditato da Control)
Visible	Esegue l'override della Visible proprietà ereditata dalla classe base Control per impedire l'impostazione di questo valore.

Metodi

Nome	Descrizione
AddedControl(Control, Int32)	Chiamato dopo l'aggiunta di un controllo figlio all'insieme Controls dell'oggetto Control . (Ereditato da Control)
AddHistoryPoint(NameValueCollection, String)	Crea un punto di cronologia e lo aggiunge allo stack di cronologia del browser, usando la raccolta dati di stato e il titolo dello stato specificati.
AddHistoryPoint(String, String, String)	Crea un punto di cronologia e lo aggiunge allo stack di cronologia del browser, usando la chiave di stato, il valore dello stato e il titolo dello stato specificati.
AddHistoryPoint(String, String)	Crea un punto di cronologia e lo aggiunge allo stack di cronologia del browser, usando la chiave di stato e il valore di stato specificati.
AddParsedSubObject(Object)	Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto del ControlCollection controllo server. (Ereditato da Control)
ApplyStyleSheetSkin(Page)	Applica le proprietà di stile definite nel foglio di stile della pagina al controllo . (Ereditato da Control)
BeginRenderTracing(TextWriter, Object)	Inizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
BuildProfileTree(String, Boolean)	Raccoglie informazioni sul controllo server e le distribuisce alla Trace proprietà da visualizzare quando la traccia è abilitata per la pagina. (Ereditato da Control)
ClearCachedClientID()	Imposta il valore memorizzato nella ClientID cache su `null`. (Ereditato da Control)
ClearChildControlState()	Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control)
ClearChildState()	Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearChildViewState()	Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearEffectiveClientIDMode()	Imposta la ClientIDMode proprietà dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control)
CreateChildControls()	Chiamato dal framework di pagina ASP.NET per notificare ai controlli server che usano l'implementazione basata sulla composizione per creare tutti i controlli figlio che contengono in preparazione alla registrazione o al rendering. (Ereditato da Control)
CreateControlCollection()	Crea un nuovo ControlCollection oggetto per contenere i controlli figlio (sia letterali che server) del controllo server. (Ereditato da Control)
DataBind()	Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. (Ereditato da Control)
DataBind(Boolean)	Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding . (Ereditato da Control)
DataBindChildren()	Associa un'origine dati ai controlli figlio del controllo server. (Ereditato da Control)
Dispose()	Consente a un controllo server di eseguire la pulizia finale prima che venga rilasciata dalla memoria. (Ereditato da Control)
EndRenderTracing(TextWriter, Object)	Termina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
EnsureChildControls()	Determina se il controllo server contiene controlli figlio. In caso contrario, crea controlli figlio. (Ereditato da Control)
EnsureID()	Crea un identificatore per i controlli a cui non è assegnato un identificatore. (Ereditato da Control)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindControl(String, Int32)	Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato `id` e un numero intero, specificato nel `pathOffset` parametro , che facilita la ricerca. Non è consigliabile eseguire l'override di questa versione del FindControl metodo . (Ereditato da Control)
FindControl(String)	Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato `id` . (Ereditato da Control)
Focus()	Imposta lo stato attivo dell'input su un controllo . (Ereditato da Control)
GetCurrent(Page)	Ottiene l'istanza ScriptManager di un determinato Page oggetto.
GetDesignModeState()	Ottiene i dati in fase di progettazione per un controllo . (Ereditato da Control)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetRegisteredArrayDeclarations()	Recupera una raccolta di sola lettura di dichiarazioni di matrice ECMAScript (JavaScript) precedentemente registrate con l'oggetto Page .
GetRegisteredClientScriptBlocks()	Recupera una raccolta di sola lettura di blocchi di script client registrati in precedenza con il ScriptManager controllo .
GetRegisteredDisposeScripts()	Recupera una raccolta di sola lettura di `dispose` script registrati in precedenza con l'oggetto Page .
GetRegisteredExpandoAttributes()	Recupera una raccolta di sola lettura di attributi personalizzati (expando) registrati in precedenza con l'oggetto Page .
GetRegisteredHiddenFields()	Recupera una raccolta di sola lettura di campi nascosti registrati in precedenza con l'oggetto Page .
GetRegisteredOnSubmitStatements()	Recupera una raccolta di sola lettura di `onsubmit` istruzioni registrate in precedenza con l'oggetto Page .
GetRegisteredStartupScripts()	Recupera una raccolta di sola lettura di script di avvio precedentemente registrati con l'oggetto Page .
GetRouteUrl(Object)	Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(String, Object)	Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control)
GetStateString()	Recupera una stringa che contiene coppie chiave/valore che rappresentano lo stato della pagina Web.
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
GetUniqueIDRelativeTo(Control)	Restituisce la parte con prefisso della UniqueID proprietà del controllo specificato. (Ereditato da Control)
HasControls()	Determina se il controllo server contiene controlli figlio. (Ereditato da Control)
HasEvents()	Restituisce un valore che indica se gli eventi vengono registrati per il controllo o per i controlli figlio. (Ereditato da Control)
IsLiteralContent()	Determina se il controllo server contiene solo contenuto letterale. (Ereditato da Control)
LoadControlState(Object)	Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal SaveControlState() metodo . (Ereditato da Control)
LoadPostData(String, NameValueCollection)	Legge i dati del modulo inviati dal browser al server e determina l'origine del postback asincrono.
LoadViewState(Object)	Ripristina le informazioni sullo stato di visualizzazione da una richiesta di pagina precedente salvata dal SaveViewState() metodo . (Ereditato da Control)
MapPathSecure(String)	Recupera il percorso fisico a cui viene mappato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)	Genera l'evento AsyncPostBackError.
OnBubbleEvent(Object, EventArgs)	Determina se l'evento per il controllo server viene passato alla gerarchia di controllo server dell'interfaccia utente della pagina. (Ereditato da Control)
OnDataBinding(EventArgs)	Genera l'evento DataBinding. (Ereditato da Control)
OnInit(EventArgs)	Genera l'evento Init e verifica che nella pagina esista un ScriptManager solo controllo.
OnLoad(EventArgs)	Genera l'evento Load. (Ereditato da Control)
OnPreRender(EventArgs)	Genera l'evento PreRender e registra i file di script e i servizi per gli aggiornamenti a pagina parziale.
OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)	Genera l'evento ResolveCompositeScriptReference.
OnResolveScriptReference(ScriptReferenceEventArgs)	Genera l'evento ResolveScriptReference per ogni riferimento di script gestito dal ScriptManager controllo .
OnUnload(EventArgs)	Genera l'evento Unload. (Ereditato da Control)
OpenFile(String)	Ottiene un Stream oggetto utilizzato per leggere un file. (Ereditato da Control)
RaiseBubbleEvent(Object, EventArgs)	Assegna tutte le origini dell'evento e le relative informazioni all'elemento padre del controllo. (Ereditato da Control)
RaisePostBackEvent(String)	Elabora un evento di postback generato dal ScriptManager controllo e carica lo stato della cronologia della pagina Web.
RaisePostDataChangedEvent()	Genera eventi per il ScriptManager controllo quando esegue il postback al server.
RegisterArrayDeclaration(Control, String, String)	Registra una dichiarazione di matrice ECMAScript (JavaScript) con il ScriptManager controllo da usare con un controllo che si trova all'interno di un UpdatePanel controllo e aggiunge la matrice alla pagina.
RegisterArrayDeclaration(Page, String, String)	Registra una dichiarazione di matrice ECMAScript (JavaScript) con il ScriptManager controllo da usare con un controllo che si trova all'interno di un UpdatePanel controllo e aggiunge la matrice alla pagina.
RegisterAsyncPostBackControl(Control)	Registra un controllo come trigger per i postback asincroni.
RegisterClientScriptBlock(Control, Type, String, String, Boolean)	Registra un blocco di script client con il ScriptManager controllo da usare con un controllo che si trova all'interno di un UpdatePanel controllo e quindi aggiunge il blocco di script alla pagina.
RegisterClientScriptBlock(Page, Type, String, String, Boolean)	Registra un blocco di script client con il ScriptManager controllo da usare con un controllo che si trova all'interno di un UpdatePanel controllo e quindi aggiunge il blocco di script alla pagina.
RegisterClientScriptInclude(Control, Type, String, String)	Registra un file di script client con il ScriptManager controllo da utilizzare con un controllo che si trova all'interno di un UpdatePanel controllo e quindi aggiunge un riferimento al file di script alla pagina.
RegisterClientScriptInclude(Page, Type, String, String)	Registra lo script client con il ScriptManager controllo ogni volta che si verifica un postback asincrono e quindi aggiunge un riferimento al file di script alla pagina.
RegisterClientScriptResource(Control, Type, String)	Registra lo script client incorporato in un assembly con il ScriptManager controllo da usare con un controllo che partecipa al rendering parziale della pagina.
RegisterClientScriptResource(Page, Type, String)	Registra un file di script client incorporato in un assembly con il ScriptManager controllo ogni volta che si verifica un postback.
RegisterDataItem(Control, String, Boolean)	Invia dati personalizzati a un controllo durante il rendering di pagine parziali e indica se i dati sono in formato JSON (JavaScript Object Notation).
RegisterDataItem(Control, String)	Invia dati personalizzati a un controllo durante il rendering di pagine parziali.
RegisterDispose(Control, String)	Registra uno `dispose` script per un controllo che si trova all'interno di un UpdatePanel controllo . Lo script viene eseguito quando il UpdatePanel controllo viene aggiornato o eliminato.
RegisterExpandoAttribute(Control, String, String, String, Boolean)	Registra una coppia nome/valore con il ScriptManager controllo come attributo personalizzato (expando) di un controllo specificato.
RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)	Registra un controllo extender con l'istanza corrente ScriptManager .
RegisterHiddenField(Control, String, String)	Registra un campo nascosto con il ScriptManager controllo per un controllo che si trova all'interno di un UpdatePanel controllo .
RegisterHiddenField(Page, String, String)	Registra un campo nascosto con il ScriptManager controllo durante ogni postback asincrono.
RegisterNamedClientScriptResource(Control, String)	Registra lo script client in base al nome della risorsa incorporato in un assembly con il ScriptManager controllo da usare con un controllo che partecipa al rendering a pagina parziale.
RegisterNamedClientScriptResource(Page, String)	Registra lo script client in base al nome della risorsa incorporato in un assembly con il ScriptManager controllo da usare con un controllo che partecipa al rendering a pagina parziale.
RegisterOnSubmitStatement(Control, Type, String, String)	Registra il codice ECMAScript (JavaScript) con il ScriptManager controllo per un controllo utilizzato con un UpdatePanel controllo eseguito quando viene inviato il modulo.
RegisterOnSubmitStatement(Page, Type, String, String)	Registra il codice ECMAScript (JavaScript) con il ScriptManager controllo per un controllo utilizzato con un UpdatePanel controllo eseguito quando viene inviato il modulo.
RegisterPostBackControl(Control)	Registra un controllo come trigger per un postback. Questo metodo viene usato per configurare i controlli di postback all'interno di un UpdatePanel controllo che altrimenti eseguirebbe postback asincroni.
RegisterScriptControl<TScriptControl>(TScriptControl)	Registra un controllo script con l'istanza corrente ScriptManager .
RegisterScriptDescriptors(IExtenderControl)	Richiama a una ExtenderControl classe per restituire script di istanza di cui è necessario eseguire il rendering per supportare l'oggetto client che rappresenta un controllo client, un componente o un comportamento.
RegisterScriptDescriptors(IScriptControl)	Chiama una ScriptControl classe per restituire script di istanza di cui è necessario eseguire il rendering per supportare l'oggetto client che rappresenta un controllo client, un componente o un comportamento.
RegisterStartupScript(Control, Type, String, String, Boolean)	Registra un blocco di script di avvio per un controllo che si trova all'interno di un UpdatePanel oggetto utilizzando il ScriptManager controllo e aggiunge il blocco di script alla pagina.
RegisterStartupScript(Page, Type, String, String, Boolean)	Registra un blocco di script di avvio per ogni postback asincrono con il ScriptManager controllo e aggiunge il blocco di script alla pagina.
RemovedControl(Control)	Chiamato dopo che un controllo figlio viene rimosso dall'insieme Controls dell'oggetto Control . (Ereditato da Control)
Render(HtmlTextWriter)	Esegue il rendering del ScriptManager contenuto del controllo nel browser utilizzando l'oggetto specificato HtmlTextWriter .
RenderChildren(HtmlTextWriter)	Restituisce il contenuto degli elementi figlio di un controllo server in un oggetto fornito HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter . (Ereditato da Control)
RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata. (Ereditato da Control)
ResolveAdapter()	Ottiene l'adattatore di controllo responsabile del rendering del controllo specificato. (Ereditato da Control)
ResolveClientUrl(String)	Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
ResolveUrl(String)	Converte un URL in un URL utilizzabile nel client richiedente. (Ereditato da Control)
SaveControlState()	Salva le modifiche apportate allo stato del controllo server dopo il postback della pagina al server. (Ereditato da Control)
SaveViewState()	Salva le modifiche apportate allo stato di visualizzazione controllo server dopo il postback della pagina al server. (Ereditato da Control)
SetDesignModeState(IDictionary)	Imposta i dati in fase di progettazione per un controllo . (Ereditato da Control)
SetFocus(Control)	Imposta lo stato attivo del browser sul controllo specificato.
SetFocus(String)	Imposta lo stato attivo del browser sul controllo specificato dall'ID.
SetRenderMethodDelegate(RenderMethod)	Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control)
SetTraceData(Object, Object, Object)	Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
SetTraceData(Object, Object)	Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TrackViewState()	Determina il rilevamento delle modifiche dello stato di visualizzazione al controllo server in modo che possano essere archiviate nell'oggetto del StateBag controllo server. Questo oggetto è accessibile tramite la ViewState proprietà . (Ereditato da Control)

Eventi

Nome	Descrizione
AsyncPostBackError	Si verifica quando si verifica un errore di pagina durante un postback asincrono.
DataBinding	Si verifica quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
Disposed	Si verifica quando viene rilasciato un controllo server dalla memoria, ovvero l'ultima fase del ciclo di vita del controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control)
Init	Si verifica quando il controllo server viene inizializzato, ovvero il primo passaggio del ciclo di vita. (Ereditato da Control)
Load	Si verifica quando il controllo server viene caricato nell'oggetto Page . (Ereditato da Control)
Navigate	Si verifica quando l'utente fa clic sul pulsante Indietro o Avanti del browser.
PreRender	Si verifica dopo il caricamento dell'oggetto Control , ma prima del rendering. (Ereditato da Control)
ResolveCompositeScriptReference	Si verifica quando uno script composito viene registrato con il ScriptManager controllo .
ResolveScriptReference	Si verifica quando un membro della Scripts raccolta viene registrato con il ScriptManager controllo .
Unload	Si verifica quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IControlBuilderAccessor.ControlBuilder	Per una descrizione di questo membro, vedere ControlBuilder. (Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()	Per una descrizione di questo membro, vedere GetDesignModeState(). (Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary). (Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Per una descrizione di questo membro, vedere SetOwnerControl(Control). (Ereditato da Control)
IControlDesignerAccessor.UserData	Per una descrizione di questo membro, vedere UserData. (Ereditato da Control)
IDataBindingsAccessor.DataBindings	Per una descrizione di questo membro, vedere DataBindings. (Ereditato da Control)
IDataBindingsAccessor.HasDataBindings	Per una descrizione di questo membro, vedere HasDataBindings. (Ereditato da Control)
IExpressionsAccessor.Expressions	Per una descrizione di questo membro, vedere Expressions. (Ereditato da Control)
IExpressionsAccessor.HasExpressions	Per una descrizione di questo membro, vedere HasExpressions. (Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)	Per una descrizione di questo membro, vedere AddParsedSubObject(Object). (Ereditato da Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Per una descrizione di questo membro, vedere LoadPostData(String, NameValueCollection).
IPostBackDataHandler.RaisePostDataChangedEvent()	Per una descrizione di questo membro, vedere RaisePostDataChangedEvent().
IPostBackEventHandler.RaisePostBackEvent(String)	Consente al ScriptManager controllo di elaborare un evento di postback e di caricare lo stato della cronologia della pagina Web.

Metodi di estensione

Nome	Descrizione
FindDataSourceControl(Control)	Restituisce l'origine dati associata al controllo dati per il controllo specificato.
FindFieldTemplate(Control, String)	Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.
FindMetaTable(Control)	Restituisce l'oggetto metatable per il controllo dati contenitore.

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?