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.Manages ASP.NET Ajax script libraries and script files, partial-page rendering, and client proxy class generation for Web and application services.

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.The following examples show different scenarios for using the ScriptManager control.

Activation des mises à jour de Partial-PageEnabling Partial-Page Updates

L’exemple suivant montre comment utiliser le ScriptManager contrôle pour activer les mises à jour de pages partielles.The following example shows how to use the ScriptManager control to enable partial-page updates. Dans cet exemple, un Calendar et un DropDownList contrôle se trouvent à l’intérieur d’un UpdatePanel contrôle.In this example, a Calendar and a DropDownList control are inside an UpdatePanel control. Par défaut, la valeur de la UpdateMode propriété est Always , et la valeur de la ChildrenAsTriggers propriété est true .By default, the value of the UpdateMode property is Always, and the value of the ChildrenAsTriggers property is true. Par conséquent, les contrôles enfants du volet provoquent une publication (postback) asynchrone.Therefore, child controls of the panel cause an asynchronous postback.


<%@ 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 enregistrement du scriptHandling Partial-Page Update Errors and Registering Script

L’exemple suivant montre comment fournir une gestion des erreurs personnalisée lors des mises à jour de pages partielles.The following example shows how to provide custom error handling during partial-page updates. Par défaut, lorsqu’une erreur se produit pendant des mises à jour de pages partielles, une boîte de message JavaScript s’affiche.By default, when an error occurs during partial-page updates, a JavaScript message box is displayed. Cet exemple montre comment utiliser la gestion personnalisée des erreurs en fournissant un gestionnaire pour l' AsyncPostBackError événement et en définissant la AsyncPostBackErrorMessage propriété dans le gestionnaire d’événements.This example demonstrates how to use custom error handling by providing a handler for the AsyncPostBackError event, and by setting the AsyncPostBackErrorMessage property in the event handler. Vous pouvez également définir la AllowCustomErrorsRedirect propriété pour spécifier comment la section d’erreurs personnalisées du fichier Web.config est utilisée lorsqu’une erreur se produit pendant des mises à jour de pages partielles.You can also set the AllowCustomErrorsRedirect property to specify how the custom errors section of the Web.config file is used when an error occurs during partial-page updates. Dans cet exemple, la valeur par défaut de la AllowCustomErrorsRedirect propriété est utilisée.In this example, the default value of the AllowCustomErrorsRedirect property is used. 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.This means that if the Web.config file contains a customErrors element, that element determines how errors are displayed. Pour plus d’informations, consultez customErrors, élément (schéma des paramètres ASP.net).For more information, see customErrors Element (ASP.NET Settings Schema).

<%@ 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 navigateurGlobalizing the Date and Time That Are Displayed in the Browser

L’exemple suivant montre comment définir la EnableScriptGlobalization propriété afin que le script client puisse afficher une date et une heure spécifiques à la culture dans le navigateur.The following example shows how to set the EnableScriptGlobalization property so that client script can display a culture-specific date and time in the browser. Dans l’exemple, l' Culture attribut de la directive @ page a la valeur auto .In the example, the Culture attribute of the @ Page directive is set to 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 pour la page.As a result, the first language that is specified in the current browser settings determines the culture and UI culture for the page. Pour plus d’informations, consultez Comment : définir la culture et la culture d’interface utilisateur pour la globalisation des pages Web ASP.net.For more information, see 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 :In this topic:

IntroductionIntroduction

Le ScriptManager contrôle est central pour les fonctionnalités AJAX dans ASP.net.The ScriptManager control is central to Ajax functionality in ASP.NET. Le contrôle gère toutes les ressources ASP.NET AJAX sur une page.The control manages all ASP.NET Ajax resources on a page. Cela comprend le téléchargement de scripts Microsoft AJAX Library dans le navigateur et la coordination des mises à jour de pages partielles qui sont activées à l’aide de UpdatePanel contrôles.This includes downloading Microsoft Ajax Library scripts to the browser and coordinating partial-page updates that are enabled by using UpdatePanel controls. En outre, le ScriptManager contrôle vous permet d’effectuer les opérations suivantes :In addition, the ScriptManager control enables you to do the following:

  • Inscrire un script compatible avec les mises à jour de pages partielles.Register script that is compatible with partial-page updates. Afin de gérer les dépendances entre votre script et la bibliothèque principale, tout script que vous inscrivez est chargé après le script Microsoft AJAX Library.In order to manage dependencies between your script and the core library, any script that you register is loaded after the Microsoft Ajax Library script.

  • Spécifiez si les scripts de mise en sortie ou de débogage sont envoyés au navigateur.Specify whether release or debug scripts are sent to the browser.

  • Fournir un accès aux méthodes de service Web à partir d’un script en inscrivant des services Web avec le ScriptManager contrôle.Provide access to Web service methods from script by registering Web services with the ScriptManager control.

  • Fournir un accès à l’authentification ASP.NET, au rôle et aux services d’application de profil à partir du script client en inscrivant ces services auprès du ScriptManager contrôle.Provide access to ASP.NET authentication, role, and profile application services from client script by registering these services with the ScriptManager control.

  • Activez l’affichage spécifique à la culture des fonctions de Date, de nombreet de chaîne ECMAScript (JavaScript) dans le navigateur.Enable culture-specific display of ECMAScript (JavaScript) Date, Number, and String functions in the browser.

  • Accédez aux ressources de localisation des fichiers de script incorporés ou des fichiers de script autonomes à l’aide ResourceUICultures de la propriété du ScriptReference contrôle.Access localization resources for embedded script files or for stand-alone script files by using the ResourceUICultures property of the ScriptReference control.

  • Inscrire des contrôles serveur qui implémentent les IExtenderControl IScriptControl interfaces ou avec le ScriptManager contrôle afin que le script requis par les composants et les comportements clients soit rendu.Register server controls that implement the IExtenderControl or IScriptControl interfaces with the ScriptManager control so that script required by client components and behaviors is rendered.

Rendu Partial-PagePartial-Page Rendering

La capacité d’une page ASP.NET à prendre en charge le rendu de page partiel est contrôlée par les facteurs suivants :The ability of an ASP.NET page to support partial-page rendering is controlled by the following factors:

Vous pouvez substituer la valeur de la EnablePartialRendering propriété au moment de l’exécution pendant ou avant l’événement de la page Init .You can override the value of the EnablePartialRendering property at run time during or before the page's Init event. Si vous essayez de modifier cette propriété une fois que l’événement de la page Init s’est produit, une InvalidOperationException exception est levée.If you try to change this property after the page's Init event has occurred, an InvalidOperationException exception is thrown.

Lorsque le rendu de page partielle est pris en charge, le ScriptManager contrôle restitue le script pour activer les publications (postback) asynchrones et les mises à jour de pages partielles.When partial-page rendering is supported, the ScriptManager control renders script to enable asynchronous postbacks and partial-page updates. Les zones de la page à mettre à jour sont désignées à l’aide de UpdatePanel contrôles.The regions of the page to be updated are designated by using UpdatePanel controls. Le ScriptManager contrôle gère les publications (postback) asynchrones et actualise uniquement les zones de la page qui doivent être mises à jour.The ScriptManager control handles the asynchronous postbacks and refreshes only the regions of the page that have to be updated. Pour plus d’informations sur le rendu de page partielle, consultez vue d’ensemble du rendu de page partiel.For more information about partial-page rendering, see Partial-Page Rendering Overview. Pour plus d’informations sur les conditions qui provoquent une mise à jour, consultez vue d’ensemble du contrôle UpdatePanel.For more information about the conditions that cause an update, see UpdatePanel Control Overview.

Utilisation du contrôle ScriptManager avec des pages maîtres, des contrôles utilisateur et d’autres composants enfantsUsing the ScriptManager Control with Master Pages, User Controls, and Other Child Components

Une page ne peut contenir qu’un seul ScriptManager contrôle dans sa hiérarchie.A page can contain only one ScriptManager control in its hierarchy. Pour inscrire des services et des scripts pour les pages imbriquées, les contrôles utilisateur ou les composants lorsque la page parente a déjà un ScriptManager contrôle, utilisez le ScriptManagerProxy contrôle.To register services and scripts for nested pages, user controls, or components when the parent page already has a ScriptManager control, use the ScriptManagerProxy control. Pour plus d’informations, consultez utilisation du contrôle UpdatePanel avec les pages maîtres.For more information, see Using the UpdatePanel Control with Master Pages.

Gestion et inscription de scriptsScript Management and Registration

Le ScriptManager contrôle vous permet d’inscrire un script qui est ensuite restitué dans le cadre de la page.The ScriptManager control enables you to register script that is then rendered as part of the page. Les ScriptManager méthodes d’inscription de contrôle peuvent être décomposées dans les trois catégories suivantes :The ScriptManager control registration methods can be broken into the following three categories:

  • Méthodes d’inscription garantissant que les dépendances de script sur Microsoft AJAX Library sont conservées.Registration methods that guarantee that script dependencies on the Microsoft Ajax Library are maintained.

  • Méthodes d’inscription qui ne dépendent pas de Microsoft AJAX Library, mais qui sont compatibles avec les UpdatePanel contrôles.Registration methods that are not dependent on the Microsoft Ajax Library, but that are compatible with UpdatePanel controls.

  • Méthodes d’inscription qui prennent en charge l’utilisation des UpdatePanel contrôles.Registration methods that support working with UpdatePanel controls.

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 Microsoft AJAX Library.For more information about how to create and use Ajax script in ASP.NET, see Creating Custom Client Script by Using the Microsoft Ajax Library.

Inscription d’un script dépendant de Microsoft AJAX LibraryRegistering Script That Is Dependent on the Microsoft Ajax Library

Vous pouvez utiliser les méthodes suivantes pour enregistrer des fichiers de script d’une façon qui garantit que toutes les dépendances de Microsoft AJAX Library sont conservées.You can use the following methods to register script files in a way that guarantees that any dependencies on the Microsoft Ajax Library are maintained.

MéthodeMethod DéfinitionDefinition
RegisterScriptControl Inscrit un contrôle serveur qui implémente l' IScriptControl interface utilisée pour définir un objet client sys. Component .Registers a server control that implements the IScriptControl interface that is used to define a Sys.Component client object. Le ScriptManager contrôle restitue le script qui prend en charge l’objet client.The ScriptManager control renders script that supports the client object.
RegisterExtenderControl Inscrit un contrôle serveur qui implémente l' IExtenderControl interface utilisée pour définir un objet client sys. Component .Registers a server control that implements the IExtenderControl interface that is used to define a Sys.Component client object. Le ScriptManager contrôle restitue le script qui prend en charge l’objet client.The ScriptManager control renders script that supports the client object.

Inscription de Partial-Page mettre à jour des scripts compatiblesRegistering Partial-Page Update Compatible Scripts

Vous pouvez utiliser les méthodes suivantes pour enregistrer des fichiers de script qui ne dépendent pas de Microsoft AJAX Library, mais qui sont compatibles avec les UpdatePanel contrôles.You can use the following methods to register script files that are not dependent on the Microsoft Ajax Library but that are compatible with UpdatePanel controls. Ces méthodes correspondent à des méthodes similaires du ClientScriptManager contrôle.These methods correspond to similar methods of the ClientScriptManager control. Si vous effectuez un rendu de script pour une utilisation à l’intérieur d’un UpdatePanel contrôle, veillez à appeler les méthodes du ScriptManager contrôle.If you are rendering script for use inside an UpdatePanel control, make sure that you call the methods of the ScriptManager control.

MéthodeMethod DéfinitionDefinition
RegisterArrayDeclaration Ajoute une valeur à un tableau JavaScript.Adds a value to a JavaScript array. Si le tableau n’existe pas, il est créé.If the array does not exist, it is created.
RegisterClientScriptBlock Restitue un script élément après la balise d’ouverture de la page <form> .Renders a script element after the page's opening <form> tag. Le script est spécifié en tant que paramètre de chaîne.The script is specified as a string parameter.
RegisterClientScriptInclude Restitue un script élément après la balise d’ouverture de la page <form> .Renders a script element after the page's opening <form> tag. Le contenu du script est spécifié en affectant src à l’attribut une URL qui pointe vers un fichier de script.The script content is specified by setting the src attribute to a URL that points to a script file.
RegisterClientScriptResource Restitue un script élément après la balise d’ouverture de la page <form> .Renders a script element after the page's opening <form> tag. Le contenu du script est spécifié avec un nom de ressource dans un assembly.The script content is specified with a resource name in an assembly. L' src attribut est automatiquement rempli avec une URL par un appel à un gestionnaire HTTP qui récupère le script nommé à partir de l’assembly.The src attribute is automatically populated with a URL by a call to an HTTP handler that retrieves the named script from the assembly.
RegisterExpandoAttribute Génère le rendu d’une paire d’attributs nom/valeur personnalisée (Un expando) dans le balisage pour un contrôle spécifié.Renders a custom name/value attribute pair (an expando) in the markup for a specified control.
RegisterHiddenField Génère le rendu d’un champ masqué.Renders a hidden field.
RegisterOnSubmitStatement Inscrit un script qui est exécuté en réponse à l' form événement de l’élément submit .Registers a script that is executed in response to the form element's submit event. L' onSubmit attribut fait référence au script spécifié.The onSubmit attribute references the specified script.
RegisterStartupScript Génère le rendu d’un bloc de script de démarrage juste avant la balise de fermeture de la page </form> .Renders a startup script block just before the page's closing </form> tag. Le script à restituer est spécifié en tant que paramètre de chaîne.The script to render is specified as a string parameter.

Lorsque vous inscrivez des méthodes, vous spécifiez une paire type/clé pour ce script.When you register methods, you specify a type/key pair for that script. Si un script avec le même couple type/clé est déjà inscrit, un nouveau script n’est pas inscrit.If a script with the same type/key pair is already registered, a new script is not registered. De même, si vous inscrivez un script avec une paire type/nom de ressource qui existe déjà, l' script élément qui référence la ressource n’est plus ajouté.Similarly, if you register a script with a type/resource name pair that already exists, the script element that references the resource is not added again. Lorsque vous inscrivez un attribut expando d’un attribut précédemment inscrit, une exception est levée.When you register an expando attribute of a previously registered attribute, an exception is thrown. L’enregistrement en double des valeurs de tableau est autorisé.Duplicate registration of array values is allowed.

Quand vous appelez la RegisterClientScriptInclude méthode ou RegisterClientScriptResource , évitez d’inscrire un script qui exécute des fonctions inline.When you call the RegisterClientScriptInclude or the RegisterClientScriptResource method, avoid registering script that executes inline functions. Au lieu de cela, enregistrez le script qui contient des définitions de fonctions telles que des gestionnaires d’événements ou des définitions de classes personnalisées pour votre application.Instead, register script that contains function definitions like event handlers or custom class definitions for your application.

Méthodes d’inscription pour les contrôles UpdatePanelRegistration Methods for UpdatePanel Controls

Vous pouvez utiliser les méthodes suivantes pour personnaliser les mises à jour de pages partielles lorsque vous utilisez des UpdatePanel contrôles.You can use the following methods to customize partial-page updates when you use UpdatePanel controls.

MéthodeMethod DéfinitionDefinition
RegisterAsyncPostBackControl Inscrit un contrôle comme déclencheur pour les publications (postback) asynchrones.Registers a control as a trigger for asynchronous postbacks.
RegisterDataItem Envoie des données personnalisées aux contrôles pendant le rendu de page partiel.Sends custom data to controls during partial-page rendering.
RegisterDispose Inscrit un script dispose pour un contrôle situé à l’intérieur d’un UpdatePanel contrôle.Registers a dispose script for a control that is inside an UpdatePanel control. Le script est exécuté quand le contrôle UpdatePanel est mis à jour ou supprimé.The script is executed when the UpdatePanel control is updated or deleted. La méthode dispose est utilisée pour les composants clients qui font partie de Microsoft AJAX Library et qui doivent libérer des ressources lorsqu’un composant n’est plus utilisé.The dispose method is used for client components that are part of the Microsoft Ajax Library and that have to free resources when a component is no longer used.
RegisterPostBackControl Inscrit un contrôle comme déclencheur pour une publication (postback) complète.Registers a control as a trigger for a full postback. Cette méthode est utilisée pour les contrôles à l’intérieur d’un UpdatePanel contrôle qui, sinon, effectuent des publications asynchrones.This method is used for controls inside an UpdatePanel control that would otherwise perform asynchronous postbacks.

Références du service WebWeb Service References

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.You can register a Web service to be called from client script by creating a ServiceReference object and adding it to the Services collection of the ScriptManager control. ASP.NET génère un objet proxy client pour chaque ServiceReference objet de la Services collection.ASP.NET generates a client proxy object for each ServiceReference object in the Services collection. Vous pouvez ajouter par programmation ServiceReference des objets à la Services collection pour inscrire des services Web au moment de l’exécution.You can programmatically add ServiceReference objects to the Services collection to register Web services at run time.

Pour plus d’informations sur l’accès aux services Web dans le script, consultez exposition de services Web à un script client dans ASP.NET AJAX et appel de services Web à partir d’un script client dans ASP.NET AJAX.For more information about how to access Web services in script, see Exposing Web Services to Client Script in ASP.NET AJAX and Calling Web Services from Client Script in ASP.NET AJAX.

LocalisationLocalization

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.The ScriptManager control generates references in the rendered page that point to the appropriate localized script files, which are either script files embedded in assemblies or stand-alone script files.

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.When the EnableScriptLocalization property is set to true, the ScriptManager control retrieves localized resources (such as localized strings) for the current culture, if they exist. Le ScriptManager contrôle fournit les fonctionnalités suivantes pour l’utilisation de ressources localisées :The ScriptManager control provides the following functionality for using localized resources:

  • Fichiers de script incorporés dans un assembly.Script files that are embedded in an assembly. Le ScriptManager contrôle détermine le fichier de script spécifique à la culture ou à la culture de secours à envoyer au navigateur.The ScriptManager control determines which culture-specific or fallback-culture script file to send to the browser. Pour ce faire, il utilise l' NeutralResourcesLanguageAttribute attribut d’assembly spécifique à la culture, les ressources empaquetées avec l’assembly et la culture d’interface utilisateur du navigateur (le cas échéant).It does this by using the culture-specific NeutralResourcesLanguageAttribute assembly attribute, the resources packaged with the assembly, and the UI culture of the browser (if any).

  • Fichiers de script autonomes.Stand-alone script files. Le ScriptManager contrôle définit la liste des cultures d’interface utilisateur prises en charge à l’aide ResourceUICultures de la propriété de l' ScriptReference objet.The ScriptManager control defines the list of UI cultures that are supported by using the ResourceUICultures property of the ScriptReference object.

  • En mode débogage.In debug mode. Le ScriptManager contrôle tente de restituer un fichier de script spécifique à la culture qui contient des informations de débogage.The ScriptManager control tries to render a culture-specific script file that contains debug information. 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 avec un nom tel que scriptname.en-MX.debug.js, si le fichier existe.For example, if the page is in debug mode and the current culture is set to en-MX, the control renders a script file that has a name such as scriptname.en-MX.debug.js, if the file exists. Si le fichier n’existe pas, le fichier de débogage pour la culture de secours appropriée est restituéIf the file does not exist, the debug file for the appropriate fallback culture is rendered

Pour plus d’informations sur la localisation des ressources, voir vue d’ensemble de la localisation des ressources pour les bibliothèques de composants.For more information about how to localize resources, see Localizing Resources for Component Libraries Overview.

Gestion des erreursError Handling

Lorsqu’une erreur de page se produit pendant des publications (postback) asynchrones, l' AsyncPostBackError événement est déclenché.When a page error occurs during asynchronous postbacks, the AsyncPostBackError event is raised. 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.The way in which errors on the server are sent to the client depends on the AllowCustomErrorsRedirect property, the AsyncPostBackErrorMessage property, and the custom errors section of the Web.config file. Pour plus d’informations, consultez Personnalisation de la gestion des erreurs pour les contrôles UpdatePanel.For more information, see Customizing Error Handling for UpdatePanel Controls.

Syntaxe déclarativeDeclarative Syntax

<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.Initializes a new instance of the ScriptManager class.

Propriétés

Adapter

Obtient l'adaptateur spécifique au navigateur pour le contrôle.Gets the browser-specific adapter for the control.

(Hérité de Control)
AjaxFrameworkAssembly

Obtient l'assembly Framework Ajax utilisé par les composants sur la page.Gets the Ajax framework assembly that components on the page use.

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.Gets or sets a value that specifies how client scripts of the Microsoft Ajax client library will be included on the 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.Gets or sets a value that determines whether the custom errors section of the Web.config file is used during an error in an asynchronous postback.

AppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(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.Gets or sets the error message that is sent to the client when an unhandled server exception occurs during an asynchronous postback.

AsyncPostBackSourceElementID

Obtient l'ID unique du contrôle qui a provoqué la publication (postback) asynchrone.Gets the unique ID of the control that caused the asynchronous postback.

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.Gets or sets a value that indicates the time, in seconds, before asynchronous postbacks time out if no response is received.

AuthenticationService

Obtient l'objet AuthenticationServiceManager associé à l'instance ScriptManager actuelle.Gets the AuthenticationServiceManager object that is associated with the current ScriptManager instance.

BindingContainer

Obtient le contrôle qui contient la liaison de données de ce contrôle.Gets the control that contains this control's data binding.

(Hérité de Control)
ChildControlsCreated

Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés.Gets a value that indicates whether the server control's child controls have been created.

(Hérité de Control)
ClientID

Obtient l’ID de contrôle du balisage HTML généré par ASP.NET.Gets the control ID for HTML markup that is generated by 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.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(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.Gets a character value representing the separator character used in the ClientID property.

(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.Gets or sets the name of the method that handles the Sys.Application.navigate event on the client.

CompositeScript

Obtient une référence au script composite qui prend en charge la page web.Gets a reference to the composite script that supports the Web page.

Context

Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours.Gets the HttpContext object associated with the server control for the current Web request.

(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.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Hérité de Control)
DataItemContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Hérité de Control)
DataKeysContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Hérité de Control)
DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.Gets a value indicating whether a control is being used on a design surface.

(Hérité de Control)
EmptyPageUrl

Obtient ou définit une URL vers une page web vierge.Gets or sets a URL to a blank Web page.

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).Determines whether the current page loads client script references from CDN (Content Delivery Network) paths.

EnableCdnFallback

Permet la copie locale d'un script dans le cas où le CDN (Content Delivery Network) n'est pas disponible.Enables local copy of a script to load in the event that the CDN (Content Delivery Network) is unavailable.

EnableHistory

Obtient ou définit une valeur qui indique si la page web prend en charge la gestion des points d'historique.Gets or sets a value that indicates whether the Web page supports history point management.

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.Gets or sets a value that indicates whether public static page methods in an ASP.NET page can be called from client script.

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.Gets or sets a value that enables partial rendering of a page, which in turn enables you to update regions of the page individually by using UpdatePanel controls.

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.Gets or sets a value that indicates whether the ScriptManager control renders script that supports parsing and formatting of culture-specific information.

EnableScriptLocalization

Obtient ou définit une valeur qui indique si le contrôle ScriptManager restitue des versions localisées des fichiers de script.Gets or sets a value that indicates whether the ScriptManager control renders localized versions of script files.

EnableSecureHistoryState

Obtient ou définit une valeur qui indique s'il faut chiffrer la chaîne d'état de l'historique.Gets or sets a value that indicates whether to encrypt the history state string.

EnableTheming

Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle.Gets or sets a value indicating whether themes apply to this control.

(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.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Hérité de Control)
Events

Obtient la liste des délégués de gestionnaires d'événements pour le contrôle.Gets a list of event handler delegates for the control. Cette propriété est en lecture seule.This property is read-only.

(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.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Hérité de Control)
ID

Obtient ou définit l'ID programmatique assigné au contrôle serveur.Gets or sets the programmatic identifier assigned to the server control.

(Hérité de Control)
IdSeparator

Obtient le caractère utilisé pour séparer des identificateurs de contrôle.Gets the character used to separate control identifiers.

(Hérité de Control)
IsChildControlStateCleared

Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle.Gets a value indicating whether controls contained within this control have control state.

(Hérité de Control)
IsDebuggingEnabled

Obtient une valeur qui indique si les versions debug de bibliothèques de scripts clients seront restituées.Gets a value that indicates whether the debug versions of client script libraries will be rendered.

IsInAsyncPostBack

Obtient une valeur qui indique si la publication (postback) actuelle est exécutée en mode de rendu partiel.Gets a value that indicates whether the current postback is being executed in partial-rendering mode.

IsNavigating

Obtient une valeur qui indique si un événement Navigate est actuellement géré.Gets a value that indicates whether a Navigate event is currently being handled.

IsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage.Gets a value that indicates whether the server control is saving changes to its view state.

(Hérité de Control)
IsViewStateEnabled

Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle.Gets a value indicating whether view state is enabled for this control.

(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.Gets or sets a value that indicates whether scripts are loaded before or after markup for the page UI is loaded.

LoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index.Gets a value indicating whether the control participates in loading its view state by ID instead of 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.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Hérité de Control)
Page

Obtient une référence à l'instance de Page qui contient le contrôle serveur.Gets a reference to the Page instance that contains the server control.

(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.Gets a reference to the server control's parent control in the page control hierarchy.

(Hérité de Control)
ProfileService

Obtient l'objet ProfileServiceManager associé à l'instance ScriptManager actuelle.Gets the ProfileServiceManager object that is associated with the current ScriptManager instance.

RenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Hérité de Control)
RoleService

Obtient l'objet RoleServiceManager associé à l'instance ScriptManager actuelle.Gets the RoleServiceManager object that is associated with the current ScriptManager instance.

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.Gets or sets a value that specifies whether debug or release versions of client script libraries are rendered.

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.Gets or sets the root path of the location that is used to build the paths to ASP.NET Ajax and custom script files.

ScriptResourceMapping

Obtient un objet ScriptResourceMapping.Gets a ScriptResourceMapping object.

Scripts

Obtient un objet ScriptReferenceCollection qui contient les objets ScriptReference, chacun représentant un fichier de script restitué au client.Gets a ScriptReferenceCollection object that contains the ScriptReference objects, each of which represents a script file rendered to the 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.Gets a ServiceReferenceCollection object that contains a ServiceReference object for each Web service that ASP.NET exposes on the client for Ajax functionality.

Site

Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception.Gets information about the container that hosts the current control when rendered on a design surface.

(Hérité de Control)
SkinID

Obtient ou définit l’apparence à appliquer au contrôle.Gets or sets the skin to apply to the control.

(Hérité de Control)
SupportsPartialRendering

Obtient une valeur qui indique si le client prend en charge le rendu de page partiel.Gets a value that indicates whether the client supports partial-page rendering.

TemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.Gets or sets a reference to the template that contains this control.

(Hérité de Control)
TemplateSourceDirectory

Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Hérité de Control)
UniqueID

Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur.Gets the unique, hierarchically qualified identifier for the server control.

(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.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(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.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Hérité de Control)
ViewStateIgnoresCase

Obtient une valeur qui indique si l'objet StateBag respecte la casse.Gets a value that indicates whether the StateBag object is case-insensitive.

(Hérité de Control)
ViewStateMode

Obtient ou définit le mode d'état d'affichage de ce contrôle.Gets or sets the view-state mode of this control.

(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.Overrides the Visible property that is inherited from the base Control class to prevent setting this value.

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.Called after a child control is added to the Controls collection of the Control object.

(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.Creates a history point and adds it to the browser's history stack, using the specified state data collection and state title.

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.Creates a history point and adds it to the browser's history stack, using the specified state key and state value.

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.Creates a history point and adds it to the browser's history stack, using the specified state key, state value, and state title.

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.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(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.Applies the style properties defined in the page style sheet to the control.

(Hérité de Control)
BeginRenderTracing(TextWriter, Object)

Commence le traçage au moment du design des données de rendu.Begins design-time tracing of rendering data.

(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.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Hérité de Control)
ClearCachedClientID()

Affecte à la valeur ClientID mise en cache la valeur null.Sets the cached ClientID value to null.

(Hérité de Control)
ClearChildControlState()

Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur.Deletes the control-state information for the server control's child controls.

(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.Deletes the view-state and control-state information for all the server control's child controls.

(Hérité de Control)
ClearChildViewState()

Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur.Deletes the view-state information for all the server control's child controls.

(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.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(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.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Hérité de Control)
CreateControlCollection()

Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Hérité de Control)
DataBind()

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.Binds a data source to the invoked server control and all its child controls.

(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.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Hérité de Control)
DataBindChildren()

Lie une source de données aux contrôles enfants du contrôle serveur.Binds a data source to the server control's child controls.

(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.Enables a server control to perform final clean up before it is released from memory.

(Hérité de Control)
EndRenderTracing(TextWriter, Object)

Met fin au traçage au moment du design des données de rendu.Ends design-time tracing of rendering data.

(Hérité de Control)
EnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants.Determines whether the server control contains child controls. S'il ne contient pas de contrôles enfants, il en crée.If it does not, it creates child controls.

(Hérité de Control)
EnsureID()

Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné.Creates an identifier for controls that do not have an identifier assigned.

(Hérité de Control)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(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.Searches the current naming container for a server control with the specified id parameter.

(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.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Vous ne devez pas substituer cette version de la méthode FindControl.You should not override this version of the FindControl method.

(Hérité de Control)
Focus()

Affecte le focus d'entrée à un contrôle.Sets input focus to a control.

(Hérité de Control)
GetCurrent(Page)

Obtient l'instance ScriptManager pour un objet Page donné.Gets the ScriptManager instance for a given Page object.

GetDesignModeState()

Obtient les données au moment du design pour un contrôle.Gets design-time data for a control.

(Hérité de Control)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(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.Retrieves a read-only collection of ECMAScript (JavaScript) array declarations that were previously registered with the Page object.

GetRegisteredClientScriptBlocks()

Récupère une collection en lecture seule de blocs de script client précédemment inscrits avec le contrôle ScriptManager.Retrieves a read-only collection of client script blocks that were previously registered with the ScriptManager control.

GetRegisteredDisposeScripts()

Récupère une collection en lecture seule de scripts dispose précédemment inscrits avec l’objet Page.Retrieves a read-only collection of dispose scripts that were previously registered with the Page object.

GetRegisteredExpandoAttributes()

Récupère une collection en lecture seule d’attributs personnalisés (expando) précédemment inscrits avec l’objet Page.Retrieves a read-only collection of custom (expando) attributes that were previously registered with the Page object.

GetRegisteredHiddenFields()

Récupère une collection en lecture seule de champs masqués précédemment inscrits avec l’objet Page.Retrieves a read-only collection of hidden fields that were previously registered with the Page object.

GetRegisteredOnSubmitStatements()

Récupère une collection en lecture seule d’instructions onsubmit précédemment inscrites avec l’objet Page.Retrieves a read-only collection of onsubmit statements that were previously registered with the Page object.

GetRegisteredStartupScripts()

Récupère une collection en lecture seule de scripts de démarrage précédemment inscrits avec l’objet Page.Retrieves a read-only collection of startup scripts that were previously registered with the Page object.

GetRouteUrl(Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.Gets the URL that corresponds to a set of route parameters.

(Hérité de Control)
GetRouteUrl(RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.Gets the URL that corresponds to a set of route parameters.

(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.Gets the URL that corresponds to a set of route parameters and a route name.

(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.Gets the URL that corresponds to a set of route parameters and a route name.

(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.Retrieves a string that contains key/value pairs that represent the state of the Web page.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
GetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié.Returns the prefixed portion of the UniqueID property of the specified control.

(Hérité de Control)
HasControls()

Détermine si le contrôle serveur contient des contrôles enfants.Determines if the server control contains any child controls.

(Hérité de Control)
HasEvents()

Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants.Returns a value indicating whether events are registered for the control or any child controls.

(Hérité de Control)
IsLiteralContent()

Détermine si le contrôle serveur ne détient qu'un contenu littéral.Determines if the server control holds only literal content.

(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().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(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.Reads form data that is posted from the browser to the server, and determines the source of the asynchronous postback.

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().Restores view-state information from a previous page request that was saved by the SaveViewState() method.

(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.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Hérité de Control)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)

Déclenche l’événement AsyncPostBackError.Raises the AsyncPostBackError event.

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.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Hérité de Control)
OnDataBinding(EventArgs)

Déclenche l’événement DataBinding.Raises the DataBinding event.

(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.Raises the Init event and makes sure that only one ScriptManager control exists on the page.

OnLoad(EventArgs)

Déclenche l’événement Load.Raises the Load event.

(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.Raises the PreRender event, and registers script files and services for partial-page updates.

OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)

Déclenche l’événement ResolveCompositeScriptReference.Raises the ResolveCompositeScriptReference event.

OnResolveScriptReference(ScriptReferenceEventArgs)

Déclenche l'événement ResolveScriptReference pour chaque référence de script gérée par le contrôle ScriptManager.Raises the ResolveScriptReference event for each script reference that is managed by the ScriptManager control.

OnUnload(EventArgs)

Déclenche l’événement Unload.Raises the Unload event.

(Hérité de Control)
OpenFile(String)

Obtient un Stream utilisé pour lire un fichier.Gets a Stream used to read a file.

(Hérité de Control)
RaiseBubbleEvent(Object, EventArgs)

Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle.Assigns any sources of the event and its information to the control's parent.

(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.Processes a postback event raised by the ScriptManager control and loads the history state of the Web page.

RaisePostDataChangedEvent()

Déclenche des événements pour le contrôle ScriptManager pendant la publication sur le serveur.Raises events for the ScriptManager control when it posts back to the server.

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.Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the 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.Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the page.

RegisterAsyncPostBackControl(Control)

Inscrit un contrôle comme déclencheur pour les publications (postback) asynchrones.Registers a control as a trigger for asynchronous postbacks.

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.Registers a client script block with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds the script block to the 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.Registers a client script block with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds the script block to the 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.Registers a client script file with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds a script file reference to the 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.Registers client script with the ScriptManager control every time that an asynchronous postback occurs, and then adds a script file reference to the 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.Registers the client script that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

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.Registers a client script file that is embedded in an assembly with the ScriptManager control every time that a postback occurs.

RegisterDataItem(Control, String)

Envoie des données personnalisées à un contrôle pendant le rendu de page partiel.Sends custom data to a control during partial-page rendering.

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).Sends custom data to a control during partial-page rendering, and indicates whether the data is in JavaScript Object Notation (JSON) format.

RegisterDispose(Control, String)

Inscrit un script dispose pour un contrôle situé à l'intérieur d'un contrôle UpdatePanel.Registers a dispose script for a control that is inside an UpdatePanel control. Le script est exécuté quand le contrôle UpdatePanel est mis à jour ou supprimé.The script is executed when the UpdatePanel control is updated or deleted.

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é.Registers a name/value pair with the ScriptManager control as a custom (expando) attribute of a specified control.

RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)

Inscrit un contrôle d'extendeur avec l'instance ScriptManager actuelle.Registers an extender control with the current ScriptManager instance.

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.Registers a hidden field with the ScriptManager control for a control that is inside an UpdatePanel control.

RegisterHiddenField(Page, String, String)

Inscrit un champ masqué avec le contrôle ScriptManager pendant chaque publication (postback) asynchrone.Registers a hidden field with the ScriptManager control during every asynchronous postback.

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.Registers client script by resource name that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

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.Registers client script by resource name that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

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é.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

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é.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

RegisterPostBackControl(Control)

Inscrit un contrôle comme déclencheur pour une publication (postback).Registers a control as a trigger for a 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.This method is used to configure postback controls inside an UpdatePanel control that would otherwise perform asynchronous postbacks.

RegisterScriptControl<TScriptControl>(TScriptControl)

Inscrit un contrôle de script avec l'instance ScriptManager actuelle.Registers a script control with the current ScriptManager instance.

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.Calls back to an ExtenderControl class to return instance scripts that must be rendered to support the client object that represents a client control, component, or behavior.

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.Calls a ScriptControl class to return instance scripts that must be rendered to support the client object that represents a client control, component, or behavior.

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.Registers a startup script block for a control that is inside an UpdatePanel by using the ScriptManager control, and adds the script block to the 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.Registers a startup script block for every asynchronous postback with the ScriptManager control and adds the script block to the page.

RemovedControl(Control)

Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control.Called after a child control is removed from the Controls collection of the Control object.

(Hérité de Control)
Render(HtmlTextWriter)

Restitue le contenu du contrôle ScriptManager dans le navigateur à l'aide de l'objet HtmlTextWriter spécifié.Renders the ScriptManager control's content to the browser by using the specified HtmlTextWriter object.

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.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the 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é.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(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.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Hérité de Control)
ResolveAdapter()

Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié.Gets the control adapter responsible for rendering the specified control.

(Hérité de Control)
ResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.Gets a URL that can be used by the browser.

(Hérité de Control)
ResolveUrl(String)

Convertit une URL en une URL que le client soit en mesure d'utiliser.Converts a URL into one that is usable on the requesting client.

(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.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(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.Saves any server control view-state changes that have occurred since the time the page was posted back to the server.

(Hérité de Control)
SetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.Sets design-time data for a control.

(Hérité de Control)
SetFocus(Control)

Affecte au focus du navigateur le contrôle spécifié.Sets the browser focus to the specified control.

SetFocus(String)

Affecte au focus du navigateur le contrôle spécifié par ID.Sets the browser focus to the control specified by 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.Assigns an event handler delegate to render the server control and its content into its parent control.

(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.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(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.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Hérité de Control)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(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.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. Cet objet est accessible via la propriété ViewState.This object is accessible through the ViewState property.

(Hérité de Control)

Événements

AsyncPostBackError

Se produit en cas d'erreur de page pendant une publication (postback) asynchrone.Occurs when there is a page error during an asynchronous postback.

DataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.Occurs when the server control binds to a data source.

(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.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(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.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Hérité de Control)
Load

Se produit lorsque le contrôle serveur est chargé dans l'objet Page.Occurs when the server control is loaded into the Page object.

(Hérité de Control)
Navigate

Se produit quand l’utilisateur clique sur le bouton Précédent ou Suivant du navigateur.Occurs when the user clicks the browser's Back or Forward button.

PreRender

Se produit après le chargement de l'objet Control mais avant le rendu.Occurs after the Control object is loaded but prior to rendering.

(Hérité de Control)
ResolveCompositeScriptReference

Se produit quand un script composite est inscrit auprès du contrôle ScriptManager.Occurs when a composite script is registered with the ScriptManager control.

ResolveScriptReference

Se produit quand un membre de la collection Scripts est inscrit avec le contrôle ScriptManager.Occurs when a member of the Scripts collection is registered with the ScriptManager control.

Unload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.Occurs when the server control is unloaded from memory.

(Hérité de Control)

Implémentations d’interfaces explicites

IControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez ControlBuilder.For a description of this member, see ControlBuilder.

(Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez GetDesignModeState().For a description of this member, see GetDesignModeState().

(Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Pour obtenir une description de ce membre, consultez SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Hérité de Control)
IControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez UserData.For a description of this member, see UserData.

(Hérité de Control)
IDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez DataBindings.For a description of this member, see DataBindings.

(Hérité de Control)
IDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez HasDataBindings.For a description of this member, see HasDataBindings.

(Hérité de Control)
IExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez Expressions.For a description of this member, see Expressions.

(Hérité de Control)
IExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez HasExpressions.For a description of this member, see HasExpressions.

(Hérité de Control)
IParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Hérité de Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Pour obtenir une description de ce membre, consultez LoadPostData(String, NameValueCollection).For a description of this member, see LoadPostData(String, NameValueCollection).

IPostBackDataHandler.RaisePostDataChangedEvent()

Pour obtenir une description de ce membre, consultez RaisePostDataChangedEvent().For a description of this member, see 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.Enables the ScriptManager control to process a postback event and load the history state of the Web page.

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é.Returns the data source that is associated with the data control for the specified control.

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é.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Retourne l'objet Metatable pour le contrôle de données conteneur.Returns the metatable object for the containing data control.

S’applique à

Voir aussi