WebPartManager.CloseProviderWarning Свойство

  • Ссылка

Определение

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

Получает или задает предупреждение, которое отображается при закрытии пользователем элемента управления, функционирующего в качестве поставщика для других элементов управления в подключении.

public:
 virtual property System::String ^ CloseProviderWarning { System::String ^ get(); void set(System::String ^ value); };
public virtual string CloseProviderWarning { get; set; }
member this.CloseProviderWarning : string with get, set
Public Overridable Property CloseProviderWarning As String

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

String

Строка, содержащая предупреждение. Используемым по умолчанию текстом является соответствующее конкретному языку сообщение, которое предоставляется платформой .NET Framework.

Примеры

В следующем примере кода показано, как использовать CloseProviderWarning свойство для отображения пользовательского предупреждения для пользователей.

Пример кода состоит из четырех частей:

  • Пользовательский элемент управления, позволяющий изменять режимы отображения на странице веб-частей.

  • Файл исходного кода, содержащий два пользовательских WebPart элемента управления и пользовательский интерфейс.

  • Веб-страница, содержащая два пользовательских WebPart элемента управления, которые можно подключить, и <asp:webpartmanager> элемент .

  • Описание работы примера в браузере.

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

В следующем коде веб-страницы показано, как назначить пользовательское предупреждающее сообщение свойству CloseProviderWarning в декларативной разметке в элементе <asp:webpartmanager> .

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ConnectionSampleCS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="WebPartManager1" runat="server"  
          CloseProviderWarning="You are closing a provider control." />
    <div>
      <uc1:DisplayModeMenuCS ID="displaymode1" runat="server" />
      <!-- Reference consumer and provider controls in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <!-- Add a ConnectionsZone so users can connect controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
    </div>
    </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="ConnectionSampleVB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="WebPartManager1" runat="server"  
          CloseProviderWarning="You are closing a provider control." />
    <div>
      <uc1:DisplayModeMenuVB ID="displaymode1" runat="server" />
      <!-- Reference consumer and provider controls in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <!-- Add a ConnectionsZone so users can connect controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
    </div>
    </form>
</body>
</html>

Загрузив веб-страницу в браузере, щелкните раскрывающийся список Режим отображения и выберите Подключить , чтобы переключить страницу в режим подключения. В режиме <asp:connectionszone> подключения элемент используется для создания соединений между элементами управления. В режиме подключения щелкните стрелку вниз в заголовке окна элемента управления Почтовый индекс , чтобы активировать меню команд, а затем выберите подключиться. После появления пользовательского интерфейса подключения щелкните ссылку Создать подключение к объекту-получателю . Появится ячейка с элементом управления раскрывающимся списком. Выберите Управление погодой в раскрывающемся списке и нажмите кнопку Подключить , чтобы завершить соединение двух элементов управления. Нажмите кнопку Закрыть, а затем используйте раскрывающийся список Режим отображения , чтобы вернуть страницу в обычный режим просмотра. Наконец, щелкните меню глаголов для элемента управления ПОЧТОВЫЙ ИНДЕКС (в данном случае это элемент управления поставщика) и выберите Закрыть. Отобразится пользовательское сообщение, назначенное свойству CloseProviderWarning .

Комментарии

Когда пользователь закрывает WebPart элемент управления, обычно сообщение не отображается. Дополнительные сведения о закрытии элемента управления см. в этом методе CloseWebPart .

Однако если элемент управления подключен к другому элементу управления и выступает в качестве поставщика данных для другого элемента управления, при попытке пользователя закрыть элемент управления отображается предупреждающее сообщение по умолчанию. Сообщение сообщает пользователям, что элемент управления поставщика вот-вот закроется. Это означает, что элементы управления, подключенные к этому поставщику в качестве потребителей, больше не будут иметь никаких данных для использования. Свойство CloseProviderWarning позволяет разработчикам настраивать предупреждающее сообщение, отображаемое для пользователя.

Если разработчик страницы присваивает этому свойству пустое строковое значение или значение NULL, при закрытии WebPart пользователем элемента управления, который является поставщиком, окно предупреждения не отображается.

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

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