ScriptManager Classe
Definizione
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 librerie di script e file di script, il rendering parziale della pagina e la generazione della classe proxy client per servizi Web e applicativi ASP.NET Ajax.
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 IPostBackEventHandlerPublic Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler- Ereditarietà
- Attributi
- Implementazioni
Esempio
Negli esempi seguenti vengono illustrati diversi scenari per l'uso del ScriptManager controllo.
Abilitazione di Partial-Page Aggiornamenti
Nell'esempio seguente viene illustrato come usare il ScriptManager controllo per abilitare gli aggiornamenti della pagina parziale. In questo esempio, un Calendar oggetto e un controllo si trovano all'interno di un DropDownListUpdatePanel 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 la gestione degli errori personalizzati durante gli aggiornamenti di una 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 proprietà per specificare come viene usata la AllowCustomErrorsRedirect sezione errori personalizzati del file Web.config quando si verifica un errore durante gli aggiornamenti di una 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 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 visualizzata 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 del browser corrente determina le impostazioni cultura e le impostazioni dell'interfaccia utente per la pagina. Per altre informazioni, vedere Procedura: Impostare impostazioni cultura e impostazioni cultura dell'interfaccia utente per ASP.NET globalizzazione pagina 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
Il ScriptManager controllo è centrale per la funzionalità Ajax in ASP.NET. Il controllo gestisce tutte le risorse Ajax ASP.NET in una pagina. Ciò include il download degli script di Microsoft Ajax Library nel browser e il coordinamento degli aggiornamenti a pagina parziale abilitati usando UpdatePanel i controlli. Inoltre, il ScriptManager controllo consente di eseguire le operazioni seguenti:
Registrare lo script compatibile con gli aggiornamenti di pagina parziale. Per gestire le dipendenze tra lo script e la libreria di base, qualsiasi script registrato viene caricato dopo lo script di Microsoft Ajax Library.
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 applicazione di ASP.NET autenticazione, ruolo e profilo dallo script client registrando questi servizi con il ScriptManager controllo.
Abilitare la visualizzazione specifica delle impostazioni cultura di ECMAScript (JavaScript) Funzioni Date, Number e String 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 di ASP.NET per supportare il rendering di pagine parziali è controllata dai fattori seguenti:
La ScriptManager proprietà del EnablePartialRendering controllo deve essere
true(il valore predefinito).Deve essere presente almeno un UpdatePanel controllo nella pagina.
La SupportsPartialRendering proprietà deve essere
true(il valore predefinito). Se la proprietà non è impostata in modo esplicito, il SupportsPartialRendering 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 a pagina parziale. Le aree della pagina da aggiornare vengono designati usando 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 parziale della pagina, vedere Panoramica del rendering di pagine parziali. Per altre informazioni sulle condizioni che causano un aggiornamento, vedere Panoramica del controllo UpdatePanel.
Uso del controllo ScriptManager con pagine master, controlli utente e altri componenti figlio
Una pagina può contenere un solo ScriptManager controllo nella gerarchia. Per registrare servizi e script per pagine annidate, controlli utente o componenti quando la pagina padre ha già un ScriptManager controllo, usare il ScriptManagerProxy controllo. Per altre informazioni, vedere Uso del controllo UpdatePanel con pagine master.
Gestione script e registrazione
Il ScriptManager controllo consente di registrare lo script che viene quindi eseguito 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 dello script nella libreria Microsoft Ajax vengano mantenute.
I 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 lo script Ajax in ASP.NET, vedere Creazione di script client personalizzati usando la libreria Microsoft Ajax.
Registrazione dello script dipendente dalla libreria Microsoft Ajax
È possibile usare i metodi seguenti per registrare i file di script in modo da garantire che tutte le dipendenze della libreria Microsoft Ajax vengano mantenute.
| Metodo | Definizione |
|---|---|
| RegisterScriptControl | Registra un controllo server che implementa l'interfaccia IScriptControl usata per definire un oggetto client Sys.Component . Il ScriptManager controllo esegue il rendering dello script che supporta l'oggetto client. |
| RegisterExtenderControl | Registra un controllo server che implementa l'interfaccia IExtenderControl usata per definire un oggetto client Sys.Component . Il ScriptManager controllo esegue il rendering dello script che supporta l'oggetto client. |
Registrazione di script compatibili Partial-Page aggiornamento
È 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 da 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 (un'espansione) 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 appena prima del tag di chiusura </form> della pagina. Lo script da eseguire per il rendering viene specificato come parametro stringa. |
Quando si registrano i metodi, specificare una coppia di tipi/chiavi per tale script. Se uno script con la stessa coppia di tipi/chiavi è già registrato, non viene registrato un nuovo script. Analogamente, se si registra uno script con una coppia di nomi di tipo/risorsa già esistenti, 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. La registrazione duplicata dei valori della matrice è consentita.
Quando si chiama o il RegisterClientScriptIncludeRegisterClientScriptResource metodo, evitare la registrazione dello script che esegue funzioni inline. Registrare invece script che contiene definizioni di funzioni 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 di 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 parziale della pagina. |
| RegisterDispose | Registra uno script di eliminazione per un controllo all'interno di un UpdatePanel controllo. Lo script viene eseguito quando il controllo UpdatePanel 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 a livello di Services codice alla raccolta 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.
Localizzazione
Il ScriptManager controllo genera riferimenti nella pagina di cui è stato eseguito il rendering che punta ai file di script localizzati appropriati, ovvero file di script incorporati in assembly o file di script autonomi.
Quando la EnableScriptLocalization proprietà è impostata su true, il ScriptManager controllo recupera risorse localizzate (ad esempio stringhe localizzate) per le impostazioni cultura correnti, se presenti. Il controllo fornisce le funzionalità seguenti per l'uso ScriptManager di risorse localizzate:
File di script incorporati in un assembly. Il ScriptManager controllo determina il file di script delle impostazioni cultura o delle impostazioni cultura di fallback da inviare al browser. Questa operazione viene eseguita usando l'attributo assembly specifico NeutralResourcesLanguageAttribute delle impostazioni cultura, le risorse in pacchetto con l'assembly e le impostazioni cultura dell'interfaccia utente del browser (se presente).
File di script autonomi. Il ScriptManager controllo definisce l'elenco delle impostazioni cultura dell'interfaccia utente supportate usando la ResourceUICultures proprietà dell'oggetto ScriptReference .
In modalità di debug. Il ScriptManager controllo tenta di eseguire il 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 Localizzazione delle risorse per le librerie dei componenti.
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 dipendono AllowCustomErrorsRedirect dalla proprietà, dalla AsyncPostBackErrorMessage proprietà e dalla sezione 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
| ScriptManager() |
Inizializza una nuova istanza della classe ScriptManager. |
Proprietà
| Adapter |
Ottiene l'adattatore specifico del browser per il controllo. (Ereditato da Control) |
| AjaxFrameworkAssembly |
Ottiene l'assembly del framework Ajax usato dai componenti della pagina. |
| AjaxFrameworkMode |
Ottiene o imposta un valore che specifica come 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 usata durante un errore in un postback asincrono. |
| AppRelativeTemplateSourceDirectory |
Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo. (Ereditato da Control) |
| AsyncPostBackErrorMessage |
Ottiene o imposta il messaggio di errore inviato al client quando si verifica un'eccezione non gestita del server durante un postback asincrono. |
| AsyncPostBackSourceElementID |
Ottiene l'ID univoco del controllo che ha provocato il postback asincrono. |
| AsyncPostBackTimeout |
Ottiene o imposta un valore che indica il tempo, in secondi, prima del timeout dei postback asincroni in assenza di risposte. |
| AuthenticationService |
Ottiene l'oggetto AuthenticationServiceManager associato all'istanza di ScriptManager corrente. |
| BindingContainer |
Ottiene il controllo contenente l'associazione dati del controllo corrente. (Ereditato da Control) |
| ChildControlsCreated |
Ottiene un valore che indica se i controlli figli del controllo server sono stati creati. (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 proprietà ClientID. (Ereditato da Control) |
| ClientIDSeparator |
Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID. (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 oggetto ControlCollection 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 agli script client dai percorsi di rete per la distribuzione di contenuti (CDN). |
| EnableCdnFallback |
Abilita il caricamento della copia locale di uno script nel caso in cui la rete per la distribuzione di contenuti (CDN) non sia disponibile. |
| EnableHistory |
Ottiene o imposta un valore che indica se la pagina Web supporta la gestione dei punti chiave di navigazione. |
| EnablePageMethods |
Ottiene o imposta un valore che indica se i metodi di pagina statici pubblici in una pagina ASP.NET possono essere chiamati da script client. |
| EnablePartialRendering |
Ottiene o imposta un valore che attiva il rendering parziale di una pagina, che consente a sua volta di aggiornare aree individuali della pagina usando i controlli UpdatePanel. |
| EnableScriptGlobalization |
Ottiene o imposta un valore che indica se il controllo ScriptManager esegue il 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 ScriptManager esegue il rendering delle versioni localizzate dei file di script. |
| EnableSecureHistoryState |
Ottiene o imposta un valore che indica se crittografare la stringa dello stato della cronologia. |
| EnableTheming |
Ottiene o imposta un valore che indica se al controllo vengono applicati i temi. (Ereditato da Control) |
| EnableViewState |
Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente. (Ereditato da Control) |
| Events |
Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è di sola lettura. (Ereditato da Control) |
| HasChildViewState |
Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate. (Ereditato da Control) |
| ID |
Ottiene o imposta l'identificatore a livello di codice 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 in questo controllo dispongono di informazioni sullo stato del 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 evento Navigate è attualmente in corso di elaborazione. |
| IsTrackingViewState |
Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione. (Ereditato da Control) |
| IsViewStateEnabled |
Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente. (Ereditato da Control) |
| LoadScriptsBeforeUI |
Ottiene o imposta un valore che indica se gli script vengono caricati prima o dopo il caricamento del markup dell'interfaccia utente della pagina. |
| LoadViewStateByID |
Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice. (Ereditato da Control) |
| NamingContainer |
Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà ID. (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 della pagina. (Ereditato da Control) |
| ProfileService |
Ottiene l'oggetto ProfileServiceManager associato all'istanza di ScriptManager corrente. |
| RenderingCompatibility |
Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering. (Ereditato da Control) |
| RoleService |
Ottiene l'oggetto RoleServiceManager associato all'istanza di ScriptManager corrente. |
| ScriptMode |
Ottiene o imposta un valore che specifica se viene eseguito il rendering delle versioni di debug o finali delle librerie di script client. |
| ScriptPath |
Obsoleti.
Ottiene o imposta il percorso radice usato per compilare i percorsi dei file ASP.NET Ajax e degli script personalizzati. |
| ScriptResourceMapping |
Ottiene un oggetto ScriptResourceMapping. |
| Scripts |
Ottiene un oggetto ScriptReferenceCollection che contiene gli oggetti ScriptReference, ciascuno dei quali rappresenta un file di script sottoposto a rendering sul client. |
| Services |
Ottiene un oggetto ServiceReferenceCollection che contiene un oggetto ServiceReference per ogni servizio Web che ASP.NET espone nel client per la funzionalità Ajax. |
| Site |
Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. (Ereditato da Control) |
| SkinID |
Ottiene o imposta l'interfaccia personalizzata da applicare al controllo. (Ereditato da Control) |
| SupportsPartialRendering |
Ottiene un valore che indica se il client supporta il rendering parziale della pagina. |
| TemplateControl |
Ottiene o imposta un riferimento al modello che contiene il controllo. (Ereditato da Control) |
| TemplateSourceDirectory |
Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente. (Ereditato da Control) |
| UniqueID |
Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server. (Ereditato da Control) |
| ValidateRequestMode |
Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser. (Ereditato da Control) |
| ViewState |
Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina. (Ereditato da Control) |
| ViewStateIgnoresCase |
Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole. (Ereditato da Control) |
| ViewStateMode |
Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo. (Ereditato da Control) |
| Visible |
Esegue l'override della proprietà Visible ereditata dalla classe Control di base per impedire l'impostazione di questo valore. |
Metodi
| AddedControl(Control, Int32) |
Chiamato dopo che un controllo figlio viene aggiunto alla raccolta Controls dell'oggetto Control. (Ereditato da Control) |
| AddHistoryPoint(NameValueCollection, String) |
Crea un punto chiave di navigazione e lo aggiunge allo stack della cronologia del browser, usando la raccolta dei dati dello stato specificato e il titolo dello stato. |
| AddHistoryPoint(String, String) |
Crea un punto chiave di navigazione e lo aggiunge allo stack della cronologia del browser, usando la chiave e il valore di stato specificati. |
| AddHistoryPoint(String, String, String) |
Crea un punto chiave di navigazione e lo aggiunge allo stack della cronologia del browser, usando la chiave, il valore e il titolo specificati per lo stato. |
| AddParsedSubObject(Object) |
Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server. (Ereditato da Control) |
| ApplyStyleSheetSkin(Page) |
Applica al controllo le proprietà di stile definite nel foglio di stile della pagina. (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 recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina. (Ereditato da Control) |
| ClearCachedClientID() |
Imposta il valore memorizzato nella cache ClientID su |
| 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 proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control) |
| CreateChildControls() |
Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che usano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti in preparazione per il postback o il rendering. (Ereditato da Control) |
| CreateControlCollection() |
Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server. (Ereditato da Control) |
| DataBind() |
Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio. (Ereditato da Control) |
| DataBind(Boolean) |
Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding. (Ereditato da Control) |
| DataBindChildren() |
Associa un'origine dati al controllo server e ai relativi controlli figlio. (Ereditato da Control) |
| Dispose() |
Abilita un controllo server alla pulizia finale prima che venga rilasciato 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, li crea. (Ereditato da Control) |
| EnsureID() |
Crea un identificatore per i controlli a cui non è assegnato alcun identificatore. (Ereditato da Control) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| FindControl(String) |
Cerca un controllo server nel contenitore dei nomi corrente con il parametro |
| FindControl(String, Int32) |
Cerca nel contenitore di denominazione corrente un controllo server con il parametro |
| Focus() |
Imposta lo stato attivo per l'input su un controllo. (Ereditato da Control) |
| GetCurrent(Page) |
Ottiene l'istanza ScriptManager per un oggetto Page specificato. |
| GetDesignModeState() |
Ottiene i dati della 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 delle dichiarazioni di matrice ECMAScript (JavaScript) precedentemente registrate con l'oggetto Page. |
| GetRegisteredClientScriptBlocks() |
Recupera una matrice di sola lettura dei blocchi di script client precedentemente registrati con il controllo ScriptManager. |
| GetRegisteredDisposeScripts() |
Recupera una raccolta di sola lettura degli script |
| GetRegisteredExpandoAttributes() |
Recupera una raccolta di sola lettura degli attributi personalizzati (expando) precedentemente registrati con l'oggetto Page. |
| GetRegisteredHiddenFields() |
Recupera una raccolta di sola lettura dei campi nascosti precedentemente registrati con l'oggetto Page. |
| GetRegisteredOnSubmitStatements() |
Recupera una raccolta di sola lettura delle istruzioni |
| GetRegisteredStartupScripts() |
Recupera una raccolta di sola lettura degli script di avvio precedentemente registrati con l'oggetto Page. |
| GetRouteUrl(Object) |
Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control) |
| GetRouteUrl(RouteValueDictionary) |
Ottiene l'URL corrispondente 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 a un nome della route. (Ereditato da Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control) |
| GetStateString() |
Recupera una stringa contenente le coppie nome/valore che rappresentano lo stato di una pagina Web. |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| GetUniqueIDRelativeTo(Control) |
Restituisce la parte con prefisso della proprietà UniqueID 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 eventuali controlli figlio. (Ereditato da Control) |
| IsLiteralContent() |
Determina se il controllo server conserva solo il contenuto literal. (Ereditato da Control) |
| LoadControlState(Object) |
Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState(). (Ereditato da Control) |
| LoadPostData(String, NameValueCollection) |
Legge i dati del form inseriti 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 metodo SaveViewState(). (Ereditato da Control) |
| MapPathSecure(String) |
Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo. (Ereditato da Control) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| OnAsyncPostBackError(AsyncPostBackErrorEventArgs) |
Genera l'evento AsyncPostBackError. |
| OnBubbleEvent(Object, EventArgs) |
Determina se l'evento per il controllo server viene passato a un livello superiore nella gerarchia dei controlli server dell'interfaccia utente per la pagina. (Ereditato da Control) |
| OnDataBinding(EventArgs) |
Genera l'evento DataBinding. (Ereditato da Control) |
| OnInit(EventArgs) |
Genera l'evento Init e verifica che esista solo un controllo ScriptManager nella pagina. |
| 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 parziali della pagina. |
| OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs) |
Genera l'evento ResolveCompositeScriptReference. |
| OnResolveScriptReference(ScriptReferenceEventArgs) |
Genera l'evento ResolveScriptReference per ogni riferimento a script gestito dal controllo ScriptManager. |
| OnUnload(EventArgs) |
Genera l'evento Unload. (Ereditato da Control) |
| OpenFile(String) |
Ottiene un oggetto Stream utilizzato per leggere un file. (Ereditato da Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Assegna eventuali origini dell'evento e relative informazioni al controllo padre. (Ereditato da Control) |
| RaisePostBackEvent(String) |
Elabora un evento di postback generato dal controllo ScriptManager e carica lo stato della cronologia della pagina Web. |
| RaisePostDataChangedEvent() |
Genera eventi per il controllo ScriptManager durante il postback al server. |
| RegisterArrayDeclaration(Control, String, String) |
Registra una dichiarazione di matrice di ECMAScript (JavaScript) con il controllo ScriptManager da usare con un controllo compreso in un controllo UpdatePanel e aggiunge la matrice alla pagina. |
| RegisterArrayDeclaration(Page, String, String) |
Registra una dichiarazione di matrice di ECMAScript (JavaScript) con il controllo ScriptManager da usare con un controllo compreso in un controllo UpdatePanel 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 controllo ScriptManager da usare con un controllo che si trova all'interno di un controllo UpdatePanel e quindi aggiunge il blocco di script alla pagina. |
| RegisterClientScriptBlock(Page, Type, String, String, Boolean) |
Registra un blocco di script client con il controllo ScriptManager da usare con un controllo che si trova all'interno di un controllo UpdatePanel e quindi aggiunge il blocco di script alla pagina. |
| RegisterClientScriptInclude(Control, Type, String, String) |
Registra un file di script client con il controllo ScriptManager da usare con un controllo compreso in un controllo UpdatePanel e quindi aggiunge un riferimento al file di script alla pagina. |
| RegisterClientScriptInclude(Page, Type, String, String) |
Registra lo script client con il controllo ScriptManager 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 controllo ScriptManager 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 controllo ScriptManager ogni volta che si verifica un postback asincrono. |
| RegisterDataItem(Control, String) |
Invia dati personalizzati a un controllo durante il rendering parziale della pagina. |
| RegisterDataItem(Control, String, Boolean) |
Invia dati personalizzati a un controllo durante il rendering parziale della pagina e indica se i dati sono in formato JavaScript Object Notation (JSON). |
| RegisterDispose(Control, String) |
Registra uno script |
| RegisterExpandoAttribute(Control, String, String, String, Boolean) |
Registra una coppia nome/valore con il controllo ScriptManager come attributo personalizzato (expando) di un controllo specificato. |
| RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control) |
Registra un controllo Extender con l'istanza ScriptManager corrente. |
| RegisterHiddenField(Control, String, String) |
Registra un campo nascosto con il controllo ScriptManager per un controllo compreso in un controllo UpdatePanel. |
| RegisterHiddenField(Page, String, String) |
Registra un campo nascosto con il controllo ScriptManager durante ogni postback asincrono. |
| RegisterNamedClientScriptResource(Control, String) |
Registra lo script client incorporato in un assembly con il controllo ScriptManager da usare con un controllo che partecipa al rendering parziale della pagina. |
| RegisterNamedClientScriptResource(Page, String) |
Registra lo script client incorporato in un assembly con il controllo ScriptManager da usare con un controllo che partecipa al rendering parziale della pagina. |
| RegisterOnSubmitStatement(Control, Type, String, String) |
Registra il codice ECMAScript (JavaScript) con il controllo ScriptManager per un controllo usato con un controllo UpdatePanel eseguito quando il form viene inviato. |
| RegisterOnSubmitStatement(Page, Type, String, String) |
Registra il codice ECMAScript (JavaScript) con il controllo ScriptManager per un controllo usato con un controllo UpdatePanel eseguito quando il form viene inviato. |
| RegisterPostBackControl(Control) |
Registra un controllo come trigger per un postback. Questo metodo viene usato per i controlli di postback all'interno di un controllo UpdatePanel che altrimenti eseguirebbe postback asincroni. |
| RegisterScriptControl<TScriptControl>(TScriptControl) |
Registra un controllo Script con l'istanza ScriptManager corrente. |
| RegisterScriptDescriptors(IExtenderControl) |
Esegue la richiamata a una classe ExtenderControl per restituire gli script dell'istanza di cui eseguire il rendering per supportare l'oggetto client che rappresenta un controllo, un componente o un comportamento client. |
| RegisterScriptDescriptors(IScriptControl) |
Chiama una classe ScriptControl per restituire gli script dell'istanza di cui eseguire il rendering per supportare l'oggetto client che rappresenta un controllo, un componente o un comportamento client. |
| RegisterStartupScript(Control, Type, String, String, Boolean) |
Registra un blocco di script di avvio per un controllo compreso in un controllo UpdatePanel usando il controllo ScriptManager 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 controllo ScriptManager e aggiunge il blocco di script alla pagina. |
| RemovedControl(Control) |
Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control. (Ereditato da Control) |
| Render(HtmlTextWriter) |
Esegue il rendering del contenuto del controllo ScriptManager nel browser usando l'oggetto HtmlTextWriter specificato. |
| RenderChildren(HtmlTextWriter) |
Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto HtmlTextWriter specificato, che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control) |
| RenderControl(HtmlTextWriter) |
Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata. (Ereditato da Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato. (Ereditato da Control) |
| ResolveAdapter() |
Ottiene l'adattatore del 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 formato utilizzabile dal client richiedente. (Ereditato da Control) |
| SaveControlState() |
Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server. (Ereditato da Control) |
| SaveViewState() |
Salva eventuali modifiche dello stato di visualizzazione di un controllo server apportate dopo il postback della pagina nel server. (Ereditato da Control) |
| SetDesignModeState(IDictionary) |
Imposta i dati della 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) |
Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control) |
| SetTraceData(Object, Object, Object) |
Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, 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() |
Attiva il rilevamento delle modifiche dello stato di visualizzazione nel controllo server per consentirne la memorizzazione nell'oggetto StateBag del controllo server. È possibile accedere a questo oggetto tramite la proprietà ViewState. (Ereditato da Control) |
Eventi
| AsyncPostBackError |
Si verifica in presenza di un errore della pagina durante un postback asincrono. |
| DataBinding |
Viene generato quando il controllo server viene associato a un'origine dati. (Ereditato da Control) |
| Disposed |
Si verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control) |
| Init |
Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata. (Ereditato da Control) |
| Load |
Viene generato quando il controllo server è caricato nell'oggetto Page. (Ereditato da Control) |
| Navigate |
Si verifica quando l'utente sceglie il 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 controllo ScriptManager. |
| ResolveScriptReference |
Si verifica quando un membro della raccolta Scripts viene registrato con il controllo ScriptManager. |
| Unload |
Viene generato quando il controllo server viene scaricato dalla memoria. (Ereditato da Control) |
Implementazioni dell'interfaccia esplicita
Metodi di estensione
| 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 metatabella per il controllo contenitore dei dati. |
Si applica a
Vedi anche
Commenti e suggerimenti
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere: https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per