WebPartZoneBase.EmptyZoneText プロパティ

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

WebPartZoneBase.EmptyZoneText プロパティ

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

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

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

Visual Basic (宣言)

Public Overrides Property
 EmptyZoneText As String

Visual Basic (使用法)

Dim instance As WebPartZoneBase
Dim value As String

value = instance.EmptyZoneText

instance.EmptyZoneText = value

C#

public override string EmptyZoneText { get;
 set; }

C++

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

J#

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

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

JScript

public override function get
 EmptyZoneText () : String

public override function set
 EmptyZoneText (value : String)

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

解説

EmptyZoneText プロパティは、基本プロパティをオーバーライドして、プロパティが設定されていない場合と空の文字列 ("") に設定されている場合を区別します。

プロパティが設定されておらず、ゾーンにコントロールが含まれていない場合、Web パーツ ページがゾーンを表示できる表示モードになると、空の WebPartZoneBase コントロールに既定のカルチャ固有のテキスト メッセージが表示されます。EmptyZoneText プロパティ値が意図的に空の文字列に設定されている場合、空のゾーンにはテキスト メッセージは表示されません。

使用例

WebPartZone コントロールで、EmptyZoneText プロパティを宣言によって使用するコード例を次に示します。分離コード ソース ファイルおよびこのコードのゾーンを含む .aspx ページなどコード例全体については、WebPartZoneBase クラスの概要を参照してください。

EmptyZoneText プロパティは、宣言型マークアップで割り当てる値を持っています。この値が WebPartZone2 に表示されるのは、ブラウザをページに読み込んで、デザイン表示モードに切り替え、日付を表示するコントロールを WebPartZone2 から WebPartZone1 にドラッグした後です。Web パーツ ページでの表示モードの変更の詳細については、「チュートリアル : Web パーツ ページでの表示モードの変更」を参照してください。

Visual Basic

<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>

C#

<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>

プラットフォーム

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

参照

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