WebZone.EmptyZoneText プロパティ

.NET Framework クラス ライブラリ リファレンス

WebZone.EmptyZoneText プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ゾーンにコントロールが含まれない場合に表示されるメッセージを取得または設定します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Overridable Property
 EmptyZoneText As String

Visual Basic (使用法)

Dim instance As WebZone
Dim value As String

value = instance.EmptyZoneText

instance.EmptyZoneText = value

C#

[LocalizableAttribute(true)] 
public virtual string EmptyZoneText { get;
 set; }

C++

[LocalizableAttribute(true)] 
public:
virtual property String^ EmptyZoneText {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_EmptyZoneText ()

/** @property */
public void set_EmptyZoneText (String value)

JScript

public function get EmptyZoneText
 () : String

public function set EmptyZoneText
 (value : String)

プロパティ値
空のゾーンに表示されるメッセージを含んだ文字列。.NET Framework が提供する、カルチャ固有の既定の文字列。

解説

ゾーンにコントロールが存在せず、そのゾーンが、編集モード、デザイン モード、カタログ モードなどのパーソナル化モードのいずれかである場合、EmptyZoneText プロパティ内のテキストが表示されます。

メモ
ゾーンが、ゾーンの内容にパーソナル化の変更を加えることができるいずれかのパーソナル化モードになっている場合、WebPartManager コントロールは、その WebPartManager.DisplayMode プロパティ内で参照される表示モードのオブジェクト上で、WebPartDisplayMode.AllowPageDesign プロパティ値を true に設定します。

使用例

EmptyZoneText プロパティの使用方法を示すコード例を次に示します。宣言型マークアップには 2 つのゾーンが存在し、2 番目の <asp:webpartzone> 要素は空です。

Visual Basic

<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<html>
<head id="Head1" runat="server">
  
</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>

C#

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<html>
<head id="Head1" runat="server">
  
</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>

ブラウザでデザイン モードに切り替えて、EmptyZoneText プロパティに設定された、空のゾーンに表示されるテキストを確認できます。ページ表示モードの変更方法の詳細については、「チュートリアル : Web パーツ ページでの表示モードの変更」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebZone クラス
WebZone メンバ
System.Web.UI.WebControls.WebParts 名前空間
その他の技術情報
ASP.NET Web パーツ ページ