Substitution.MethodName Свойство

Определение

Получает или задает имя метода обратного вызова, которое вызывается при исполнении элемента управления Substitution.Gets or sets the name of the callback method to invoke when the Substitution control executes.

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

Значение свойства

Строка, представляющая имя метода, которое вызывается при исполнении элемента управления Substitution.A string that represents the name of the method to invoke when the Substitution control executes.

Примеры

В следующем примере кода показано, как декларативно Substitution добавить элемент управления на веб-страницу с кэшированием выходных данных.The following code example demonstrates how to add a Substitution control declaratively to an output-cached Web page. При загрузке страницы пользователю отображается статический маркированный список.When the page loads, a static bulleted list is displayed to the user. Этот раздел страницы кэшируется и обновляется только каждые 60 секунд.This section of the page is cached and updated only every 60 seconds. При выполнении GetUser элемента управления вызывается метод, который возвращает строку, представляющую текущего пользователя. SubstitutionWhen the Substitution control executes, it calls the GetUser method, which returns a string that represents the current user. Эта строка отображается в расположении Substitution элемента управления на странице.This string is displayed at the location of the Substitution control on the page. Этот раздел страницы не кэшируется и обновляется каждый раз при обновлении страницы.This section of the page is not cached and is updated each time the page is refreshed.

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

Комментарии

Используйте свойство, чтобы указать имя метода обратного вызова, который будет вызываться Substitution при выполнении элемента управления. MethodNameUse the MethodName property to specify the name of the callback method to invoke when the Substitution control executes. Указываемый метод обратного вызова должен быть статическим методом на странице или в пользовательском элементе управления, который Substitution содержит элемент управления.The callback method that you specify must be a static method on the page or user control that contains the Substitution control. Сигнатура для метода обратного вызова должна соответствовать сигнатуре для HttpResponseSubstitutionCallback делегата, который HttpContext принимает параметр и возвращает строку.The signature for the callback method must match the signature for a HttpResponseSubstitutionCallback delegate that takes an HttpContext parameter and returns a string. Строка, возвращаемая методом обратного вызова, — это содержимое, отображаемое на странице в расположении Substitution элемента управления.The string that the callback method returns is the content to display on the page at the location of the Substitution control.

HttpContext Параметр инкапсулирует все сведения, относящиеся к HTTP, об отдельном HTTP-запросе.The HttpContext parameter encapsulates all HTTP-specific information about an individual HTTP request. Его можно использовать для доступа к переменным сеанса, сведениям о авторизации и сведениям о персонализации.You can use it to access session variables, authorization information, and personalization details. Для получения дополнительной информации см. HttpResponseSubstitutionCallback.For more information, see HttpResponseSubstitutionCallback.

Применяется к

Дополнительно