CatalogZoneBase.EmptyZoneText プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

CatalogZoneBase.EmptyZoneText プロパティ

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

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

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

Visual Basic (宣言)

Public Overrides Property
 EmptyZoneText As String

Visual Basic (使用法)

Dim instance As CatalogZoneBase
Dim value As String

value = instance.EmptyZoneText

instance.EmptyZoneText = value

public override string EmptyZoneText { get;
 set; }

C++

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

/** @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 プロパティの文字列値は、CatalogZoneBase ゾーンに CatalogPart コントロールが格納されていない場合に Web ページがカタログモードになると表示されます。

使用例

宣言によって EmptyZoneText プロパティを使用する方法を示すコード例を次に示します。例の実行に必要なコード全体については、CatalogZoneBase クラスの概要で「例」を参照してください。

コード例では 2 つの <asp:catalogzone> 要素を宣言しています。2 つ目の要素は、EmptyZoneText プロパティに値を代入していますが、CatalogPart コントロールは宣言していません。

Visual Basic

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode."
 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1"
 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server"
 
          title="My Calendar" />              
 
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1"
 runat="server" />
    <asp:ImportCatalogPart ID="ImportCatalogPart1"
 runat="server" /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />

<asp:CatalogZone ID="CatalogZone1" runat="server"
  EmptyZoneText="No controls are in the zone."
  HeaderText="My Web Parts Catalog"
  InstructionText="Add Web Parts controls to the zone."
  PartLinkStyle-Font-Italic="true"
  SelectedPartLinkStyle-Font-Bold="true"
  SelectTargetZoneText="Select zone"
  AddVerb-Text="Add Control"
  CloseVerb-Description="Close and return to browse mode."
 
  SelectedCatalogPartID="Currently Selected CatalogPart ID.">
  <ZoneTemplate>
    <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
      runat="server">
      <WebPartsTemplate>
        <aspSample:TextDisplayWebPart 
          runat="server"   
          id="textwebpart" 
          title = "Text Content WebPart" 
          ExportMode="All"/>  
        <asp:Calendar id="calendar1" runat="server" 
          title="My Calendar" />               
      </WebPartsTemplate>
    </asp:DeclarativeCatalogPart> 
    <asp:PageCatalogPart ID="PageCatalogPart1" runat="server"
 />
    <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server"
 /> 
  </ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:CatalogZone ID="CatalogZone2" runat="server"
  BorderWidth="2"
  HeaderText="My Empty CatalogZone"
  EmptyZoneText="No controls are in the zone." />