WebPartManager.CloseProviderWarning Egenskap

Definition

Namnområde:
System.Web.UI.WebControls.WebParts
Sammansättning:
System.Web.dll

Hämtar eller anger en varning som visas när en användare stänger en kontroll som fungerar som leverantör till andra kontroller i en anslutning.

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

Egenskapsvärde

String

En sträng som innehåller varningsmeddelandet. Standardvärdet är ett kulturspecifikt meddelande som tillhandahålls av .NET Framework.

Exempel

Följande kodexempel visar hur du använder CloseProviderWarning egenskapen för att visa en anpassad varning för användare.

Kodexemplet har fyra delar:

  • En användarkontroll som gör att du kan ändra visningslägen på en webbdelssida.

  • En källkodsfil som innehåller två anpassade WebPart kontroller och ett anpassat gränssnitt.

  • En webbsida som innehåller två anpassade WebPart kontroller som kan anslutas och ett <asp:webpartmanager> element.

  • En förklaring av hur exemplet fungerar i en webbläsare.

Följande kod innehåller endast webbsidedelen i exemplet. Du behöver också den anpassade användarkontrollen och källkoden för de anpassade kontroller som nämns ovan. Hämta dessa två objekt från avsnittet Exempel i klassöversikten WebPartManager .

Följande webbsideskod visar hur du tilldelar ett anpassat varningsmeddelande till CloseProviderWarning egenskapen i deklarativ kod i elementet <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>

När du har läst in webbsidan i en webbläsare klickar du på listrutan Visningsläge och väljer Anslut för att växla sidan till anslutningsläge. I anslutningsläget används elementet <asp:connectionszone> för att du ska kunna skapa anslutningar mellan kontroller. I anslutningsläge klickar du på nedåtpilen i namnlisten på postnummerkontrollen för att aktivera verbmenyn och klickar sedan på Anslut. När anslutningsanvändargränssnittet (UI) visas klickar du på länken Skapa en anslutning till en konsument . En cell visas som har en listrutekontroll. Välj Väderkontroll i listrutan och klicka på Anslut för att slutföra anslutningen för de två kontrollerna. Klicka på Stäng och använd sedan listrutan Visningsläge för att återgå till normalt sökläge. Klicka slutligen på verbmenyn för postnummerkontrollen (vilket är providerkontrollen i det här fallet) och välj Stäng. Det anpassade meddelandet som du tilldelade egenskapen CloseProviderWarning visas.

Kommentarer

När en användare stänger en WebPart kontroll visas normalt inget meddelande. Mer information om vad det innebär att stänga en kontroll finns i CloseWebPart metoden.

Men när en kontroll är ansluten till en annan kontroll och fungerar som leverantör av data till den andra kontrollen visas ett standardvarningsmeddelande när en användare försöker stänga kontrollen. Meddelandet talar om för användarna att en providerkontroll håller på att stängas, vilket innebär att kontroller som är anslutna till den här providern eftersom konsumenterna inte längre har några data att använda. Egenskapen CloseProviderWarning gör det möjligt för utvecklare att anpassa varningsmeddelandet som visas för användaren.

Om en sidutvecklare tilldelar ett tomt eller null-strängvärde till den här egenskapen visas ingen varningsruta när en användare stänger en WebPart kontroll som är en provider.

Gäller för

Se även