Partager via


ScriptManager Classe

Définition

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 IPostBackEventHandler
Public Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler
Héritage
ScriptManager
Attributs
Implémente

Exemples

Les exemples suivants illustrent différents scénarios d’utilisation du ScriptManager contrôle.

Activation des mises à jour Partial-Page

L’exemple suivant montre comment utiliser le contrôle pour activer les ScriptManager mises à jour de page partielles. 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 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 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 des mises à jour partielles, 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 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 des 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 au cœur de 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 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 :

  • Inscrivez un script compatible avec les mises à jour de page partielles. 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 d’un script client en inscrivant ces services auprès du ScriptManager contrôle.

  • Activez l’affichage spécifique à 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 les IExtenderControl interfaces ou IScriptControl avec le contrôle afin que le ScriptManager script requis par les composants et les comportements du client soit rendu.

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 :

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 la page s’est Init 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 page 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 dispose déjà d’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 :

  • 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 des UpdatePanel 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 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 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 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 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 null.

(Hérité de Control)
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 id spécifié dans le conteneur d'attribution de noms actuel.

(Hérité de Control)
FindControl(String, Int32)

Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl.

(Hérité de Control)
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 dispose précédemment inscrits avec l’objet Page.

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 onsubmit précédemment inscrites avec l’objet Page.

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 dispose pour un contrôle situé à l'intérieur d'un contrôle UpdatePanel. Le script est exécuté quand le contrôle UpdatePanel est mis à jour ou supprimé.

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