Partilhar via


WebPartManager.CloseProviderWarning Propriedade

Definição

Obtém ou define um aviso que é exibido quando um usuário fecha um controle que atua como um provedor para outros controles em uma conexão.

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

Valor da propriedade

Uma cadeia de caracteres que contém a mensagem de aviso. O padrão é uma mensagem específica da cultura fornecida pelo .NET Framework.

Exemplos

O exemplo de código a seguir demonstra como usar a CloseProviderWarning propriedade para exibir um aviso personalizado aos usuários.

O exemplo de código tem quatro partes:

  • Um controle de usuário que permite alterar os modos de exibição em uma página de Web Parts.

  • Um arquivo de código-fonte que contém dois controles personalizados WebPart e uma interface personalizada.

  • Uma página da Web que contém dois controles personalizados WebPart que podem ser conectados e um <asp:webpartmanager> elemento .

  • Uma explicação de como o exemplo funciona em um navegador.

O código a seguir contém apenas a parte da página da Web do exemplo. Você também precisará do controle de usuário personalizado e do código-fonte para os controles personalizados mencionados acima. Obtenha esses dois itens da seção Exemplo da visão geral da WebPartManager classe.

O código da página da Web a seguir demonstra como atribuir uma mensagem de aviso personalizada à CloseProviderWarning propriedade na marcação declarativa no <asp:webpartmanager> elemento .

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

Depois de carregar a página da Web em um navegador, clique no controle de lista suspensa Modo de Exibição e selecione Conectar para alternar a página para o modo de conexão. O modo de conexão usa o <asp:connectionszone> elemento para permitir que você crie conexões entre controles. No modo de conexão, clique na seta para baixo na barra de título do controle CEP para ativar seu menu de verbos e clique em Conectar. Depois que a interface do usuário da conexão for exibida, clique no link Criar uma conexão com um Consumidor . Uma célula é exibida com um controle de lista suspensa. Selecione Controle de Clima na lista suspensa e clique em Conectar para concluir a conexão dos dois controles. Clique em Fechar e, em seguida, use a lista suspensa Modo de Exibição para retornar a página ao modo de navegação normal. Por fim, clique no menu de verbos do controle CEP (que é o controle do provedor neste caso) e selecione Fechar. A mensagem personalizada atribuída à CloseProviderWarning propriedade é exibida.

Comentários

Quando um usuário fecha um WebPart controle, normalmente nenhuma mensagem é exibida. Para obter mais informações sobre o que significa fechar um controle, consulte o CloseWebPart método .

No entanto, quando um controle está conectado a outro controle e está agindo como um provedor de dados para o outro controle, uma mensagem de aviso padrão é exibida quando um usuário tenta fechar o controle. A mensagem informa aos usuários que um controle de provedor está prestes a ser fechado, o que significa que os controles conectados a esse provedor, pois os consumidores não terão mais dados para consumir. A CloseProviderWarning propriedade permite que os desenvolvedores personalizem a mensagem de aviso exibida para o usuário.

Se um desenvolvedor de página atribuir um valor de cadeia de caracteres vazio ou nulo a essa propriedade, nenhuma caixa de mensagem de aviso será mostrada quando um usuário fechar um WebPart controle que seja um provedor.

Aplica-se a

Confira também