WebPartManager.CloseProviderWarning Propiedad

Definición

Obtiene o establece una advertencia que se muestra cuando un usuario cierra un control que actúa como proveedor de otros controles en una conexión.

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 de propiedad

String

Cadena que contiene el mensaje de advertencia. El valor predeterminado es un mensaje específico de la referencia cultural suministrado por .NET Framework.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la CloseProviderWarning propiedad para mostrar una advertencia personalizada a los usuarios.

El ejemplo de código tiene cuatro partes:

  • Control de usuario que permite cambiar los modos de visualización en una página de elementos web.

  • Un archivo de código fuente que contiene dos controles personalizados WebPart y una interfaz personalizada.

  • Página web que contiene dos controles personalizados WebPart que se pueden conectar y un <asp:webpartmanager> elemento.

  • Explicación de cómo funciona el ejemplo en un explorador.

El código siguiente contiene solo la parte de la página web del ejemplo. También necesitará el control de usuario personalizado y el código fuente para los controles personalizados mencionados anteriormente. Obtenga estos dos elementos en la sección Ejemplo de la información general de la WebPartManager clase.

El siguiente código de página web muestra cómo asignar un mensaje de advertencia personalizado a la CloseProviderWarning propiedad en marcado declarativo en el <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>

Después de cargar la página web en un explorador, haga clic en el control de lista desplegable Modo de presentación y seleccione Conectar para cambiar la página al modo de conexión. Conectar modo usa el <asp:connectionszone> elemento para permitirle crear conexiones entre controles. En el modo de conexión, haga clic en la flecha hacia abajo en la barra de título del control código postal para activar su menú de verbos y, a continuación, haga clic en Conectar. Una vez que aparezca la interfaz de usuario (UI) de conexión, haga clic en el vínculo Crear una conexión a un consumidor . Aparece una celda que tiene un control de lista desplegable. Seleccione Control meteorológico en la lista desplegable y haga clic en Conectar para completar la conexión de los dos controles. Haga clic en Cerrar y, a continuación, use la lista desplegable Modo de presentación para devolver la página al modo de exploración normal. Por último, haga clic en el menú verbos del control código postal (que es el control de proveedor en este caso) y seleccione Cerrar. Se muestra el mensaje personalizado que asignó a la CloseProviderWarning propiedad .

Comentarios

Cuando un usuario cierra un WebPart control, normalmente no se muestra ningún mensaje. Para obtener más información sobre lo que significa cerrar un control, vea el CloseWebPart método .

Sin embargo, cuando un control está conectado a otro control y actúa como proveedor de datos al otro control, se muestra un mensaje de advertencia predeterminado cuando un usuario intenta cerrar el control. El mensaje indica a los usuarios que un control de proveedor está a punto de cerrarse, lo que significa que los controles conectados a este proveedor, ya que los consumidores ya no tendrán datos que consumir. La CloseProviderWarning propiedad permite a los desarrolladores personalizar el mensaje de advertencia que se muestra al usuario.

Si un desarrollador de páginas asigna un valor de cadena vacío o nulo a esta propiedad, no se mostrará ningún cuadro de mensaje de advertencia cuando un usuario cierre un WebPart control que sea un proveedor.

Se aplica a

Consulte también