Freigeben über

WebPartManager.CloseProviderWarning Eigenschaft

Definition

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

Dient zum Abrufen oder Festlegen einer Warnung, die angezeigt wird, wenn ein Benutzer ein Steuerelement schließt, das als Anbieter für andere Steuerelemente in einer Verbindung fungiert.

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

Eigenschaftswert

String

Eine Zeichenfolge, die die Warnmeldung enthält. Der Standardwert ist eine kulturspezifische Nachricht, die vom .NET Framework bereitgestellt wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die CloseProviderWarning Eigenschaft zum Anzeigen einer benutzerdefinierten Warnung für Benutzer verwendet wird.

Das Codebeispiel enthält vier Teile:

  • Ein Benutzersteuerelement, mit dem Sie Anzeigemodi auf einer Webparts-Seite ändern können.

  • Eine Quellcodedatei, die zwei benutzerdefinierte Steuerelemente und eine benutzerdefinierte WebPart Schnittstelle enthält.

  • Eine Webseite mit zwei benutzerdefinierten WebPart Steuerelementen, die verbunden werden können, und ein <asp:webpartmanager> Element.

  • Eine Erläuterung der Funktionsweise des Beispiels in einem Browser.

Der folgende Code enthält nur den Webseitenteil des Beispiels. Außerdem benötigen Sie das benutzerdefinierte Benutzersteuerelement und den Quellcode für die oben genannten benutzerdefinierten Steuerelemente. Rufen Sie diese beiden Elemente aus dem Beispielabschnitt der WebPartManager Klassenübersicht ab.

Der folgende Webseitencode veranschaulicht, wie der Eigenschaft im deklarativen Markup im <asp:webpartmanager> Element eine benutzerdefinierte Warnmeldung zugewiesen CloseProviderWarning wird.

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

Nachdem Sie die Webseite in einem Browser geladen haben, klicken Sie auf das Dropdownlistensteuerelement "Anzeigemodus ", und wählen Sie "Verbinden" aus, um die Seite in den Verbindungsmodus zu wechseln. Der Verbindungsmodus verwendet das <asp:connectionszone> Element, damit Sie Verbindungen zwischen Steuerelementen erstellen können. Klicken Sie im Verbindungsmodus auf den Abwärtspfeil in der Titelleiste des PLZ-Steuerelements , um das Verbenmenü zu aktivieren, und klicken Sie dann auf "Verbinden". Nachdem die Verbindungs-Benutzeroberfläche (UI) angezeigt wird, klicken Sie auf die Verbindung mit einem Consumer-Link erstellen. Eine Zelle wird angezeigt, die über ein Dropdownlistensteuerelement verfügt. Wählen Sie " Wettersteuerelement " in der Dropdownliste aus, und klicken Sie auf "Verbinden" , um die Verbindung der beiden Steuerelemente abzuschließen. Klicken Sie auf "Schließen", und verwenden Sie dann die Dropdownliste " Anzeigemodus ", um die Seite in den normalen Suchmodus zurückzugeben. Klicken Sie schließlich auf das Verbenmenü für das PLZ-Steuerelement (in diesem Fall das Anbietersteuerelement), und wählen Sie "Schließen" aus. Die benutzerdefinierte Nachricht, die Sie der CloseProviderWarning Eigenschaft zugewiesen haben, wird angezeigt.

Hinweise

Wenn ein Benutzer ein WebPart Steuerelement schließt, wird normalerweise keine Meldung angezeigt. Weitere Informationen dazu, was es bedeutet, ein Steuerelement zu schließen, finden Sie in der CloseWebPart Methode.

Wenn jedoch ein Steuerelement mit einem anderen Steuerelement verbunden ist und als Anbieter von Daten für das andere Steuerelement fungiert, wird eine Standardwarnung angezeigt, wenn ein Benutzer versucht, das Steuerelement zu schließen. Die Meldung teilt Benutzern mit, dass ein Anbietersteuerelement geschlossen werden soll. Dies bedeutet, dass Steuerelemente, die mit diesem Anbieter verbunden sind, da Verbraucher keine Daten mehr verwenden können. Mit der CloseProviderWarning Eigenschaft können Entwickler die Warnmeldung anpassen, die dem Benutzer angezeigt wird.

Wenn ein Seitenentwickler dieser Eigenschaft einen leeren oder NULL-Zeichenfolgenwert zuweist, wird kein Warnmeldungsfeld angezeigt, wenn ein Benutzer ein WebPart Steuerelement schließt, das ein Anbieter ist.

Gilt für:

Weitere Informationen