WebPartManager.CloseProviderWarning Proprietà

Riferimento

Definizione

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

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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 utilizzare la CloseProviderWarning proprietà per visualizzare un avviso personalizzato per gli utenti.

L'esempio di codice ha 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 WebPart e un'interfaccia personalizzata.
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. Saranno necessari anche 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à di visualizzazione e selezionare Connetti per passare alla modalità di connessione. La modalità di connessione usa l'elemento <asp:connectionszone> per consentire di creare connessioni tra i controlli. In modalità di connessione fare clic sulla freccia rivolta verso il basso nella barra del titolo del controllo CAP per attivare il menu dei verbi e quindi fare clic su Connetti. Dopo aver visualizzato l'interfaccia utente di 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 utilizzare l'elenco a discesa Modalità di visualizzazione per restituire la pagina alla normale modalità di esplorazione. Infine, fare clic sul menu verbi per il controllo CAP (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 WebPart controllo, in genere non viene visualizzato alcun messaggio. Per altre informazioni su cosa 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 chiudersi, 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 WebPart controllo che è un provider.

Si applica a

Vedi anche

controlli web part ASP.NET