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 ASP.NET bibliothèques de scripts Ajax et les fichiers de script, le rendu de pages partielles et la génération de classes 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 montrent différents scénarios d’utilisation du ScriptManager contrôle.
Activation des mises à jour Partial-Page
L’exemple suivant montre comment utiliser le ScriptManager contrôle pour activer les mises à jour de pages partielles. Dans cet exemple, un Calendar contrôle 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 provoquent 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 de l’inscription du script
L’exemple suivant montre comment fournir une gestion des erreurs personnalisée pendant les mises à jour partielles de page. Par défaut, lorsqu’une erreur se produit pendant les 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 pendant les mises à jour de pages partielles. 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 du navigateur actuel détermine la culture et la culture de l’interface utilisateur de la page. Pour plus d’informations, consultez How to : Set the Culture and UI Culture for ASP.NET Web Page Globalization.
<%@ Page Language="C#" Culture="auto" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>Globalization Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
</asp:ScriptManager>
<script type="text/javascript">
function pageLoad() {
Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
}
function formatDate() {
var d = new Date();
try {
$get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
}
catch(e) {
alert("Error:" + e.message);
}
}
</script>
<asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
<ContentTemplate>
<asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
<asp:Button ID="Button1" runat="server" Text="Display Date" />
<br />
<asp:Label ID="Label1" runat="server"></asp:Label>
</asp:Panel>
</ContentTemplate>
</asp:UpdatePanel>
</form>
</body>
</html>
<%@ Page Language="VB" Culture="auto" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>Globalization Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
</asp:ScriptManager>
<script type="text/javascript">
function pageLoad() {
Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
}
function formatDate() {
var d = new Date();
try {
$get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
}
catch(e) {
alert("Error:" + e.message);
}
}
</script>
<asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
<ContentTemplate>
<asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
<asp:Button ID="Button1" runat="server" Text="Display Date" />
<br />
<asp:Label ID="Label1" runat="server"></asp:Label>
</asp:Panel>
</ContentTemplate>
</asp:UpdatePanel>
</form>
</body>
</html>
Remarques
Dans cette rubrique :
Présentation
Le ScriptManager contrôle est essentiel à la fonctionnalité Ajax dans ASP.NET. Le contrôle gère toutes les ressources Ajax ASP.NET 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 partielles de page activées à l’aide UpdatePanel de contrôles. En outre, le ScriptManager contrôle vous permet d’effectuer les opérations suivantes :
Inscrivez 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 du script en inscrivant des services Web auprès du ScriptManager contrôle.
Fournissez l’accès à ASP.NET services d’authentification, de rôle et d’application de profil à partir du script client en inscrivant ces services auprès du ScriptManager contrôle.
Activez l’affichage propre à la culture des fonctions Date, Nombre et Chaîne ECMAScript (JavaScript) 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 le ou IScriptControl les IExtenderControl interfaces avec le contrôle afin que le ScriptManager script requis par les composants clients et les comportements soit rendu.
rendu Partial-Page
La capacité d’une page ASP.NET à prendre en charge le rendu de pages partielles est contrôlée par les facteurs suivants :
La ScriptManager propriété du EnablePartialRendering contrôle doit être
true(la 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é une fois 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 restitue le ScriptManager script pour activer les postbacks 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 postbacks asynchrones et actualise uniquement les régions de la page qui doivent être mises à jour. Pour plus d’informations sur le rendu de pages partielles, consultez Partial-Page Vue d’ensemble du rendu. Pour plus d’informations sur les conditions qui provoquent une mise à jour, consultez UpdatePanel Control Overview.
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 les pages imbriquées, les contrôles utilisateur ou les composants lorsque la page parente possède déjà un ScriptManager contrôle, utilisez le ScriptManagerProxy contrôle. Pour plus d’informations, consultez Utilisation du contrôle UpdatePanel avec les pages maîtres.
Gestion des scripts et inscription
Le ScriptManager contrôle vous permet d’inscrire un script qui est ensuite rendu dans le cadre de la page. Les ScriptManager méthodes d’inscription de contrôle peuvent être divisées en trois catégories suivantes :
Les 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 compatibles avec UpdatePanel les contrôles.
Méthodes d’inscription qui prennent en charge l’utilisation de UpdatePanel contrôles.
Pour plus d’informations sur la création et l’utilisation du script Ajax dans ASP.NET, consultez Création de 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 d’une manière qui garantit 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 restitue 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 restitue le script qui prend en charge l’objet client. |
Inscription de scripts compatibles avec Partial-Page mise à jour
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 un rendu de 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 | Affiche 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 de noms de type/ressource qui existe déjà, l’élément script qui 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 des valeurs de tableau est autorisée.
Lorsque vous appelez la méthode ou la RegisterClientScriptIncludeRegisterClientScriptResource méthode, é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 partielles de page lorsque vous utilisez UpdatePanel des contrôles.
| Méthode | Définition |
|---|---|
| RegisterAsyncPostBackControl | Inscrit un contrôle en tant que déclencheur pour les postbacks asynchrones. |
| RegisterDataItem | Envoie des données personnalisées aux contrôles pendant le rendu de page partielle. |
| RegisterDispose | Inscrit un script de suppression pour un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle. Le script est exécuté lorsque le UpdatePanel contrôle 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 effectuerait autrement des postbacks asynchrones. |
Références de service web
Vous pouvez inscrire un service Web à appeler à partir du 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 collection pour inscrire des services Web au moment de l’exécution Services .
Pour plus d’informations sur l’accès aux services Web dans le script, consultez Exposing Web Services to Client Script in ASP.NET AJAX and Calling Web Services from Client Script in ASP.NET AJAX.
Localization
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 des fichiers de script incorporés dans des assemblys ou des fichiers de script autonomes.
Lorsque la EnableScriptLocalization propriété est définie truesur , le ScriptManager contrôle récupère des ressources localisées (telles que des chaînes localisées) pour la culture actuelle, le cas échéant. Le ScriptManager contrôle fournit les fonctionnalités suivantes pour utiliser des 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 de l’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 d’afficher 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 portant un nom tel que
scriptname.en-MX.debug.js, si le fichier existe. Si le fichier n’existe pas, le fichier de débogage pour la culture de secours appropriée est rendu
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 postbacks 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 propriété, de la AllowCustomErrorsRedirectAsyncPostBackErrorMessage 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
| Nom | Description |
|---|---|
| ScriptManager() |
Initialise une nouvelle instance de la classe ScriptManager. |
Propriétés
| Nom | Description |
|---|---|
| Adapter |
Obtient l’adaptateur spécifique au navigateur pour le contrôle. (Hérité de Control) |
| AjaxFrameworkAssembly |
Obtient l’assembly de framework Ajax que les composants de la page utilisent. |
| AjaxFrameworkMode |
Obtient ou définit une valeur qui spécifie la façon dont les scripts clients de la bibliothèque cliente Microsoft Ajax seront inclus sur le client. |
| AllowCustomErrorsRedirect |
Obtient ou définit une valeur qui détermine si la section erreurs personnalisées du fichier Web.config est utilisée lors d’une erreur dans une publication asynchrone. |
| AppRelativeTemplateSourceDirectory |
Obtient ou définit le répertoire virtuel relatif à l’application du ou UserControl de l’objet Page qui contient ce contrôle. (Hérité de Control) |
| AsyncPostBackErrorMessage |
Obtient ou définit le message d’erreur envoyé au client lorsqu’une exception de serveur non gérée se produit pendant une publication asynchrone. |
| AsyncPostBackSourceElementID |
Obtient l’ID unique du contrôle qui a provoqué la publication asynchrone. |
| AsyncPostBackTimeout |
Obtient ou définit une valeur qui indique l’heure, en secondes, avant l’expiration asynchrone des postbacks si aucune réponse n’est reçue. |
| AuthenticationService |
Obtient l’objet AuthenticationServiceManager associé à l’instance actuelle ScriptManager . |
| 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 les contrôles enfants du contrôle serveur ont été créés. (Hérité de Control) |
| ClientID |
Obtient l’ID de contrôle pour le 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 ClientID propriété. (Hérité de Control) |
| ClientIDSeparator |
Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété. (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 requête Web actuelle. (Hérité de Control) |
| Controls |
Obtient un ControlCollection objet qui représente les contrôles enfants d’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’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente . (Hérité de Control) |
| DataKeysContainer |
Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente . (Hérité de Control) |
| DesignMode |
Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception. (Hérité de Control) |
| EmptyPageUrl |
Obtient ou définit une URL vers une page Web vide. |
| EnableCdn |
Détermine si la page active charge les références de script client à partir des chemins CDN (Content Delivery Network). |
| EnableCdnFallback |
Permet à la copie locale d’un script de charger en cas d’indisponibilité du CDN (Content Delivery Network). |
| 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 statique publique d’une page ASP.NET peuvent être appelées à partir du 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 les régions de la page individuellement à l’aide UpdatePanel de contrôles. |
| EnableScriptGlobalization |
Obtient ou définit une valeur qui indique si le contrôle restitue le ScriptManager script qui prend en charge l’analyse et la mise en forme d’informations spécifiques à la culture. |
| EnableScriptLocalization |
Obtient ou définit une valeur qui indique si le ScriptManager contrôle affiche les 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 d’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 des contrôles enfants qu’il contient, au client demandeur. (Hérité de Control) |
| Events |
Obtient une liste de délégués de gestionnaire 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 actuel ont des paramètres d’état d’affichage enregistrés. (Hérité de Control) |
| ID |
Obtient ou définit l’identificateur programmatique affecté au contrôle serveur. (Hérité de Control) |
| IdSeparator |
Obtient le caractère utilisé pour séparer les identificateurs de contrôle. (Hérité de Control) |
| IsChildControlStateCleared |
Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle. (Hérité de Control) |
| IsDebuggingEnabled |
Obtient une valeur qui indique si les versions de débogage des bibliothèques de script client seront rendues. |
| IsInAsyncPostBack |
Obtient une valeur qui indique si la publication actuelle est exécutée en mode de rendu partiel. |
| IsNavigating |
Obtient une valeur qui indique si un Navigate événement est en cours de traitement. |
| 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 de l’interface utilisateur de la page. |
| LoadViewStateByID |
Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage ID au lieu de l’index. (Hérité de Control) |
| NamingContainer |
Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété. (Hérité de Control) |
| Page |
Obtient une référence à l’instance 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 page. (Hérité de Control) |
| ProfileService |
Obtient l’objet ProfileServiceManager associé à l’instance actuelle ScriptManager . |
| RenderingCompatibility |
Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible. (Hérité de Control) |
| RoleService |
Obtient l’objet RoleServiceManager associé à l’instance actuelle ScriptManager . |
| ScriptMode |
Obtient ou définit une valeur qui spécifie si les versions de débogage ou de mise en production des bibliothèques de script client sont rendues. |
| ScriptPath |
Obsolète.
Obtient ou définit le chemin racine de l’emplacement utilisé pour générer les chemins d’accès à ASP.NET Ajax et aux fichiers de script personnalisés. |
| ScriptResourceMapping |
Obtient un ScriptResourceMapping objet. |
| Scripts |
Obtient un ScriptReferenceCollection objet qui contient les ScriptReference objets, chacun représentant un fichier de script rendu au client. |
| Services |
Obtient un objet qui contient un ServiceReferenceCollectionServiceReference objet pour chaque service Web qui ASP.NET s’expose sur le client pour la fonctionnalité Ajax. |
| Site |
Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception. (Hérité de Control) |
| SkinID |
Obtient ou définit la peau à appliquer au contrôle. (Hérité de Control) |
| SupportsPartialRendering |
Obtient une valeur qui indique si le client prend en charge le rendu de pages partielles. |
| 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 PageUserControl ou qui contient le contrôle serveur actuel. (Hérité de Control) |
| UniqueID |
Obtient l’identificateur unique qualifié hiérarchiquement pour le 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 du client à partir du navigateur pour obtenir des 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 sur plusieurs requêtes pour la même page. (Hérité de Control) |
| ViewStateIgnoresCase |
Obtient une valeur qui indique si l’objet ne respecte pas la StateBag 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 |
Remplace la Visible propriété héritée de la classe de base Control pour empêcher la définition de cette valeur. |
Méthodes
| Nom | Description |
|---|---|
| AddedControl(Control, Int32) |
Appelé après l’ajout d’un contrôle enfant à la Controls collection 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, 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. |
| 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. |
| AddParsedSubObject(Object) |
Avertit le contrôle serveur qu’un élément, XML ou HTML, a été analysé et ajoute l’élément à l’objet du ControlCollection contrôle serveur. (Hérité de Control) |
| ApplyStyleSheetSkin(Page) |
Applique les propriétés de style définies dans la feuille de style de page au contrôle. (Hérité de Control) |
| BeginRenderTracing(TextWriter, Object) |
Commence le suivi 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 le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page. (Hérité de Control) |
| ClearCachedClientID() |
Définit la valeur mise en ClientID cache sur |
| ClearChildControlState() |
Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur. (Hérité de Control) |
| ClearChildState() |
Supprime les informations d’état d’affichage et d’état de contrôle pour 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() |
Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit. (Hérité de Control) |
| CreateChildControls() |
Appelé par l’infrastructure de page ASP.NET pour notifier les contrôles serveur qui utilisent l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en préparation de la publication ou du rendu. (Hérité de Control) |
| CreateControlCollection() |
Crée un ControlCollection objet pour contenir les contrôles enfants (littéral 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 de serveur d’effectuer le nettoyage final avant de libérer de la mémoire. (Hérité de Control) |
| EndRenderTracing(TextWriter, Object) |
Met fin au suivi 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. Si ce n’est pas le cas, il crée des contrôles enfants. (Hérité de Control) |
| EnsureID() |
Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté. (Hérité de Control) |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| FindControl(String, Int32) |
Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié |
| FindControl(String) |
Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié |
| Focus() |
Définit le focus d’entrée sur un contrôle. (Hérité de Control) |
| GetCurrent(Page) |
Obtient l’instance ScriptManager d’un objet donné Page . |
| GetDesignModeState() |
Obtient les données au moment du design pour un contrôle. (Hérité de Control) |
| GetHashCode() |
Sert 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) qui ont été précédemment inscrites auprès de l’objet Page . |
| GetRegisteredClientScriptBlocks() |
Récupère une collection en lecture seule de blocs de script client qui ont été précédemment inscrits auprès du ScriptManager contrôle. |
| GetRegisteredDisposeScripts() |
Récupère une collection en lecture seule de |
| GetRegisteredExpandoAttributes() |
Récupère une collection en lecture seule d’attributs personnalisés (expando) qui ont été précédemment inscrits auprès de l’objet Page . |
| GetRegisteredHiddenFields() |
Récupère une collection en lecture seule de champs masqués qui ont été précédemment inscrits auprès de l’objet Page . |
| GetRegisteredOnSubmitStatements() |
Récupère une collection en lecture seule d’instructions qui ont été précédemment inscrites auprès de |
| GetRegisteredStartupScripts() |
Récupère une collection en lecture seule de scripts de démarrage qui ont été précédemment inscrits auprès de l’objet Page . |
| GetRouteUrl(Object) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtient l’URL qui correspond à un ensemble de paramètres de routage. (Hérité de Control) |
| GetRouteUrl(String, Object) |
Obtient l’URL qui correspond à un ensemble 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 ensemble 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 la Type de l’instance actuelle. (Hérité de Object) |
| GetUniqueIDRelativeTo(Control) |
Retourne la partie préfixée de la UniqueID propriété 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 les événements sont inscrits pour le contrôle ou les contrôles enfants. (Hérité de Control) |
| IsLiteralContent() |
Détermine si le contrôle serveur contient uniquement du contenu littéral. (Hérité de Control) |
| LoadControlState(Object) |
Restaure les informations d’état du contrôle à partir d’une demande de page précédente qui a été enregistrée par la SaveControlState() méthode. (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 asynchrone. |
| LoadViewState(Object) |
Restaure les informations d’état d’affichage à partir d’une demande de page précédente enregistrée par la SaveViewState() méthode. (Hérité de Control) |
| MapPathSecure(String) |
Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé. (Hérité de Control) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| OnAsyncPostBackError(AsyncPostBackErrorEventArgs) |
Déclenche l’événement AsyncPostBackError. |
| OnBubbleEvent(Object, EventArgs) |
Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’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 vérifie qu’un ScriptManager seul contrôle 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 partielles de page. |
| 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 ScriptManager contrôle. |
| OnUnload(EventArgs) |
Déclenche l’événement Unload. (Hérité de Control) |
| OpenFile(String) |
Obtient un Stream élément utilisé pour lire un fichier. (Hérité de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Affecte toutes les sources de l’événement et ses informations au parent du contrôle. (Hérité de Control) |
| RaisePostBackEvent(String) |
Traite un événement de publication déclenché par le ScriptManager contrôle et charge l’état d’historique de la page Web. |
| RaisePostDataChangedEvent() |
Déclenche des événements pour le ScriptManager contrôle lorsqu’il publie sur le serveur. |
| RegisterArrayDeclaration(Control, String, String) |
Inscrit une déclaration de tableau ECMAScript (JavaScript) auprès du ScriptManager contrôle à utiliser avec un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle et ajoute le tableau à la page. |
| RegisterArrayDeclaration(Page, String, String) |
Inscrit une déclaration de tableau ECMAScript (JavaScript) auprès du ScriptManager contrôle à utiliser avec un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle et ajoute le tableau à la page. |
| RegisterAsyncPostBackControl(Control) |
Inscrit un contrôle en tant que déclencheur pour les postbacks asynchrones. |
| RegisterClientScriptBlock(Control, Type, String, String, Boolean) |
Inscrit un bloc de script client auprès du ScriptManager contrôle à utiliser avec un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle, puis ajoute le bloc de script à la page. |
| RegisterClientScriptBlock(Page, Type, String, String, Boolean) |
Inscrit un bloc de script client auprès du ScriptManager contrôle à utiliser avec un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle, puis ajoute le bloc de script à la page. |
| RegisterClientScriptInclude(Control, Type, String, String) |
Inscrit un fichier de script client auprès du ScriptManager contrôle à utiliser avec un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle, puis ajoute une référence de fichier de script à la page. |
| RegisterClientScriptInclude(Page, Type, String, String) |
Inscrit le script client auprès du ScriptManager contrôle chaque fois qu’une publication asynchrone se produit, 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 ScriptManager contrôle à utiliser avec un contrôle participant au rendu de page partielle. |
| RegisterClientScriptResource(Page, Type, String) |
Inscrit un fichier de script client incorporé dans un assembly avec le ScriptManager contrôle chaque fois qu’un postback se produit. |
| RegisterDataItem(Control, String, Boolean) |
Envoie des données personnalisées à un contrôle pendant le rendu de page partielle et indique si les données sont au format JSON (JavaScript Object Notation). |
| RegisterDataItem(Control, String) |
Envoie des données personnalisées à un contrôle pendant le rendu de page partielle. |
| RegisterDispose(Control, String) |
Inscrit un |
| RegisterExpandoAttribute(Control, String, String, String, Boolean) |
Inscrit une paire nom/valeur avec le ScriptManager contrôle en tant qu’attribut personnalisé (expando) d’un contrôle spécifié. |
| RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control) |
Inscrit un contrôle d’extendeur auprès de l’instance actuelle ScriptManager . |
| RegisterHiddenField(Control, String, String) |
Inscrit un champ masqué auprès du ScriptManager contrôle d’un contrôle qui se trouve à l’intérieur d’un UpdatePanel contrôle. |
| RegisterHiddenField(Page, String, String) |
Inscrit un champ masqué auprès du ScriptManager contrôle pendant chaque publication asynchrone. |
| RegisterNamedClientScriptResource(Control, String) |
Inscrit le script client par nom de ressource incorporé dans un assembly avec le ScriptManager contrôle à utiliser avec un contrôle participant au rendu de page partielle. |
| RegisterNamedClientScriptResource(Page, String) |
Inscrit le script client par nom de ressource incorporé dans un assembly avec le ScriptManager contrôle à utiliser avec un contrôle participant au rendu de page partielle. |
| RegisterOnSubmitStatement(Control, Type, String, String) |
Inscrit le code ECMAScript (JavaScript) auprès du ScriptManager contrôle d’un contrôle utilisé avec un UpdatePanel contrôle exécuté lors de l’envoi du formulaire. |
| RegisterOnSubmitStatement(Page, Type, String, String) |
Inscrit le code ECMAScript (JavaScript) auprès du ScriptManager contrôle d’un contrôle utilisé avec un UpdatePanel contrôle exécuté lors de l’envoi du formulaire. |
| RegisterPostBackControl(Control) |
Inscrit un contrôle en tant que déclencheur pour une publication différée. Cette méthode est utilisée pour configurer des contrôles de publication à l’intérieur d’un UpdatePanel contrôle qui effectuerait autrement des postbacks asynchrones. |
| RegisterScriptControl<TScriptControl>(TScriptControl) |
Inscrit un contrôle de script auprès de l’instance actuelle ScriptManager . |
| RegisterScriptDescriptors(IExtenderControl) |
Renvoie une classe pour retourner des scripts d’instance ExtenderControl qui doivent être rendus pour prendre en charge l’objet client qui représente un contrôle client, un composant ou un comportement. |
| RegisterScriptDescriptors(IScriptControl) |
Appelle une classe pour retourner des scripts d’instance ScriptControl qui doivent être rendus pour prendre en charge l’objet client qui représente 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 qui se trouve à l’intérieur d’un UpdatePanel contrôle à l’aide du ScriptManager contrôle 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 asynchrone auprès du ScriptManager contrôle et ajoute le bloc de script à la page. |
| RemovedControl(Control) |
Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control . (Hérité de Control) |
| Render(HtmlTextWriter) |
Affiche le ScriptManager contenu du contrôle dans le navigateur à l’aide de l’objet spécifié HtmlTextWriter . |
| RenderChildren(HtmlTextWriter) |
Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client. (Hérité de Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter . (Hérité de Control) |
| RenderControl(HtmlTextWriter) |
Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé. (Hérité de Control) |
| ResolveAdapter() |
Obtient l’adaptateur de contrôle 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 utilisable sur le client demandeur. (Hérité de Control) |
| SaveControlState() |
Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur. (Hérité de Control) |
| SaveViewState() |
Enregistre les modifications de l’état d’affichage du contrôle de serveur qui se sont produites depuis la publication de la page 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) |
Définit le focus du navigateur sur le contrôle spécifié. |
| SetFocus(String) |
Définit le focus du navigateur sur le contrôle spécifié par ID. |
| SetRenderMethodDelegate(RenderMethod) |
Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent. (Hérité de Control) |
| SetTraceData(Object, Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace. (Hérité de Control) |
| SetTraceData(Object, Object) |
Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de 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 d’état d’affichage apportées au contrôle serveur afin qu’ils puissent être stockés dans l’objet du StateBag contrôle serveur. Cet objet est accessible via la ViewState propriété. (Hérité de Control) |
Événements
| Nom | Description |
|---|---|
| AsyncPostBackError |
Se produit lorsqu’une erreur de page se produit lors d’une publication 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, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée. (Hérité de Control) |
| Init |
Se produit lorsque le contrôle serveur est initialisé, qui est 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 lorsque l’utilisateur clique sur le bouton Précédent ou Transfert du navigateur. |
| PreRender |
Se produit après le chargement de l’objet Control , mais avant le rendu. (Hérité de Control) |
| ResolveCompositeScriptReference |
Se produit lorsqu’un script composite est inscrit auprès du ScriptManager contrôle. |
| ResolveScriptReference |
Se produit lorsqu’un membre de la Scripts collection est inscrit auprès du ScriptManager contrôle. |
| Unload |
Se produit lorsque le contrôle serveur est déchargé de la mémoire. (Hérité de Control) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| 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 ScriptManager contrôle de traiter un événement de publication et de charger l’état d’historique de la page Web. |
Méthodes d’extension
| Nom | Description |
|---|---|
| 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 de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié. |
| FindMetaTable(Control) |
Retourne l’objet métatable pour le contrôle de données contenant. |
