Condividi tramite

WebPartManager.CloseProviderWarning Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ottiene o imposta un avviso che viene visualizzato quando un utente chiude un controllo che funge da provider per altri controlli in una connessione.

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

Valore della proprietà

String

Stringa che contiene il messaggio di avviso. Per impostazione predefinita viene visualizzato un messaggio specifico delle impostazioni cultura fornito da .NET Framework.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la CloseProviderWarning proprietà per visualizzare un avviso personalizzato agli utenti.

L'esempio di codice include quattro parti:

  • Controllo utente che consente di modificare le modalità di visualizzazione in una pagina web part.

  • File di codice sorgente che contiene due controlli personalizzati e un'interfaccia personalizzata WebPart .

  • Pagina Web che contiene due controlli personalizzati WebPart che possono essere connessi e un <asp:webpartmanager> elemento.

  • Spiegazione del funzionamento dell'esempio in un browser.

Il codice seguente contiene solo la parte della pagina Web dell'esempio. Sarà inoltre necessario il controllo utente personalizzato e il codice sorgente per i controlli personalizzati indicati in precedenza. Ottenere questi due elementi dalla sezione Esempio della panoramica della WebPartManager classe.

Il codice della pagina Web seguente illustra come assegnare un messaggio di avviso personalizzato alla CloseProviderWarning proprietà nel markup dichiarativo nell'elemento <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>

Dopo aver caricato la pagina Web in un browser, fare clic sul controllo elenco a discesa Modalità visualizzazione e selezionare Connetti per passare alla modalità di connessione. La modalità connetti usa l'elemento <asp:connectionszone> per consentire di creare connessioni tra i controlli. In modalità connetti fare clic sulla freccia verso il basso nella barra del titolo del controllo ZIP Code per attivare il menu verbi e quindi fare clic su Connetti. Dopo aver visualizzato l'interfaccia utente della connessione, fare clic sul collegamento Crea una connessione a un consumer . Viene visualizzata una cella con un controllo elenco a discesa. Selezionare Controllo meteo nell'elenco a discesa e fare clic su Connetti per completare la connessione dei due controlli. Fare clic su Chiudi e quindi usare l'elenco a discesa Modalità di visualizzazione per restituire la pagina alla modalità di esplorazione normale. Infine, fare clic sul menu verbi per il controllo ZIP Code (ovvero il controllo provider in questo caso) e selezionare Chiudi. Viene visualizzato il CloseProviderWarning messaggio personalizzato assegnato alla proprietà.

Commenti

Quando un utente chiude un controllo, normalmente non viene visualizzato alcun WebPart messaggio. Per altre informazioni su ciò che significa chiudere un controllo, vedere il CloseWebPart metodo .

Tuttavia, quando un controllo è connesso a un altro controllo e funge da provider di dati all'altro controllo, viene visualizzato un messaggio di avviso predefinito quando un utente tenta di chiudere il controllo. Il messaggio indica agli utenti che un controllo provider sta per chiudere, il che significa che i controlli connessi a questo provider non avranno più dati da utilizzare. La CloseProviderWarning proprietà consente agli sviluppatori di personalizzare il messaggio di avviso visualizzato all'utente.

Se uno sviluppatore di pagine assegna un valore stringa vuoto o Null a questa proprietà, non verrà visualizzata alcuna finestra di messaggio di avviso quando un utente chiude un controllo che è un WebPart provider.

Si applica a

Vedi anche