CatalogZoneBase.SelectTargetZoneText プロパティ

定義

名前空間:

System.Web.UI.WebControls.WebParts

アセンブリ:

System.Web.dll

選択したコントロールの追加先のゾーンをユーザーが選択できるカタログ ユーザー インターフェイス (UI) で、コントロールの横に表示されるテキストを取得または設定します。

public:
 virtual property System::String ^ SelectTargetZoneText { System::String ^ get(); void set(System::String ^ value); };

public virtual string SelectTargetZoneText { get; set; }

member this.SelectTargetZoneText : string with get, set

Public Overridable Property SelectTargetZoneText As String

プロパティ値

String

ゾーン選択コントロールの横に表示するテキストを含む文字列。 カルチャ固有の既定の文字列は、.NET Framework によって提供されます。

例

次のコード例では、 プロパティを宣言的およびプログラム的に使用 SelectTargetZoneText する方法を示します。 この例を実行するために必要な完全なコードについては、クラスの概要の「例」セクションを CatalogZoneBase 参照してください。

コード例の最初の部分では 2 つの <asp:catalogzone> 要素が宣言され、最初の部分では プロパティの値が宣言されていることに SelectTargetZoneText 注意してください。

<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." />

コード例の 2 番目の部分では、 プロパティの値が SelectTargetZoneText プログラムによって変更されます。

protected void Button3_Click(object sender, EventArgs e)
{
  CatalogZone1.SelectTargetZoneText = "Add to zone";
  CatalogZone1.EmptyZoneText = "Zone is empty";
  CatalogZone1.HeaderText = "My Updated Header";
  CatalogZone1.InstructionText = "My Updated Instructions";
}

Protected Sub Button3_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
  CatalogZone1.SelectTargetZoneText = "Add to zone"
  CatalogZone1.EmptyZoneText = "Zone is empty"
  CatalogZone1.HeaderText = "My Updated Header"
  CatalogZone1.InstructionText = "My Updated Instructions"
End Sub

ブラウザーでページを読み込むと、ドロップダウン リストから [ カタログ ] を選択してカタログ表示モードに切り替えることができます。 カタログが表示されたら、カタログのフッターにコントロールと共 DropDownList に表示されるテキストをメモします。 [ Set Zone Text Properties]\(ゾーン テキスト プロパティの設定 \) ボタンをクリックすると、プロパティのテキスト値を変更できます。

注釈

カタログ UI が最初に表示されると、ユーザーは、 DeclarativeCatalogPartや Web ページにCatalogPart追加できる他のサーバー コントロールを含む WebPart などのコントロールのいずれかを選択できます。 ユーザーは 1 つ以上のコントロールを選択し、カタログの DropDownList フッター領域でコントロールを使用し、選択したサーバー コントロールを配置するページ上のコントロールを選択 WebPartZone できます。 プロパティの SelectTargetZoneText テキスト値は、コントロールと共に DropDownList 単純な命令として表示されます。

このプロパティの値を設定すると、デザイナー ツールを使用してリソース ファイルに自動的に保存できます。 詳細については、グローバリゼーションとローカライズに関するページを参照してくださいLocalizableAttribute。

こちらもご覧ください

• ASP.NET Web パーツ コントロール