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 Ein Steuerelement deklarativ zu einer zwischengespeicherten Ausgabewebseite hinzugefügt Substitution wird. Wenn die Seite geladen wird, wird dem Benutzer eine statische Aufzählung angezeigt. Dieser Abschnitt der Seite wird zwischengespeichert und nur alle 60 Sekunden aktualisiert. Wenn das Substitution Steuerelement ausgeführt wird, ruft sie die GetUser Methode auf, die eine Zeichenfolge zurückgibt, die den aktuellen Benutzer darstellt. Diese Zeichenfolge wird an der Position des Substitution Steuerelements auf der Seite angezeigt. Dieser Abschnitt der Seite wird nicht zwischengespeichert und wird 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 beim Ausführen des Substitution Steuerelements aufgerufen werden soll. Die von Ihnen angegebene Rückrufmethode muss eine statische Methode auf der Seite oder dem Benutzersteuerelement sein, die 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 verwendet und eine Zeichenfolge zurückgibt. Die Zeichenfolge, die die Rückrufmethode zurückgibt, ist der Inhalt, der an der Seite an der Position des Substitution Steuerelements angezeigt werden soll.

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

Gilt für

Siehe auch