WebPartManager.CloseProviderWarning Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Hiermee wordt een waarschuwing opgehaald of ingesteld die wordt weergegeven wanneer een gebruiker een besturingselement sluit dat als provider fungeert voor andere besturingselementen in een verbinding.

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

Waarde van eigenschap

String

Een tekenreeks die het waarschuwingsbericht bevat. De standaardwaarde is een cultuurspecifiek bericht dat wordt geleverd door het .NET Framework.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de CloseProviderWarning eigenschap gebruikt om een aangepaste waarschuwing weer te geven aan gebruikers.

Het codevoorbeeld heeft vier delen:

  • Een gebruikersbeheer waarmee u weergavemodi op een pagina met webonderdelen kunt wijzigen.

  • Een broncodebestand met twee aangepaste WebPart besturingselementen en een aangepaste interface.

  • Een webpagina met twee aangepaste WebPart besturingselementen die kunnen worden verbonden en een <asp:webpartmanager> element.

  • Een uitleg van hoe het voorbeeld werkt in een browser.

De volgende code bevat alleen het webpaginagedeelte van het voorbeeld. U hebt ook het aangepaste gebruikersbesturingselement en de broncode nodig voor de hierboven genoemde aangepaste besturingselementen. Haal deze twee items op uit de sectie Voorbeeld van het WebPartManager klassenoverzicht.

De volgende webpaginacode laat zien hoe u een aangepast waarschuwingsbericht toewijst aan de CloseProviderWarning eigenschap in declaratieve markeringen in het <asp:webpartmanager> element.

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

Nadat u de webpagina in een browser hebt geladen, klikt u op het besturingselement voor de vervolgkeuzelijst Weergavemodus en selecteert u Verbinding maken om de pagina over te schakelen naar de verbindingsmodus. De verbindingsmodus maakt gebruik van het <asp:connectionszone> element om verbindingen tussen besturingselementen te maken. Klik in de verbindingsmodus op de pijl-omlaag in de titelbalk van het besturingselement Postcode om het menu werkwoorden te activeren en klik vervolgens op Verbinden. Nadat de gebruikersinterface van de verbinding (UI) wordt weergegeven, klikt u op de koppeling Een verbinding met een consument maken . Er wordt een cel weergegeven met een besturingselement voor de vervolgkeuzelijst. Selecteer Weerbesturingselement in de vervolgkeuzelijst en klik op Verbinding maken om de verbinding van de twee besturingselementen te voltooien. Klik op Sluiten en gebruik vervolgens de vervolgkeuzelijst Weergavemodus om de pagina terug te zetten naar de normale bladermodus. Klik ten slotte op het menu Werkwoorden voor het besturingselement Postcode (dit is het besturingselement provider in dit geval) en selecteer Sluiten. Het aangepaste bericht dat u aan de CloseProviderWarning eigenschap hebt toegewezen, wordt weergegeven.

Opmerkingen

Wanneer een gebruiker een WebPart besturingselement sluit, wordt normaal gesproken geen bericht weergegeven. Zie de CloseWebPart methode voor meer informatie over wat het betekent om een besturingselement te sluiten.

Wanneer een besturingselement echter is verbonden met een ander besturingselement en fungeert als gegevensprovider voor het andere besturingselement, wordt er een standaardwaarschuwingsbericht weergegeven wanneer een gebruiker probeert het besturingselement te sluiten. Het bericht vertelt gebruikers dat een providerbesturingselement bijna wordt gesloten, wat betekent dat besturingselementen die zijn verbonden met deze provider, omdat consumenten geen gegevens meer hebben om te gebruiken. Met CloseProviderWarning de eigenschap kunnen ontwikkelaars het waarschuwingsbericht aanpassen dat wordt weergegeven aan de gebruiker.

Als een paginaontwikkelaar een lege of null-tekenreekswaarde aan deze eigenschap toewijst, wordt er geen waarschuwingsbericht weergegeven wanneer een gebruiker een WebPart besturingselement sluit dat een provider is.

Van toepassing op

Zie ook