WebPartZoneBase.EmptyZoneText Eigenschaft

  • Referenz

Definition

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

Ruft eine Meldung ab, die angezeigt wird, wenn ein WebPartZoneBase-Steuerelement keine WebPart-Steuerelemente enthält, oder legt diese fest.

public:
 virtual property System::String ^ EmptyZoneText { System::String ^ get(); void set(System::String ^ value); };
public override string EmptyZoneText { get; set; }
member this.EmptyZoneText : string with get, set
Public Overrides 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 deklarative Verwendung der EmptyZoneText -Eigenschaft für ein WebPartZone Steuerelement veranschaulicht. Das vollständige Codebeispiel, einschließlich der CodeBehind-Quelldatei und der ASPX-Seite, die die Zone in diesem Code enthält, finden Sie in der WebPartZoneBase Klassenübersicht.

Beachten Sie, dass der EmptyZoneText Eigenschaft im deklarativen Markup ein Wert zugewiesen ist. Dieser Wert wird in WebPartZone2angezeigt, nachdem Sie die Seite in einen Browser geladen haben, die Seite in den Entwurfsanzeigemodus wechseln und das Steuerelement, das das Datum anzeigt WebPartZone2 , in WebPartZone1ziehen. Weitere Informationen zum Ändern der Anzeigemodi auf einer Webpartseite finden Sie unter Exemplarische Vorgehensweise: Ändern von Anzeigemodi auf einer Webpartseite.

<asp:WebPartZone 
  ID="WebPartZone2"
  Runat="server" 
  DragHighlightColor="#00ff00"
  AllowLayoutChange="true"
  EmptyZoneText="Add WebParts to this empty Zone."
  BorderWidth="2"
  BorderColor="DarkBlue"
  BorderStyle="Dashed" 
  MenuLabelText="Verbs Menu" 
  MenuPopupImageUrl="label.gif" >
  <VerbStyle Font-Italic="true" />
  <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
  <MenuLabelHoverStyle Font-Bold="true" />
  <MenuVerbHoverStyle BackColor="LightGrey" />
  <MenuVerbStyle Font-Italic="true" /> 
  <ZoneTemplate>
    <asp:Label ID="Label1" Runat="server" Title="Date" />
  </ZoneTemplate>
</asp:WebPartZone>

<asp:WebPartZone 
  ID="WebPartZone2"
  Runat="server" 
  DragHighlightColor="#00ff00"
  AllowLayoutChange="true"
  EmptyZoneText="Add WebParts to this empty Zone."
  BorderWidth="2"
  BorderColor="DarkBlue"
  BorderStyle="Dashed" 
  MenuLabelText="Verbs Menu" 
  MenuPopupImageUrl="label.gif" >
  <VerbStyle Font-Italic="true" />
  <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
  <MenuLabelHoverStyle Font-Bold="true" />
  <MenuVerbHoverStyle BackColor="LightGrey" />
  <MenuVerbStyle Font-Italic="true" /> 
  <ZoneTemplate>
    <asp:Label ID="Label1" Runat="server" Title="Date" />
  </ZoneTemplate>
</asp:WebPartZone>

Hinweise

Die EmptyZoneText Eigenschaft überschreibt die Basiseigenschaft, um zwischen Fällen zu unterscheiden, in denen die Eigenschaft nicht festgelegt wurde, und den Fällen, in denen sie auf eine leere Zeichenfolge ("") festgelegt wurde.

Wenn die -Eigenschaft nicht festgelegt wurde und die Zone keine Steuerelemente enthält, wird in einem leeren WebPartZoneBase Steuerelement eine standardmäßige kulturspezifische Textnachricht angezeigt, wenn eine Webpartseite in einen Anzeigemodus wechselt, in dem die Zone sichtbar ist. Wenn der EmptyZoneText Eigenschaftswert absichtlich auf eine leere Zeichenfolge festgelegt wurde, wird keine TEXTnachricht in einer leeren Zone angezeigt.

Gilt für:

Weitere Informationen