Freigeben über

Substitution.MethodName Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft den Namen der beim Ausführen des Substitution-Steuerelements aufzurufenden Rückrufmethode ab oder legt diesen fest.

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

Eigenschaftswert

String

Eine Zeichenfolge, die den Namen der Methode darstellt, die beim Ausführen des Substitution-Steuerelements aufgerufen wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie einer ausgabegecacheten Webseite ein Substitution Steuerelement deklarativ hinzufügen. Wenn die Seite geladen wird, wird dem Benutzer eine statische Aufzählung angezeigt. Dieser Abschnitt der Seite wird nur alle 60 Sekunden zwischengespeichert und aktualisiert. Wenn das Substitution Steuerelement ausgeführt wird, ruft es die GetUser -Methode auf, die eine Zeichenfolge zurückgibt, die den aktuellen Benutzer darstellt. Diese Zeichenfolge wird an der Position des Steuerelements Substitution auf der Seite angezeigt. Dieser Abschnitt der Seite wird nicht zwischengespeichert und jedes Mal aktualisiert, wenn die Seite aktualisiert wird.

<%@ 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>

Hinweise

Verwenden Sie die MethodName -Eigenschaft, um den Namen der Rückrufmethode anzugeben, die bei der Ausführung des Substitution Steuerelements aufgerufen werden soll. Die von Ihnen angegebene Rückrufmethode muss eine statische Methode auf dem Seiten- oder Benutzersteuerelement sein, das das Substitution Steuerelement enthält. Die Signatur für die Rückrufmethode muss mit der Signatur für einen HttpResponseSubstitutionCallback Delegaten übereinstimmen, der einen HttpContext Parameter akzeptiert und eine Zeichenfolge zurückgibt. Die von der Rückrufmethode zurückgegebene Zeichenfolge ist der Inhalt, der auf der Seite an der Position des Steuerelements Substitution angezeigt werden soll.

Der HttpContext Parameter kapselt alle HTTP-spezifischen Informationen zu einer einzelnen HTTP-Anforderung. Sie können damit auf Sitzungsvariablen, Autorisierungsinformationen und Personalisierungsdetails zugreifen. Weitere Informationen finden Sie unter HttpResponseSubstitutionCallback.

Gilt für:

Weitere Informationen