HttpResponseSubstitutionCallback Délégué

Définition

Représente la méthode qui gère la substitution post-cache.Represents the method that handles post-cache substitution.

public delegate System::String ^ HttpResponseSubstitutionCallback(HttpContext ^ context);
public delegate string HttpResponseSubstitutionCallback(HttpContext context);
type HttpResponseSubstitutionCallback = delegate of HttpContext -> string
Public Delegate Function HttpResponseSubstitutionCallback(context As HttpContext) As String 

Paramètres

context
HttpContext

HttpContext qui contient les informations de demande HTTP pour la page avec le contrôle qui requiert la substitution post-cache.The HttpContext that contains the HTTP request information for the page with the control that requires post-cache substitution.

Valeur renvoyée

String

Contenu inséré dans la réponse mise en cache avant d'être envoyé au client.The content inserted into the cached response before being sent to the client.

Héritage
HttpResponseSubstitutionCallback

Exemples

L’exemple de code suivant montre comment ajouter un Substitution contrôle par programmation à une page Web mise en cache de sortie.The following code example demonstrates how to add a Substitution control programmatically to an output-cached Web page. Lors du chargement de la page, la date et l’heure actuelles sont affichées à l’utilisateur dans une étiquette.When the page loads, the current date and time are displayed to the user in a label. Cette section de la page est mise en cache et mise à jour toutes les 60 secondes.This section of the page is cached and updated every 60 seconds. Lorsque le Substitution contrôle s’exécute, il appelle la GetCurrentDateTime méthode, qui doit HttpResponseSubstitutionCallback correspondre à la signature du délégué.When the Substitution control executes, it calls the GetCurrentDateTime method, which must match the signature for the HttpResponseSubstitutionCallback delegate. La chaîne retournée par la GetCurrentDateTime méthode est présentée à l’utilisateur.The string that is returned by the GetCurrentDateTime method is displayed to the user. Cette section de la page n’est pas mise en cache et est mise à jour chaque fois que la page est actualisée.This section of the page is not cached and is updated each time the page is refreshed. La MethodName propriétéSubstitution du contrôle obtient ou définit le nom de la méthode de rappel.The MethodName property of the Substitution control gets or sets the name of the callback method.

<%@ 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#">  
  
  void Page_Load(object sender, System.EventArgs e)
  {
    // Programmatically create a Substitution control.
    Substitution Substitution1 = new Substitution();
    
    // Specify the callback method.
    Substitution1.MethodName = "GetCurrentDateTime";
    
    // Add the Substitution control to the controls
    // collection of PlaceHolder1.
    PlaceHolder1.Controls.Add (Substitution1);        

    // Display the current date and time in the label.
    // Output caching applies to this section of the page.
    CachedDateLabel.Text = DateTime.Now.ToString();    
  }
  
  // The Substitution control calls this method to retrieve
  // the current date and time. This section of the page
  // is exempt from output caching. 
  public static string GetCurrentDateTime (HttpContext context)
  {
    return DateTime.Now.ToString ();
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>Substitution Class Example</title>
</head>
<body>
  <form id="Form1" runat="server">
  
    <h3>Substitution Constructor Example</h3>  
    
    <p>This section of the page is not cached:</p>
    <asp:placeholder id="PlaceHolder1"
      runat="Server">
    </asp:placeholder>
    
    <br />
    
    <p>This section of the page is cached:</p>
    
    <asp:label id="CachedDateLabel"
      runat="Server">
    </asp:label>
    
    <br /><br />
    
    <asp:button id="RefreshButton"
      text="Refresh Page"
      runat="Server">
    </asp:button>     

  </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">  
  
  Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    ' Programmatically create a Substitution control.
    Dim Substitution1 As New Substitution
    
    ' Specify the callback method.
    Substitution1.MethodName = "GetCurrentDateTime"
    
    ' Add the Substitution control to the controls
    ' collection of PlaceHolder1.
    PlaceHolder1.Controls.Add(Substitution1)
    
    ' Display the current date and time in the label.
    ' Output caching applies to this section of the page.
    CachedDateLabel.Text = DateTime.Now.ToString()
  End Sub
  
  ' The Substitution control calls this method to retrieve
  ' the current date and time. This section of the page
  ' is exempt from output caching. 
  Shared Function GetCurrentDateTime(ByVal context As HttpContext) As String
    Return DateTime.Now.ToString()
  End Function
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>Substitution Constructor Example</title>
</head>
<body>
  <form id="Form1" runat="server">
  
    <h3>Substitution Constructor Example</h3>  
    
    <p>This section of the page is not cached:</p>
    <asp:placeholder id="PlaceHolder1"
      runat="Server">
    </asp:placeholder>
    
    <br />
    
    <p>This section of the page is cached:</p>
    
    <asp:label id="CachedDateLabel"
      runat="Server">
    </asp:label>
    
    <br /><br />
    
    <asp:button id="RefreshButton"
      text="Refresh Page"
      runat="Server">
    </asp:button>     

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

Remarques

Le HttpResponseSubstitutionCallback délégué, en association avec la WriteSubstitution méthode, est utilisé pour le rendu du contenu postérieur au cache Substitution pour AdRotator les contrôles et.The HttpResponseSubstitutionCallback delegate, in combination with the WriteSubstitution method, is used for rendering post-cache content for the Substitution and AdRotator controls.

Pour le Substitution contrôle, utilisez la MethodName propriété pour spécifier le nom de la méthode de rappel à appeler lorsque Substitution le contrôle s’exécute.For the Substitution control, use the MethodName property to specify the name of the callback method to invoke when the Substitution control executes. La méthode de rappel que vous spécifiez doit être une méthode statique sur la page ou sur le contrôle utilisateur qui Substitution contient le contrôle.The callback method that you specify must be a static method on the page or on the user control that contains the Substitution control. La signature de la méthode de rappel doit correspondre à la signature HttpResponseSubstitutionCallback d’un délégué qui HttpContext accepte un paramètre et retourne une chaîne.The signature for the callback method must match the signature for an HttpResponseSubstitutionCallback delegate that takes an HttpContext parameter and returns a string.

Pour le AdRotator contrôle, le rendu est indépendant de la mise en cache de la page, sauf si AdCreated un gestionnaire d’événements est fourni pour l’événement.For the AdRotator control, rendering is independent of the page caching unless an event handler is provided for the AdCreated event. Si aucun AdCreated gestionnaire d’événements n’est présent, la substitution postérieure au cache est utilisée AdRotator pour restituer le contenu.If no AdCreated event handler is present, post-cache substitution is used to render the AdRotator content.

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.Gets an object that represents the method represented by the specified delegate.

S’applique à

Voir aussi