ScriptManager Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Gère des fichiers de script et des bibliothèques de scripts ASP.NET Ajax, le rendu de page partiel et la génération de classe du proxy client pour les services web et d'application.
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- Héritage
- Attributs
- Implémente
Exemples
Les exemples suivants illustrent différents scénarios d’utilisation du ScriptManager contrôle.
Activation de Partial-Page Mises à jour
L’exemple suivant montre comment utiliser le contrôle pour activer les ScriptManager mises à jour partielles de page. Dans cet exemple, un Calendar et un DropDownList contrôle se trouvent à l’intérieur d’un UpdatePanel contrôle. Par défaut, la valeur de la UpdateMode propriété est Always, et la valeur de la ChildrenAsTriggers propriété est true. Par conséquent, les contrôles enfants du panneau entraînent une publication asynchrone.
<%@ 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>
Gestion des erreurs de mise à jour Partial-Page et inscription du script
L’exemple suivant montre comment fournir une gestion personnalisée des erreurs lors des mises à jour partielles. Par défaut, lorsqu’une erreur se produit lors de mises à jour partielles de page, une boîte de message JavaScript s’affiche. Cet exemple montre comment utiliser la gestion des erreurs personnalisée en fournissant un gestionnaire pour l’événement AsyncPostBackError et en définissant la AsyncPostBackErrorMessage propriété dans le gestionnaire d’événements. Vous pouvez également définir la AllowCustomErrorsRedirect propriété pour spécifier la façon dont la section erreurs personnalisées du fichier Web.config est utilisée lorsqu’une erreur se produit lors des mises à jour partielles de la page. Dans cet exemple, la valeur par défaut de la AllowCustomErrorsRedirect propriété est utilisée. Cela signifie que si le fichier Web.config contient un élément customErrors , cet élément détermine la façon dont les erreurs sont affichées. Pour plus d’informations, consultez customErrors, élément (schéma de paramètres 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>
Globalisation de la date et de l’heure affichées dans le navigateur
L’exemple suivant montre comment définir la propriété afin que le EnableScriptGlobalization script client puisse afficher une date et une heure spécifiques à la culture dans le navigateur. Dans l’exemple, l’attribut Culture de la directive @ Page est défini sur auto. Par conséquent, la première langue spécifiée dans les paramètres actuels du navigateur détermine la culture et la culture de l’interface utilisateur de la page. Pour plus d’informations, consultez Guide pratique pour définir la culture et la culture de l’interface utilisateur pour ASP.NET globalisation des pages 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>
Remarques
Dans cette rubrique :
Introduction
Le ScriptManager contrôle est essentiel à la fonctionnalité Ajax dans ASP.NET. Le contrôle gère toutes les ASP.NET ressources Ajax sur une page. Cela inclut le téléchargement des scripts de la bibliothèque Microsoft Ajax dans le navigateur et la coordination des mises à jour de page partielles activées à l’aide UpdatePanel de contrôles. En outre, le ScriptManager contrôle vous permet d’effectuer les opérations suivantes :
Inscrire un script compatible avec les mises à jour partielles de page. Pour gérer les dépendances entre votre script et la bibliothèque principale, tout script que vous inscrivez est chargé après le script de la bibliothèque Microsoft Ajax.
Spécifiez si les scripts de mise en production ou de débogage sont envoyés au navigateur.
Fournissez l’accès aux méthodes de service Web à partir d’un script en inscrivant des services Web auprès du ScriptManager contrôle .
Fournissez l’accès à ASP.NET services d’application d’authentification, de rôle et de profil à partir du script client en inscrivant ces services auprès du ScriptManager contrôle.
Activez l’affichage spécifique à la culture des fonctions EcMAScript (JavaScript) Date, Number et String dans le navigateur.
Accédez aux ressources de localisation pour les fichiers de script incorporés ou pour les fichiers de script autonomes à l’aide de la ResourceUICultures propriété du ScriptReference contrôle.
Inscrivez les contrôles serveur qui implémentent les IExtenderControl interfaces ou IScriptControl avec le contrôle afin que le ScriptManager script requis par les composants et les comportements clients soit affiché.
rendu Partial-Page
La capacité d’une page ASP.NET à prendre en charge le rendu de page partielle est contrôlée par les facteurs suivants :
La ScriptManager propriété du EnablePartialRendering contrôle doit être
true(valeur par défaut).Il doit y avoir au moins un UpdatePanel contrôle sur la page.
La SupportsPartialRendering propriété doit être
true(valeur par défaut). Si la SupportsPartialRendering propriété n’est pas définie explicitement, sa valeur est basée sur les fonctionnalités du navigateur.
Vous pouvez remplacer la valeur de la propriété au moment de l’exécution EnablePartialRendering pendant ou avant l’événement de Init la page. Si vous essayez de modifier cette propriété après que l’événement de Init la page s’est produit, une InvalidOperationException exception est levée.
Lorsque le rendu de page partielle est pris en charge, le contrôle affiche le ScriptManager script pour activer les publications asynchrones et les mises à jour de pages partielles. Les régions de la page à mettre à jour sont désignées à l’aide UpdatePanel de contrôles. Le ScriptManager contrôle gère les publications asynchrones et actualise uniquement les régions de la page qui doivent être mises à jour. Pour plus d’informations sur le rendu de page partielle, consultez Vue d’ensemble du rendu de page partielle. Pour plus d’informations sur les conditions qui provoquent une mise à jour, consultez Vue d’ensemble du contrôle UpdatePanel.
Utilisation du contrôle ScriptManager avec des pages maîtres, des contrôles utilisateur et d’autres composants enfants
Une page ne peut contenir qu’un ScriptManager seul contrôle dans sa hiérarchie. Pour inscrire des services et des scripts pour des pages imbriquées, des contrôles utilisateur ou des composants lorsque la page parente a déjà un ScriptManager contrôle, utilisez le ScriptManagerProxy contrôle . Pour plus d’informations, consultez Utilisation du contrôle UpdatePanel avec des pages maîtres.
Gestion des scripts et inscription
Le ScriptManager contrôle vous permet d’inscrire le script qui est ensuite affiché dans le cadre de la page. Les ScriptManager méthodes d’inscription de contrôle peuvent être divisées en trois catégories suivantes :
Méthodes d’inscription qui garantissent que les dépendances de script sur la bibliothèque Microsoft Ajax sont conservées.
Méthodes d’inscription qui ne dépendent pas de la bibliothèque Microsoft Ajax, mais qui sont compatibles avec UpdatePanel les contrôles.
Méthodes d’inscription qui prennent en charge l’utilisation UpdatePanel des contrôles.
Pour plus d’informations sur la création et l’utilisation d’un script Ajax dans ASP.NET, consultez Création d’un script client personnalisé à l’aide de la bibliothèque Microsoft Ajax.
Inscription d’un script dépendant de la bibliothèque Microsoft Ajax
Vous pouvez utiliser les méthodes suivantes pour inscrire des fichiers de script de manière à garantir que toutes les dépendances sur la bibliothèque Microsoft Ajax sont conservées.
| Méthode | Définition |
|---|---|
| RegisterScriptControl | Inscrit un contrôle serveur qui implémente l’interface IScriptControl utilisée pour définir un objet client Sys.Component . Le ScriptManager contrôle affiche le script qui prend en charge l’objet client. |
| RegisterExtenderControl | Inscrit un contrôle serveur qui implémente l’interface IExtenderControl utilisée pour définir un objet client Sys.Component . Le ScriptManager contrôle affiche le script qui prend en charge l’objet client. |
Inscription Partial-Page mettre à jour des scripts compatibles
Vous pouvez utiliser les méthodes suivantes pour inscrire des fichiers de script qui ne dépendent pas de la bibliothèque Microsoft Ajax, mais qui sont compatibles avec UpdatePanel les contrôles. Ces méthodes correspondent à des méthodes similaires du ClientScriptManager contrôle. Si vous effectuez le rendu du script à utiliser à l’intérieur d’un UpdatePanel contrôle, veillez à appeler les méthodes du ScriptManager contrôle.
| Méthode | Définition |
|---|---|
| RegisterArrayDeclaration | Ajoute une valeur à un tableau JavaScript. Si le tableau n’existe pas, il est créé. |
| RegisterClientScriptBlock | Affiche un script élément après la balise d’ouverture <form> de la page. Le script est spécifié en tant que paramètre de chaîne. |
| RegisterClientScriptInclude | Affiche un script élément après la balise d’ouverture <form> de la page. Le contenu du script est spécifié en définissant l’attribut src sur une URL qui pointe vers un fichier de script. |
| RegisterClientScriptResource | Affiche un script élément après la balise d’ouverture <form> de la page. Le contenu du script est spécifié avec un nom de ressource dans un assembly. L’attribut src est automatiquement rempli avec une URL par un appel à un gestionnaire HTTP qui récupère le script nommé à partir de l’assembly. |
| RegisterExpandoAttribute | Restitue une paire d’attributs nom/valeur personnalisée (un expando) dans le balisage d’un contrôle spécifié. |
| RegisterHiddenField | Affiche un champ masqué. |
| RegisterOnSubmitStatement | Inscrit un script exécuté en réponse à l’événement de l’élément formsubmit . L’attribut onSubmit fait référence au script spécifié. |
| RegisterStartupScript | Affiche un bloc de script de démarrage juste avant la balise de fermeture </form> de la page. Le script à restituer est spécifié en tant que paramètre de chaîne. |
Lorsque vous inscrivez des méthodes, vous spécifiez une paire type/clé pour ce script. Si un script avec la même paire type/clé est déjà inscrit, un nouveau script n’est pas inscrit. De même, si vous inscrivez un script avec une paire type/nom de ressource qui existe déjà, l’élément script qui fait référence à la ressource n’est pas ajouté à nouveau. Lorsque vous inscrivez un attribut expando d’un attribut précédemment inscrit, une exception est levée. L’inscription en double de valeurs de tableau est autorisée.
Lorsque vous appelez la RegisterClientScriptIncludeRegisterClientScriptResource méthode ou, évitez d’inscrire un script qui exécute des fonctions inline. Au lieu de cela, inscrivez un script qui contient des définitions de fonction telles que des gestionnaires d’événements ou des définitions de classes personnalisées pour votre application.
Méthodes d’inscription pour les contrôles UpdatePanel
Vous pouvez utiliser les méthodes suivantes pour personnaliser les mises à jour de page partielles lorsque vous utilisez UpdatePanel des contrôles.
| Méthode | Définition |
|---|---|
| RegisterAsyncPostBackControl | Inscrit un contrôle comme déclencheur pour les publications (postback) asynchrones. |
| RegisterDataItem | Envoie des données personnalisées aux contrôles pendant le rendu de page partiel. |
| RegisterDispose | Inscrit un script d’élimination pour un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle. Le script est exécuté quand le contrôle UpdatePanel est mis à jour ou supprimé. La méthode de suppression est utilisée pour les composants clients qui font partie de la bibliothèque Microsoft Ajax et qui doivent libérer des ressources lorsqu’un composant n’est plus utilisé. |
| RegisterPostBackControl | Inscrit un contrôle en tant que déclencheur pour une publication complète. Cette méthode est utilisée pour les contrôles à l’intérieur d’un UpdatePanel contrôle qui, sinon, effectueraient des publications asynchrones. |
Références de service web
Vous pouvez inscrire un service Web à appeler à partir d’un script client en créant un ServiceReference objet et en l’ajoutant à la Services collection du ScriptManager contrôle. ASP.NET génère un objet proxy client pour chaque ServiceReference objet de la Services collection. Vous pouvez ajouter par programmation des ServiceReference objets à la Services collection pour inscrire des services Web au moment de l’exécution.
Pour plus d’informations sur l’accès aux services Web dans un script, consultez Exposing Web Services to Client Script in ASP.NET AJAX et Calling Web Services from Client Script in ASP.NET AJAX.
Localisation
Le ScriptManager contrôle génère des références dans la page rendue qui pointent vers les fichiers de script localisés appropriés, qui sont soit des fichiers de script incorporés dans des assemblys, soit des fichiers de script autonomes.
Lorsque la EnableScriptLocalization propriété a la valeur true, le ScriptManager contrôle récupère les ressources localisées (telles que les chaînes localisées) pour la culture actuelle, si elles existent. Le ScriptManager contrôle fournit les fonctionnalités suivantes pour l’utilisation de ressources localisées :
Fichiers de script incorporés dans un assembly. Le ScriptManager contrôle détermine le fichier de script de culture spécifique ou de secours à envoyer au navigateur. Pour ce faire, il utilise l’attribut d’assembly spécifique à NeutralResourcesLanguageAttribute la culture, les ressources empaquetées avec l’assembly et la culture d’interface utilisateur du navigateur (le cas échéant).
Fichiers de script autonomes. Le ScriptManager contrôle définit la liste des cultures d’interface utilisateur prises en charge à l’aide de la ResourceUICultures propriété de l’objet ScriptReference .
En mode débogage. Le ScriptManager contrôle tente de restituer un fichier de script spécifique à la culture qui contient des informations de débogage. Par exemple, si la page est en mode débogage et que la culture actuelle est définie sur en-MX, le contrôle affiche un fichier de script qui porte un nom tel que
scriptname.en-MX.debug.js, si le fichier existe. Si le fichier n’existe pas, le fichier de débogage de la culture de secours appropriée est affiché
Pour plus d’informations sur la localisation des ressources, consultez Vue d’ensemble de la localisation des ressources pour les bibliothèques de composants.
Gestion des erreurs
Lorsqu’une erreur de page se produit pendant les publications asynchrones, l’événement AsyncPostBackError est déclenché. La façon dont les erreurs sur le serveur sont envoyées au client dépend de la AllowCustomErrorsRedirect propriété, de la AsyncPostBackErrorMessage propriété et de la section erreurs personnalisées du fichier Web.config. Pour plus d’informations, consultez Personnalisation de la gestion des erreurs pour les contrôles UpdatePanel.
Syntaxe déclarative
<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>
Constructeurs
| ScriptManager() |
Initialise une nouvelle instance de la classe ScriptManager. |
Propriétés
| Adapter |
Obtient l'adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
| AjaxFrameworkAssembly |
Obtient l'assembly Framework Ajax utilisé par les composants sur la page. |
| AjaxFrameworkMode |
Obtient ou définit une valeur qui définit la façon dont les scripts clients de la bibliothèque cliente Microsoft Ajax doivent être inclus dans le client. |
| AllowCustomErrorsRedirect |
Obtient ou définit une valeur qui détermine si la section d'erreurs personnalisées du fichier Web.config est utilisée pendant une erreur dans une publication (postback) asynchrone. |
| AppRelativeTemplateSourceDirectory |
Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle. (Hérité de Control) |
| AsyncPostBackErrorMessage |
Obtient ou définit le message d'erreur envoyé au client quand une exception de serveur non gérée se produit pendant une publication (postback) asynchrone. |
| AsyncPostBackSourceElementID |
Obtient l'ID unique du contrôle qui a provoqué la publication (postback) asynchrone. |
| AsyncPostBackTimeout |
Obtient ou définit une valeur qui indique la durée, en secondes, avant l'expiration des publications (postback) asynchrones si aucune réponse n'est reçue. |
| AuthenticationService |
Obtient l'objet AuthenticationServiceManager associé à l'instance ScriptManager actuelle. |
| BindingContainer |
Obtient le contrôle qui contient la liaison de données de ce contrôle. (Hérité de Control) |
| ChildControlsCreated |
Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés. (Hérité de Control) |
| ClientID |
Obtient l’ID de contrôle du balisage HTML généré par ASP.NET. (Hérité de Control) |
| ClientIDMode |
Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID. (Hérité de Control) |
| ClientIDSeparator |
Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID. (Hérité de Control) |
| ClientNavigateHandler |
Obtient ou définit le nom de la méthode qui gère l'événement Sys.Application.navigate sur le client. |
| CompositeScript |
Obtient une référence au script composite qui prend en charge la page web. |
| Context |
Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours. (Hérité de Control) |
| Controls |
Obtient un objet ControlCollection qui représente les contrôles enfants pour un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur. (Hérité de Control) |
| DataItemContainer |
Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer. (Hérité de Control) |
| DataKeysContainer |
Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl. (Hérité de Control) |
| DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception. (Hérité de Control) |
| EmptyPageUrl |
Obtient ou définit une URL vers une page web vierge. |
| EnableCdn |
Détermine si la page active charge des références de script client à partir de chemins d’accès CDN (Content Delivery Network). |
| EnableCdnFallback |
Permet la copie locale d'un script dans le cas où le CDN (Content Delivery Network) n'est pas disponible. |
| EnableHistory |
Obtient ou définit une valeur qui indique si la page web prend en charge la gestion des points d'historique. |
| EnablePageMethods |
Obtient ou définit une valeur qui indique si les méthodes de page statiques publiques d'une page ASP.NET peuvent être appelées par le script client. |
| EnablePartialRendering |
Obtient ou définit une valeur qui active le rendu partiel d'une page qui, à son tour, vous permet de mettre à jour des zones de la page individuellement à l'aide de contrôles UpdatePanel. |
| EnableScriptGlobalization |
Obtient ou définit une valeur qui indique si le contrôle ScriptManager restitue le script qui prend en charge l'analyse et la mise en forme des informations spécifiques à la culture. |
| EnableScriptLocalization |
Obtient ou définit une valeur qui indique si le contrôle ScriptManager restitue des versions localisées des fichiers de script. |
| EnableSecureHistoryState |
Obtient ou définit une valeur qui indique s'il faut chiffrer la chaîne d'état de l'historique. |
| EnableTheming |
Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle. (Hérité de Control) |
| EnableViewState |
Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur. (Hérité de Control) |
| Events |
Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule. (Hérité de Control) |
| HasChildViewState |
Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés. (Hérité de Control) |
| ID |
Obtient ou définit l'ID programmatique assigné au contrôle serveur. (Hérité de Control) |
| IdSeparator |
Obtient le caractère utilisé pour séparer des identificateurs de contrôle. (Hérité de Control) |
| IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle. (Hérité de Control) |
| IsDebuggingEnabled |
Obtient une valeur qui indique si les versions debug de bibliothèques de scripts clients seront restituées. |
| IsInAsyncPostBack |
Obtient une valeur qui indique si la publication (postback) actuelle est exécutée en mode de rendu partiel. |
| IsNavigating |
Obtient une valeur qui indique si un événement Navigate est actuellement géré. |
| IsTrackingViewState |
Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage. (Hérité de Control) |
| IsViewStateEnabled |
Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle. (Hérité de Control) |
| LoadScriptsBeforeUI |
Obtient ou définit une valeur qui indique si les scripts sont chargés avant ou après le chargement du balisage pour l'interface utilisateur de la page. |
| LoadViewStateByID |
Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index. (Hérité de Control) |
| NamingContainer |
Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur. (Hérité de Control) |
| Page |
Obtient une référence à l'instance de Page qui contient le contrôle serveur. (Hérité de Control) |
| Parent |
Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page. (Hérité de Control) |
| ProfileService |
Obtient l'objet ProfileServiceManager associé à l'instance ScriptManager actuelle. |
| RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible. (Hérité de Control) |
| RoleService |
Obtient l'objet RoleServiceManager associé à l'instance ScriptManager actuelle. |
| ScriptMode |
Obtient ou définit une valeur qui spécifie si les versions Debug ou Release des bibliothèques de scripts clients sont restituées. |
| ScriptPath |
Obsolète.
Obtient ou définit le chemin d'accès racine de l'emplacement utilisé pour générer les chemins d'accès aux fichiers de script personnalisés et ASP.NET Ajax. |
| ScriptResourceMapping |
Obtient un objet ScriptResourceMapping. |
| Scripts |
Obtient un objet ScriptReferenceCollection qui contient les objets ScriptReference, chacun représentant un fichier de script restitué au client. |
| Services |
Obtient un objet ServiceReferenceCollection qui contient un objet ServiceReference pour chaque service web qu'ASP.NET expose sur le client pour les fonctionnalités Ajax. |
| Site |
Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception. (Hérité de Control) |
| SkinID |
Obtient ou définit l’apparence à appliquer au contrôle. (Hérité de Control) |
| SupportsPartialRendering |
Obtient une valeur qui indique si le client prend en charge le rendu de page partiel. |
| TemplateControl |
Obtient ou définit une référence au modèle qui contient ce contrôle. (Hérité de Control) |
| TemplateSourceDirectory |
Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours. (Hérité de Control) |
| UniqueID |
Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur. (Hérité de Control) |
| ValidateRequestMode |
Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses. (Hérité de Control) |
| ViewState |
Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page. (Hérité de Control) |
| ViewStateIgnoresCase |
Obtient une valeur qui indique si l'objet StateBag respecte la casse. (Hérité de Control) |
| ViewStateMode |
Obtient ou définit le mode d'état d'affichage de ce contrôle. (Hérité de Control) |
| Visible |
Substitue la propriété Visible héritée de la classe Control de base pour empêcher la définition de cette valeur. |
Méthodes
| AddedControl(Control, Int32) |
Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control. (Hérité de Control) |
| AddHistoryPoint(NameValueCollection, String) |
Crée un point d’historique et l’ajoute à la pile d’historique du navigateur, à l’aide de la collection de données d’état et du titre d’état spécifiés. |
| AddHistoryPoint(String, String) |
Crée un point d'historique et l'ajoute à la pile d'historique du navigateur, à l'aide de la clé d'état et de la valeur d'état spécifiées. |
| AddHistoryPoint(String, String, String) |
Crée un point d'historique et l'ajoute à la pile d'historique du navigateur, à l'aide de la clé d'état, de la valeur d'état et du titre d'état spécifiés. |
| AddParsedSubObject(Object) |
Avertit le contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur. (Hérité de Control) |
| ApplyStyleSheetSkin(Page) |
Applique les propriétés de style définies dans la feuille de style de la page au contrôle. (Hérité de Control) |
| BeginRenderTracing(TextWriter, Object) |
Commence le traçage au moment du design des données de rendu. (Hérité de Control) |
| BuildProfileTree(String, Boolean) |
Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page. (Hérité de Control) |
| ClearCachedClientID() |
Affecte à la valeur ClientID mise en cache la valeur |
| ClearChildControlState() |
Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildState() |
Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildViewState() |
Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearEffectiveClientIDMode() |
Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants. (Hérité de Control) |
| CreateChildControls() |
Appelée par l’infrastructure de page ASP.NET pour signaler aux contrôles serveur qu’ils doivent utiliser l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en vue de la publication ou du rendu. (Hérité de Control) |
| CreateControlCollection() |
Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur. (Hérité de Control) |
| DataBind() |
Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants. (Hérité de Control) |
| DataBind(Boolean) |
Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding. (Hérité de Control) |
| DataBindChildren() |
Lie une source de données aux contrôles enfants du contrôle serveur. (Hérité de Control) |
| Dispose() |
Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire. (Hérité de Control) |
| EndRenderTracing(TextWriter, Object) |
Met fin au traçage au moment du design des données de rendu. (Hérité de Control) |
| EnsureChildControls() |
Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée. (Hérité de Control) |
| EnsureID() |
Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné. (Hérité de Control) |
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| FindControl(String) |
Recherche un contrôle serveur possédant le paramètre |
| FindControl(String, Int32) |
Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l' |
| Focus() |
Affecte le focus d'entrée à un contrôle. (Hérité de Control) |
| GetCurrent(Page) |
Obtient l'instance ScriptManager pour un objet Page donné. |
| GetDesignModeState() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetRegisteredArrayDeclarations() |
Récupère une collection en lecture seule de déclarations de tableau ECMAScript (JavaScript) précédemment inscrites avec l’objet Page. |
| GetRegisteredClientScriptBlocks() |
Récupère une collection en lecture seule de blocs de script client précédemment inscrits avec le contrôle ScriptManager. |
| GetRegisteredDisposeScripts() |
Récupère une collection en lecture seule de scripts |
| GetRegisteredExpandoAttributes() |
Récupère une collection en lecture seule d’attributs personnalisés (expando) précédemment inscrits avec l’objet Page. |
| GetRegisteredHiddenFields() |
Récupère une collection en lecture seule de champs masqués précédemment inscrits avec l’objet Page. |
| GetRegisteredOnSubmitStatements() |
Récupère une collection en lecture seule d’instructions |
| GetRegisteredStartupScripts() |
Récupère une collection en lecture seule de scripts de démarrage précédemment inscrits avec l’objet Page. |
| GetRouteUrl(Object) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire. (Hérité de Control) |
| GetRouteUrl(String, Object) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire. (Hérité de Control) |
| GetStateString() |
Récupère une chaîne qui contient des paires clé/valeur qui représentent l'état de la page web. |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| GetUniqueIDRelativeTo(Control) |
Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié. (Hérité de Control) |
| HasControls() |
Détermine si le contrôle serveur contient des contrôles enfants. (Hérité de Control) |
| HasEvents() |
Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants. (Hérité de Control) |
| IsLiteralContent() |
Détermine si le contrôle serveur ne détient qu'un contenu littéral. (Hérité de Control) |
| LoadControlState(Object) |
Restaure des informations sur l'état du contrôle à partir d'une demande de page antérieure enregistrée par la méthode SaveControlState(). (Hérité de Control) |
| LoadPostData(String, NameValueCollection) |
Lit les données de formulaire publiées à partir du navigateur sur le serveur et détermine la source de la publication (postback) asynchrone. |
| LoadViewState(Object) |
Restaure les informations d’état d’affichage d’une précédente requête de page enregistrées par la méthode SaveViewState(). (Hérité de Control) |
| MapPathSecure(String) |
Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond. (Hérité de Control) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| OnAsyncPostBackError(AsyncPostBackErrorEventArgs) |
Déclenche l’événement AsyncPostBackError. |
| OnBubbleEvent(Object, EventArgs) |
Détermine si l’événement du contrôle serveur est passé dans la hiérarchie des contrôles serveur de l’interface utilisateur de la page. (Hérité de Control) |
| OnDataBinding(EventArgs) |
Déclenche l’événement DataBinding. (Hérité de Control) |
| OnInit(EventArgs) |
Déclenche l'événement Init et s'assure qu'un seul contrôle ScriptManager existe sur la page. |
| OnLoad(EventArgs) |
Déclenche l’événement Load. (Hérité de Control) |
| OnPreRender(EventArgs) |
Déclenche l'événement PreRender et inscrit des fichiers de script et des services pour les mises à jour de pages partielles. |
| OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs) |
Déclenche l’événement ResolveCompositeScriptReference. |
| OnResolveScriptReference(ScriptReferenceEventArgs) |
Déclenche l'événement ResolveScriptReference pour chaque référence de script gérée par le contrôle ScriptManager. |
| OnUnload(EventArgs) |
Déclenche l’événement Unload. (Hérité de Control) |
| OpenFile(String) |
Obtient un Stream utilisé pour lire un fichier. (Hérité de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle. (Hérité de Control) |
| RaisePostBackEvent(String) |
Traite un événement de publication (postback) déclenché par le contrôle ScriptManager et charge l'état de l'historique de la page web. |
| RaisePostDataChangedEvent() |
Déclenche des événements pour le contrôle ScriptManager pendant la publication sur le serveur. |
| RegisterArrayDeclaration(Control, String, String) |
Inscrit une déclaration de tableau ECMAScript (JavaScript) avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l’intérieur d’un contrôle UpdatePanel et ajoute le tableau à la page. |
| RegisterArrayDeclaration(Page, String, String) |
Inscrit une déclaration de tableau ECMAScript (JavaScript) avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l’intérieur d’un contrôle UpdatePanel et ajoute le tableau à la page. |
| RegisterAsyncPostBackControl(Control) |
Inscrit un contrôle comme déclencheur pour les publications (postback) asynchrones. |
| RegisterClientScriptBlock(Control, Type, String, String, Boolean) |
Inscrit un bloc de script client avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l'intérieur d'un contrôle UpdatePanel, puis ajoute le bloc de script à la page. |
| RegisterClientScriptBlock(Page, Type, String, String, Boolean) |
Inscrit un bloc de script client avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l'intérieur d'un contrôle UpdatePanel, puis ajoute le bloc de script à la page. |
| RegisterClientScriptInclude(Control, Type, String, String) |
Inscrit un fichier de script client avec le contrôle ScriptManager pour une utilisation avec un contrôle situé à l'intérieur d'un contrôle UpdatePanel, puis ajoute une référence de fichier de script à la page. |
| RegisterClientScriptInclude(Page, Type, String, String) |
Inscrit le script client avec le contrôle ScriptManager chaque fois qu'une publication (postback) asynchrone a lieu, puis ajoute une référence de fichier de script à la page. |
| RegisterClientScriptResource(Control, Type, String) |
Inscrit le script client incorporé dans un assembly avec le contrôle ScriptManager pour une utilisation avec un contrôle qui participe au rendu de page partiel. |
| RegisterClientScriptResource(Page, Type, String) |
Inscrit un fichier de script client incorporé dans un assembly avec le contrôle ScriptManager chaque fois qu'une publication (postback) a lieu. |
| RegisterDataItem(Control, String) |
Envoie des données personnalisées à un contrôle pendant le rendu de page partiel. |
| RegisterDataItem(Control, String, Boolean) |
Envoie des données personnalisées à un contrôle pendant le rendu de page partiel et indique si les données sont au format JSON (JavaScript Object Notation). |
| RegisterDispose(Control, String) |
Inscrit un script |
| RegisterExpandoAttribute(Control, String, String, String, Boolean) |
Inscrit une paire nom/valeur avec le contrôle ScriptManager en tant qu'attribut personnalisé (expando) d'un contrôle spécifié. |
| RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control) |
Inscrit un contrôle d'extendeur avec l'instance ScriptManager actuelle. |
| RegisterHiddenField(Control, String, String) |
Inscrit un champ masqué avec le contrôle ScriptManager pour un contrôle situé à l'intérieur d'un contrôle UpdatePanel. |
| RegisterHiddenField(Page, String, String) |
Inscrit un champ masqué avec le contrôle ScriptManager pendant chaque publication (postback) asynchrone. |
| RegisterNamedClientScriptResource(Control, String) |
Inscrit le script client par nom de ressource, incorporé dans un assembly avec le contrôle ScriptManager pour une utilisation avec un contrôle qui participe au rendu de page partiel. |
| RegisterNamedClientScriptResource(Page, String) |
Inscrit le script client par nom de ressource, incorporé dans un assembly avec le contrôle ScriptManager pour une utilisation avec un contrôle qui participe au rendu de page partiel. |
| RegisterOnSubmitStatement(Control, Type, String, String) |
Inscrit le code ECMAScript (JavaScript) avec le contrôle ScriptManager pour un contrôle utilisé avec un contrôle UpdatePanel exécuté quand le formulaire est envoyé. |
| RegisterOnSubmitStatement(Page, Type, String, String) |
Inscrit le code ECMAScript (JavaScript) avec le contrôle ScriptManager pour un contrôle utilisé avec un contrôle UpdatePanel exécuté quand le formulaire est envoyé. |
| RegisterPostBackControl(Control) |
Inscrit un contrôle comme déclencheur pour une publication (postback). Cette méthode est utilisée pour configurer des contrôles de publication (postback) à l'intérieur d'un contrôle UpdatePanel qui, sinon, exécuterait des publications (postback) asynchrones. |
| RegisterScriptControl<TScriptControl>(TScriptControl) |
Inscrit un contrôle de script avec l'instance ScriptManager actuelle. |
| RegisterScriptDescriptors(IExtenderControl) |
Rappelle une classe ExtenderControl pour retourner des scripts d'instance qui doivent être restitués pour prendre en charge l'objet client représentant un contrôle client, un composant ou un comportement. |
| RegisterScriptDescriptors(IScriptControl) |
Appelle une classe ScriptControl pour retourner des scripts d'instance qui doivent être restitués pour prendre en charge l'objet client représentant un contrôle client, un composant ou un comportement. |
| RegisterStartupScript(Control, Type, String, String, Boolean) |
Inscrit un bloc de script de démarrage pour un contrôle situé à l'intérieur d'un UpdatePanel en utilisant le contrôle ScriptManager, et ajoute le bloc de script à la page. |
| RegisterStartupScript(Page, Type, String, String, Boolean) |
Inscrit un bloc de script de démarrage pour chaque publication (postback) asynchrone avec le contrôle ScriptManager et ajoute le bloc de script à la page. |
| RemovedControl(Control) |
Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control. (Hérité de Control) |
| Render(HtmlTextWriter) |
Restitue le contenu du contrôle ScriptManager dans le navigateur à l'aide de l'objet HtmlTextWriter spécifié. |
| RenderChildren(HtmlTextWriter) |
Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client. (Hérité de Control) |
| RenderControl(HtmlTextWriter) |
Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé. (Hérité de Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni. (Hérité de Control) |
| ResolveAdapter() |
Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié. (Hérité de Control) |
| ResolveClientUrl(String) |
Obtient une URL qui peut être utilisée par le navigateur. (Hérité de Control) |
| ResolveUrl(String) |
Convertit une URL en une URL que le client soit en mesure d'utiliser. (Hérité de Control) |
| SaveControlState() |
Enregistre tous les changements d’état de contrôle serveur qui ont eu lieu depuis que la page a été publiée sur le serveur. (Hérité de Control) |
| SaveViewState() |
Enregistre les changements d’état d’affichage du contrôle serveur qui se sont produits depuis que la page a été republiée sur le serveur. (Hérité de Control) |
| SetDesignModeState(IDictionary) |
Définit les données au moment du design pour un contrôle. (Hérité de Control) |
| SetFocus(Control) |
Affecte au focus du navigateur le contrôle spécifié. |
| SetFocus(String) |
Affecte au focus du navigateur le contrôle spécifié par ID. |
| SetRenderMethodDelegate(RenderMethod) |
Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent. (Hérité de Control) |
| SetTraceData(Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace. (Hérité de Control) |
| SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace. (Hérité de Control) |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
| TrackViewState() |
Provoque le suivi des modifications de l'état d'affichage pour le contrôle serveur afin qu'elles puissent être stockées dans l'objet StateBag du contrôle serveur. Cet objet est accessible via la propriété ViewState. (Hérité de Control) |
Événements
| AsyncPostBackError |
Se produit en cas d'erreur de page pendant une publication (postback) asynchrone. |
| DataBinding |
Se produit lorsque le contrôle serveur se lie à une source de données. (Hérité de Control) |
| Disposed |
Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET. (Hérité de Control) |
| Init |
Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie. (Hérité de Control) |
| Load |
Se produit lorsque le contrôle serveur est chargé dans l'objet Page. (Hérité de Control) |
| Navigate |
Se produit quand l’utilisateur clique sur le bouton Précédent ou Suivant du navigateur. |
| PreRender |
Se produit après le chargement de l'objet Control mais avant le rendu. (Hérité de Control) |
| ResolveCompositeScriptReference |
Se produit quand un script composite est inscrit auprès du contrôle ScriptManager. |
| ResolveScriptReference |
Se produit quand un membre de la collection Scripts est inscrit avec le contrôle ScriptManager. |
| Unload |
Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control) |
Implémentations d’interfaces explicites
| IControlBuilderAccessor.ControlBuilder |
Pour obtenir une description de ce membre, consultez ControlBuilder. (Hérité de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Pour obtenir une description de ce membre, consultez GetDesignModeState(). (Hérité de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary). (Hérité de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Pour obtenir une description de ce membre, consultez SetOwnerControl(Control). (Hérité de Control) |
| IControlDesignerAccessor.UserData |
Pour obtenir une description de ce membre, consultez UserData. (Hérité de Control) |
| IDataBindingsAccessor.DataBindings |
Pour obtenir une description de ce membre, consultez DataBindings. (Hérité de Control) |
| IDataBindingsAccessor.HasDataBindings |
Pour obtenir une description de ce membre, consultez HasDataBindings. (Hérité de Control) |
| IExpressionsAccessor.Expressions |
Pour obtenir une description de ce membre, consultez Expressions. (Hérité de Control) |
| IExpressionsAccessor.HasExpressions |
Pour obtenir une description de ce membre, consultez HasExpressions. (Hérité de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object). (Hérité de Control) |
| IPostBackDataHandler.LoadPostData(String, NameValueCollection) |
Pour obtenir une description de ce membre, consultez LoadPostData(String, NameValueCollection). |
| IPostBackDataHandler.RaisePostDataChangedEvent() |
Pour obtenir une description de ce membre, consultez RaisePostDataChangedEvent(). |
| IPostBackEventHandler.RaisePostBackEvent(String) |
Permet au contrôle ScriptManager de traiter un événement de publication (postback) et de charger l’état de l’historique de la page web. |
Méthodes d’extension
| FindDataSourceControl(Control) |
Retourne la source de données associée au contrôle de données pour le contrôle spécifié. |
| FindFieldTemplate(Control, String) |
Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié. |
| FindMetaTable(Control) |
Retourne l'objet Metatable pour le contrôle de données conteneur. |
S’applique à
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour