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 позволяет разработчикам настраивать предупреждающее сообщение, отображаемое для пользователя.

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

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

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

элементы управления веб-частей ASP.NET

Бөлісу құралы: