WebZone.EmptyZoneText Eigenschaft

Referenz

Definition

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

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Dient zum Abrufen oder Festlegen einer Meldung, die angezeigt wird, wenn eine Zone keine Steuerelemente enthält.

public:
 virtual property System::String ^ EmptyZoneText { System::String ^ get(); void set(System::String ^ value); };

public virtual string EmptyZoneText { get; set; }

member this.EmptyZoneText : string with get, set

Public Overridable Property EmptyZoneText As String

Eigenschaftswert

String

Eine Zeichenfolge mit der Meldung, die in einer leeren Zone angezeigt wird. Eine kulturspezifische Standardzeichenfolge wird von .NET Framework bereitgestellt.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des EmptyZoneText-Attributs veranschaulicht. Beachten Sie, dass das deklarative Markup zwei Zonen enthält, und das zweite <asp:webpartzone> Element ist leer.

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<!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">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server">
        <zonetemplate>
          <asp:Calendar ID="cal1" Runat="server" Title="My Calendar" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server" 
      EmptyZoneText="No controls in this zone.">
    </asp:webpartzone>
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<!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">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server">
        <zonetemplate>
          <asp:Calendar ID="cal1" Runat="server" Title="My Calendar" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server" 
      EmptyZoneText="No controls in this zone.">
    </asp:webpartzone>
  </form>
</body>
</html>

In einem Browser können Sie in den Entwurfsmodus wechseln, um den für die EmptyZoneText Eigenschaft bereitgestellten Text anzuzeigen, der in der leeren Zone angezeigt wird. Ausführliche Informationen zum Ändern von Seitenanzeigemodi finden Sie unter Exemplarische Vorgehensweise: Ändern von Anzeigemodi auf einer Webparts-Seite.

Hinweise

Der Text in der EmptyZoneText -Eigenschaft wird angezeigt, wenn keine Steuerelemente in einer Zone vorhanden sind und sich die Zone in einem der Personalisierungsmodi befindet, z. B. bearbeiten, entwerfen oder katalogisieren.

Hinweis

Wenn eine Zone in einen der Personalisierungsmodi wechselt, mit denen Personalisierungsänderungen am Inhalt der Zone vorgenommen werden können, legt das WebPartManager Steuerelement den WebPartDisplayMode.AllowPageDesign Eigenschaftswert für das Anzeigemodusobjekt, auf das in der WebPartManager.DisplayMode -Eigenschaft verwiesen wird, auf true fest.

Gilt für:

Weitere Informationen

ASP.NET Webparts-Steuerelemente