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 Hinzufügen einer Substitution programmgesteuert zu einer Webseite Ausgabecache zwischengespeicherte Steuerelement.The following code example demonstrates how to add a Substitution control programmatically to an output-cached Web page. Wenn die Seite geladen wird, werden das aktuelle Datum und die Uhrzeit für den Benutzer in einer Bezeichnung angezeigt.When the page loads, the current date and time are displayed to the user in a label. In diesem Abschnitt der Seite zwischengespeichert und alle 60 Sekunden aktualisiert.This section of the page is cached and updated every 60 seconds. Wenn die Substitution -Steuerelement ausgeführt wird, ruft es die GetCurrentDateTime -Methode, die die Signatur übereinstimmen muss die HttpResponseSubstitutionCallback delegieren.When the Substitution control executes, it calls the GetCurrentDateTime method, which must match the signature for the HttpResponseSubstitutionCallback delegate. Die Zeichenfolge, die von zurückgegeben wird das GetCurrentDateTime Methode, die dem Benutzer angezeigt wird.The string that is returned by the GetCurrentDateTime method is displayed to the user. In diesem Abschnitt der Seite wird nicht zwischengespeichert, und es wird jedes Mal aktualisiert, die die Seite aktualisiert wird.This section of the page is not cached and is updated each time the page is refreshed. Die MethodName Eigenschaft der Substitution Steuerelement ruft ab oder legt den Namen der Rückrufmethode 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

Die HttpResponseSubstitutionCallback Delegaten in Kombination mit der WriteSubstitution -Methode wird verwendet, für das Rendern von Inhalt nach dem Zwischenspeichern für die Substitution und AdRotator Steuerelemente.The HttpResponseSubstitutionCallback delegate, in combination with the WriteSubstitution method, is used for rendering post-cache content for the Substitution and AdRotator controls.

Für die Substitution steuern, verwenden Sie die MethodName -Eigenschaft den Namen der Rückrufmethode bei Aufrufen an die Substitution -Steuerelement ausgeführt wird.For the Substitution control, use the MethodName property to specify the name of the callback method to invoke when the Substitution control executes. Die Callback-Methode, die Sie angeben, muss eine statische Methode, die auf der Seite oder auf das Benutzersteuerelement, enthält die Substitution Steuerelement.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ückrufmethode muss die Signatur für übereinstimmen ein HttpResponseSubstitutionCallback Delegaten, die akzeptiert eine HttpContext Parameter und gibt eine Zeichenfolge zurück.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 die AdRotator -Steuerelement, der Rendering ist unabhängig von der Seite an, die Zwischenspeicherung, wenn ein Ereignishandler, für bereitgestellt wird die AdCreated Ereignis.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, nach dem Zwischenspeichern Ersetzung wird verwendet, um das Rendern der AdRotator Inhalt.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