Substitution.MethodName Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit le nom de la méthode de rappel à appeler lorsque le contrôle Substitution s'exécute.

public:
 virtual property System::String ^ MethodName { System::String ^ get(); void set(System::String ^ value); };

public virtual string MethodName { get; set; }

member this.MethodName : string with get, set

Public Overridable Property MethodName As String

Valeur de propriété

String

Chaîne qui représente le nom de la méthode à appeler lorsque le contrôle Substitution s'exécute.

Exemples

L’exemple de code suivant montre comment ajouter un Substitution contrôle de manière déclarative à une page Web mise en cache en sortie. Lorsque la page se charge, une liste statique à puces s’affiche à l’utilisateur. Cette section de la page est mise en cache et mise à jour uniquement toutes les 60 secondes. Lorsque le Substitution contrôle s’exécute, il appelle la GetUser méthode , qui retourne une chaîne qui représente l’utilisateur actuel. Cette chaîne est affichée à l’emplacement du Substitution contrôle sur la page. Cette section de la page n’est pas mise en cache et est mise à jour chaque fois que la page est actualisée.

<%@ outputcache duration="60" varybyparam="none" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" language="C#">  
  
  // The Substitution control calls this method to retrieve
  // the name of the current user from the HttpContext object. 
  // This section of the page is exempt from output caching. 
  public static string GetUser(HttpContext context)
  {
    return context.User.Identity.Name;
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>Substitution.MethodName Property Example</title>
</head>
<body>
  <form id="Form1" runat="server">
  
    <h3>Substitution.MethodName Property Example</h3>  
    
    <!--This section of the page is not cached.-->
    Welcome to the site,
    <asp:substitution id="Substitution1"
      methodname="GetUser"
      runat="Server">
    </asp:substitution>
    
    <br /><br />
    
    <!--This section of the page is cached.-->
    Product list:
    <asp:bulletedlist id="ItemsBulletedList"             
      displaymode="Text" 
      runat="server">    
        <asp:ListItem>Product 1</asp:ListItem>
        <asp:ListItem>Product 2</asp:ListItem>
        <asp:ListItem>Product 3</asp:ListItem>
    </asp:bulletedlist>        

  </form>
</body>
</html>

<%@ outputcache duration="60" varybyparam="none" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" language="VB">  
  
  ' The Substitution control calls this method to retrieve
  ' the name of the current user from the HttpContext object. 
  ' This section of the page is exempt from output caching. 
  Shared Function GetUser(ByVal context As HttpContext) As String
    Return context.User.Identity.Name
  End Function
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>Substitution.MethodName Property Example</title>
</head>
<body>
  <form id="Form1" runat="server">
  
    <h3>Substitution.MethodName Property Example</h3>  
    
    <!--This section of the page is not cached.-->
    Welcome to the site,
    <asp:substitution id="Substitution1"
      methodname="GetUser"
      runat="Server">
    </asp:substitution>
    
    <br /><br />
    
    <!--This section of the page is cached.-->
    Product list:
    <asp:bulletedlist id="ItemsBulletedList"             
      displaymode="Text" 
      runat="server">    
        <asp:ListItem>Product 1</asp:ListItem>
        <asp:ListItem>Product 2</asp:ListItem>
        <asp:ListItem>Product 3</asp:ListItem>
    </asp:bulletedlist>        

  </form>
</body>
</html>

Remarques

Utilisez la MethodName propriété pour spécifier le nom de la méthode de rappel à appeler lorsque le contrôle s’exécute Substitution . La méthode de rappel que vous spécifiez doit être une méthode statique sur la page ou le contrôle utilisateur qui contient le Substitution contrôle. La signature de la méthode de rappel doit correspondre à la signature d’un HttpResponseSubstitutionCallback délégué qui prend un HttpContext paramètre et retourne une chaîne. La chaîne retournée par la méthode de rappel est le contenu à afficher sur la page à l’emplacement du Substitution contrôle.

Le HttpContext paramètre encapsule toutes les informations spécifiques à HTTP sur une requête HTTP individuelle. Vous pouvez l’utiliser pour accéder aux variables de session, aux informations d’autorisation et aux détails de personnalisation. Pour plus d'informations, consultez HttpResponseSubstitutionCallback.

S’applique à

Partager via