WebPartManager.CloseProviderWarning Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

String

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 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 na 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 Conexão para alternar a página para o modo de conexão. Conexão modo 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 Conexão. Depois que a interface do usuário (interface do usuário) de conexão for exibida, clique em Criar uma conexão com um link do Consumidor . Uma célula é exibida que tem um controle de lista suspensa. Selecione Controle meteorológico na lista suspensa e clique em Conexão para concluir a conexão dos dois controles. Clique em Fechar e 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 ZIP Code (que é o controle do provedor nesse 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 é 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

controles ASP.NET Web Parts