WebPartManager.CloseProviderWarning Eigenschaft

  • Referenz

Definition

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

Ruft eine Warnung ab, die angezeigt wird, wenn ein Benutzer ein Steuerelement schließt, das als Anbieter für andere Steuerelemente in einer Verbindung fungiert, oder legt diese Warnung fest.

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 von .NET Framework bereitgestellte kulturspezifische Meldung.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die CloseProviderWarning -Eigenschaft verwendet wird, um Benutzern eine benutzerdefinierte Warnung anzuzeigen.

Das Codebeispiel umfasst vier Teile:

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

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

  • Eine Webseite, die zwei benutzerdefinierte WebPart Steuerelemente enthält, 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 Abschnitt Beispiel der WebPartManager Klassenübersicht ab.

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

<%@ 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 Dropdown-Listensteuerelement Anzeigemodus , und wählen Sie Verbinden aus, um die Seite in den Verbindungsmodus zu wechseln. Im Verbindungsmodus wird das <asp:connectionszone> -Element verwendet, damit Sie Verbindungen zwischen Steuerelementen erstellen können. Klicken Sie im Verbindungsmodus auf den Pfeil nach unten in der Titelleiste des POSTLEITZAHL-Steuerelements , um das Menü "Verben" zu aktivieren, und klicken Sie dann auf Verbinden. Nachdem die Benutzeroberfläche (UI) der Verbindung angezeigt wird, klicken Sie auf den Link Verbindung mit einem Consumer erstellen . Es wird eine Zelle mit einem Dropdownlistensteuerelement angezeigt. Wählen Sie in der Dropdownliste Wettersteuerung 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 Browsermodus zurückzugeben. Klicken Sie abschließend auf das Verbenmenü für das Postleitzahlsteuerelement (in diesem Fall das Anbietersteuerelement), und wählen Sie Schließen aus. Die benutzerdefinierte Meldung, 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 Datenanbieter 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 wird. Dies bedeutet, dass steuerelemente, die mit diesem Anbieter verbunden sind, da Consumer keine Daten mehr nutzen können. Mit CloseProviderWarning der -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