HttpResponseSubstitutionCallback Делегат

Определение

Пространство имен:: System.Web

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет метод, который обрабатывает подстановку после кэша.

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

Параметры

context: HttpContext

Содержит HttpContext сведения о HTTP-запросе для страницы с элементом управления, требующим подстановки после кэша.

Возвращаемое значение

String

Содержимое, вставленное в кэшированный ответ перед отправкой клиенту.

Примеры

В следующем примере кода показано, как программным образом добавить Substitution элемент управления в веб-страницу с кэшируемым выходом. При загрузке страницы текущей даты и времени отображается пользователю в метке. Этот раздел страницы кэшируется и обновляется каждые 60 секунд. Substitution При выполнении элемента управления вызывается GetCurrentDateTime метод, который должен соответствовать сигнатуре делегатаHttpResponseSubstitutionCallback. Строка, возвращаемая методом GetCurrentDateTime , отображается пользователю. Этот раздел страницы не кэшируется и обновляется при каждом обновлении страницы. Свойство MethodName Substitution элемента управления получает или задает имя метода обратного вызова.

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

Делегат HttpResponseSubstitutionCallback в сочетании с WriteSubstitution методом используется для отрисовки содержимого после кэша для Substitution элементов управления и AdRotator элементов управления.

Substitution Для элемента управления используйте MethodName свойство, чтобы указать имя метода обратного вызова, вызываемого при Substitution выполнении элемента управления. Указанный метод обратного вызова должен быть статическим методом на странице или в пользовательском элементе управления, который содержит Substitution элемент управления. Сигнатура для метода обратного вызова должна соответствовать сигнатуре делегата HttpResponseSubstitutionCallback , который принимает HttpContext параметр и возвращает строку.

AdRotator Для элемента управления отрисовка не зависит от кэширования страниц, если обработчик событий не указан для AdCreated события. Если обработчик событий отсутствует AdCreated , для отрисовки содержимого используется подстановка после кэша AdRotator .

Методы расширения

Имя	Описание
GetMethodInfo(Delegate)	Возвращает объект, представляющий метод, представленный указанным делегатом.

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

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через