HttpResponseSubstitutionCallback HttpResponseSubstitutionCallback HttpResponseSubstitutionCallback HttpResponseSubstitutionCallback Delegate

Definition

Stellt die Methode für das Behandeln von Ersetzungen nach dem Zwischenspeichern dar.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 

Parameter

context
HttpContext HttpContext HttpContext HttpContext

Der HttpContext, der die HTTP-Anforderungsinformation für die Seite mit dem Steuerelement enthält, für das eine Ersetzung nach dem Zwischenspeichern erforderlich ist.The HttpContext that contains the HTTP request information for the page with the control that requires post-cache substitution.

Rückgabewert

System.String

Der vor dem Senden an den Client in die zwischengespeicherte Antwort eingefügte Inhalt.The content inserted into the cached response before being sent to the client.

Vererbung
HttpResponseSubstitutionCallbackHttpResponseSubstitutionCallbackHttpResponseSubstitutionCallbackHttpResponseSubstitutionCallback

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie Substitution ein-Steuerelement Programm gesteuert zu einer Ausgabe zwischengespeicherten Webseite hinzufügen können.The following code example demonstrates how to add a Substitution control programmatically to an output-cached Web page. Wenn die Seite geladen wird, werden dem Benutzer das aktuelle Datum und die aktuelle Uhrzeit in einer Bezeichnung angezeigt.When the page loads, the current date and time are displayed to the user in a label. Dieser Abschnitt der Seite wird alle 60 Sekunden zwischengespeichert und aktualisiert.This section of the page is cached and updated every 60 seconds. Wenn das Substitution -Steuerelement ausgeführt wird, GetCurrentDateTime wird die-Methode aufgerufen, die der Signatur HttpResponseSubstitutionCallback für den Delegaten entsprechen muss.When the Substitution control executes, it calls the GetCurrentDateTime method, which must match the signature for the HttpResponseSubstitutionCallback delegate. Die Zeichenfolge, die von der GetCurrentDateTime -Methode zurückgegeben wird, wird dem Benutzer angezeigt.The string that is returned by the GetCurrentDateTime method is displayed to the user. Dieser Abschnitt der Seite wird nicht zwischengespeichert und jedes Mal aktualisiert, wenn die Seite aktualisiert wird.This section of the page is not cached and is updated each time the page is refreshed. Die MethodName -Eigenschaft Substitution des-Steuer Elements Ruft den Namen der Rückruf Methode ab oder legt ihn fest.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>

Hinweise

Der HttpResponseSubstitutionCallback -Delegat wird in Verbindung WriteSubstitution mit der-Methode zum Rendern von nach Cache Inhalten für Substitution die AdRotator -und-Steuerelemente verwendet.The HttpResponseSubstitutionCallback delegate, in combination with the WriteSubstitution method, is used for rendering post-cache content for the Substitution and AdRotator controls.

Verwenden Sie Substitution für das-Steuer MethodName Element die-Eigenschaft, um den Namen der Rückruf Methode anzugeben, Substitution die bei der Ausführung des Steuer Elements aufgerufen werden soll.For the Substitution control, use the MethodName property to specify the name of the callback method to invoke when the Substitution control executes. Die von Ihnen angegebene Rückruf Methode muss eine statische Methode auf der Seite oder im Benutzer Steuerelement sein, das das Substitution Steuerelement enthält.The callback method that you specify must be a static method on the page or on the user control that contains the Substitution control. Die Signatur für die Rückruf Methode muss mit der Signatur für einen HttpResponseSubstitutionCallback Delegaten, der HttpContext einen-Parameter annimmt und eine Zeichenfolge zurückgibt, identisch sein.The signature for the callback method must match the signature for an HttpResponseSubstitutionCallback delegate that takes an HttpContext parameter and returns a string.

Für das AdRotator -Steuerelement ist das Rendering unabhängig vom seitencaching, es sei denn, es wird AdCreated ein Ereignishandler für das-Ereignis bereitgestellt.For the AdRotator control, rendering is independent of the page caching unless an event handler is provided for the AdCreated event. Wenn kein AdCreated Ereignishandler vorhanden ist, wird die Ersetzung nach dem Cache verwendet, um AdRotator den Inhalt zu erzeugen.If no AdCreated event handler is present, post-cache substitution is used to render the AdRotator content.

Erweiterungsmethoden

GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate)

Ruft ein Objekt ab, das die Methode darstellt, die vom angegebenen Delegaten dargestellt wird.Gets an object that represents the method represented by the specified delegate.

Gilt für:

Siehe auch