WebZone.BackImageUrl プロパティ

定義

ゾーンの背景イメージの URL を取得または設定します。Gets or sets the URL to a background image for a zone.

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

プロパティ値

ゾーンの背景イメージとして使用されるイメージの URL を表す文字列。A string that represents the URL to an image used as a background image for the zone. 既定値は、空の文字列 ("") です。The default value is an empty string ("").

次のコード例は、 BackImageUrlプロパティの使用方法を示しています。The following code example demonstrates the use of the BackImageUrl property. 宣言マークアップに2つのゾーンがあり、2番目<asp:webpartzone>の要素が空であることに注意してください。Note that there are two zones in the declarative markup, and the second <asp:webpartzone> element is empty.

<%@ 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 a browser, you can switch to design mode to see the image in the empty zone. この例では、 BackImageUrlプロパティの実際の URL が指定されていないことに注意してください。Note that an actual URL for the BackImageUrl property is not provided in this example. ページ表示モードを変更する方法の詳細については、「チュートリアル:Web パーツページでの表示モードの変更For details on how to change page display modes, see Walkthrough: Changing Display Modes on a Web Parts Page.

注釈

ゾーンの背景画像は、ゾーンのコンテンツが表示されるすべての表示モードで表示されます。The background image for a zone is visible in all display modes in which a zone's contents are visible. ゾーンにパーツコントロールが含まれている場合は、コントロールの背後に画像が表示されます。If a zone contains part controls, the image appears behind the controls. ゾーンにコントロールが含まれていない場合、そのコンテンツはブラウズモードでレンダリングされないため、イメージは表示されません。If a zone contains no controls, its contents are not rendered in browse mode, so the image is not displayed.

指定されたイメージがゾーンの本体よりも小さい場合、本文領域全体をカバーするように並べて表示されます。If the supplied image is smaller than the body of a zone, it is tiled to cover the full body area.

適用対象

こちらもご覧ください