Прочитать на английском

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

HttpResponseSubstitutionCallback Делегат

  • Ссылка

Определение

Пространство имен:
System.Web
Сборка:
System.Web.dll

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

public delegate string HttpResponseSubstitutionCallback(HttpContext context);

Параметры

context
HttpContext

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

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

String

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

Примеры

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

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

Комментарии

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

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

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

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

GetMethodInfo(Delegate)

Получает объект, представляющий метод, представленный указанным делегатом.

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

Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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