WebZone.BackImageUrl Eigenschaft

  • Referenz

Definition

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

Ruft die URL für ein Hintergrundbild einer Zone ab oder legt sie fest.

public:
 virtual property System::String ^ BackImageUrl { System::String ^ get(); void set(System::String ^ value); };
public virtual string BackImageUrl { get; set; }
member this.BackImageUrl : string with get, set
Public Overridable Property BackImageUrl As String

Eigenschaftswert

String

Eine Zeichenfolge, die die URL des Bildes darstellt, das als Hintergrundbild der Zone verwendet wird. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Im folgenden Codebeispiel wird die Verwendung des BackImageUrl-Attributs veranschaulicht. Beachten Sie, dass zwei Zonen im deklarativen Markup vorhanden sind, 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" 
      BackImageUrl="image.GIF">
    </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" 
      BackImageUrl="image.GIF">
    </asp:webpartzone>
  </form>
</body>
</html>

In einem Browser können Sie zum Entwurfsmodus wechseln, um das Bild in der leeren Zone anzuzeigen. Beachten Sie, dass in diesem Beispiel keine tatsächliche URL für die BackImageUrl Eigenschaft bereitgestellt wird. Ausführliche Informationen zum Ändern von Seitenanzeigemodi finden Sie unter Exemplarische Vorgehensweise: Ändern von Anzeigemodi auf einer Webparts Seite.

Hinweise

Das Hintergrundbild für eine Zone ist in allen Anzeigemodi sichtbar, in denen der Inhalt einer Zone sichtbar ist. Wenn eine Zone Teilsteuerelemente enthält, wird das Bild hinter den Steuerelementen angezeigt. Wenn eine Zone keine Steuerelemente enthält, werden ihre Inhalte im Navigationsmodus nicht gerendert, sodass das Bild nicht angezeigt wird.

Wenn das angegebene Bild kleiner als der Textkörper einer Zone ist, wird es gekachelt, um den vollständigen Körperbereich abzudecken.

Gilt für

Siehe auch