CatalogZone クラス

定義

public ref class CatalogZone : System::Web::UI::WebControls::WebParts::CatalogZoneBase

public class CatalogZone : System.Web.UI.WebControls.WebParts.CatalogZoneBase

type CatalogZone = class
    inherit CatalogZoneBase

Public Class CatalogZone
Inherits CatalogZoneBase

継承

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

CatalogZoneBase

CatalogZone

例

次のコード例は、 コントロールの宣言型およびプログラムによる使用を CatalogZone 示しています。 このコード例には、次の 4 つの部分があります。

• Web ページの表示モードを変更できるユーザー コントロール。

• カスタム CatalogZone コントロールのソース コードと、カタログによってインポートされ Web ページに追加されるカスタム WebPart コントロールを含むファイル。

• ユーザー コントロールとカスタム CatalogZone コントロールを宣言する Web ページ。

• 例を実行する方法の説明。

このコード例の最初の部分は、ユーザーが Web ページの表示モードを変更できるようにするユーザー コントロールです。 このコントロールの表示モードとソース コードの説明の詳細については、「 チュートリアル: Web パーツ ページでの表示モードの変更」を参照してください。

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }
    
  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' If shared scope is allowed for this user, display the scope-switching
    ' UI and select the appropriate radio button for the current user scope.
    If _manager.Personalization.CanEnterSharedScope Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

コード例の 2 番目の部分には、カスタム CatalogZone コントロールと WebPart コントロールのコードが含まれています。 コントロールのコードは、 CatalogZone クラスから継承し、コンストラクターで既定の CatalogZone プロパティ値を設定してそのプロパティをカスタマイズする方法を示しています。 ソース コードでは、 という名前TextDisplayWebPartのカスタム WebPart クラスを作成する方法も示されています。 これは、 に関連付けられているコントロールです。このコード例の一部としてインポートする WebPart 記述ファイル。 Web ページの コントロールを使用して説明ファイルを ImportCatalogPart インポートすると、説明ファイルで指定されているように完全に事前構成されたコントロールをページに追加 TextDisplayWebPart できるようになります。

コード例を実行するには、このソース コードをコンパイルする必要があります。 明示的にコンパイルし、結果のアセンブリを Web サイトの Bin フォルダーまたはグローバル アセンブリ キャッシュに配置できます。 または、ソース コードをサイトの App_Code フォルダーに配置して、実行時に動的にコンパイルすることもできます。 このコード例では動的コンパイルを使用するため、この例をこのように実行する場合は、ソース コード ファイルに名前を付けて、Web アプリケーションのルート ディレクトリのApp_Codeサブフォルダーに追加します。 両方のコンパイル方法を示すチュートリアルについては、「 チュートリアル: カスタム Web サーバー コントロールの開発と使用」を参照してください。

using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  // Create a customized CatalogZone control by setting 
  // some properties in the constructor.
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class MyCatalogZone : CatalogZone
  {
    public MyCatalogZone()
    {
      this.HeaderText = "My Company Catalog";
      this.HeaderCloseVerb.Text = "Close Catalog";
      this.CloseVerb.Text = "Close Catalog";
    }
  }

  // Create a custom WebPart control to add to a WebPartZone.
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;
    Literal lineBreak;

    [Personalizable(), WebBrowsable]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);

      lineBreak = new Literal();
      lineBreak.Text = @"<br />";
      Controls.Add(lineBreak);

      input = new TextBox();
      this.Controls.Add(input);
      Button update = new Button();
      update.Text = "Set Label Content";
      update.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(update);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (!string.IsNullOrEmpty(input.Text))
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.Drawing
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  ' Create a custom CatalogZone control by setting some 
  ' properties in the constructor.
  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class MyCatalogZone
    Inherits CatalogZone

    Public Sub New()
      Me.HeaderText = "My Company Catalog"
      Me.HeaderCloseVerb.Text = "Close Catalog"
      Me.CloseVerb.Text = "Close Catalog"
    End Sub

  End Class


  ' Create a custom WebPart to add to a WebPartZone.
  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class TextDisplayWebPart
    Inherits WebPart
    Private _contentText As String = Nothing
    Private _fontStyle As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    Private lineBreak As Literal

    <Personalizable(), WebBrowsable()> _
    Public Property ContentText() As String
      Get
        Return _contentText
      End Get
      Set(ByVal value As String)
        _contentText = value
      End Set
    End Property

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      DisplayContent.BackColor = Color.LightBlue
      DisplayContent.Text = Me.ContentText
      Me.Controls.Add(DisplayContent)

      lineBreak = New Literal()
      lineBreak.Text = "<br />"
      Controls.Add(lineBreak)

      input = New TextBox()
      Me.Controls.Add(input)
      Dim update As New Button()
      update.Text = "Set Label Content"
      AddHandler update.Click, AddressOf Me.submit_Click
      Me.Controls.Add(update)

    End Sub

    Private Sub submit_Click(ByVal sender As Object, _
                             ByVal e As EventArgs)
      ' Update the label string.
      If input.Text <> String.Empty Then
        _contentText = input.Text + "<br />"
        input.Text = String.Empty
        DisplayContent.Text = Me.ContentText
      End If

    End Sub

  End Class

End Namespace

コード例の 3 番目の部分は、 コントロールを含む Web ページです。 これには、 Register ユーザー コントロールの ディレクティブと、カスタム コントロールを含むソース ファイル用の ディレクティブが含まれています。 2 番目のディレクティブではアセンブリに名前を付けないため、この例ではアセンブリを使用しないため、App_Code サブフォルダーに配置されたソース コードを使用して動的コンパイルを使用します。 Web ページはコントロールを WebPartZone 宣言し、その子 <zonetemplate> 要素内でコントロールを BulletedList 宣言します。 これは標準の ASP.NET コントロールですが、コントロールは に配置されたサーバー コントロールを オブジェクトと共GenericWebPartにWebPartZoneラップするためWebPartManager、実行時に完全な Web パーツ機能を持ちます。これにより、他のサーバー コントロールが Web パーツ アプリケーションに参加できるようになります。 また、このゾーンで宣言されているのは、 という名前TextDisplayWebPartのカスタム WebPart コントロールです。 このコントロールには、 の属性 ExportMode="All" が宣言されていることに注意してください。 これにより、 をエクスポートできます。コントロールのプロパティ値を含む WebPart 記述ファイル。他のユーザーがインポートして、事前に構成されたコントロールを他の Web ページに追加できます。

Web ページでは、カスタム CatalogZone コントロールと、その中にコントロールを <zonetemplate> 含む ImportCatalogPart 要素も宣言されます。 ユーザーは、実行時にこのコントロールを使用して をインポートします。カスタム WebPart コントロールの WebPart 記述ファイル。

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ Register TagPrefix="aspSample"
  Namespace="Samples.AspNet.CS.Controls" %> 
  
<!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 runat="server">
    <title>Untitled Page</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:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <aspsample:textdisplaywebpart id="wp1" runat="server" 
           Title="My Text Display WebPart" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
        <asp:ImportCatalogPart id="ImportCatalogPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
  </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ Register TagPrefix="aspSample"
  Namespace="Samples.AspNet.VB.Controls"  %> 

<!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 runat="server">
    <title>Untitled Page</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:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <aspsample:textdisplaywebpart id="wp1" runat="server" 
           Title="My Text Display WebPart" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
        <asp:ImportCatalogPart id="ImportCatalogPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
  </form>
</body>
</html>

次に、コード例を実行します。 ブラウザーで Web ページを読み込みます。 最初の手順では、 をエクスポートします。コントロールの TextDisplayWebPart WebPart 記述ファイル。 (タイトル バーの下向き矢印で表される) カスタム コントロールの動詞メニューをクリックし、[ エクスポート] をクリックします。 指示に従って、コントロールの説明ファイルを保存します。 を開きます。エディターの WebPart 説明ファイルを使用して、タイトル プロパティテキストの値を編集します。 属性 name="Title"を<property>持つ 要素を検索し、開始タグと終了<property>タグの間に含まれるタイトル テキストを編集します。 次に、Web ページを閉じ、エディターでページ ソースを編集します。 コントロール宣言要素を <aspSample:TextDisplayWebPart> 削除し、ファイルを保存して閉じます。

ブラウザーで Web ページをもう一度読み込みます。 コントロールを TextDisplayWebPart 削除したため、コントロールは表示されません。 [表示モード] ドロップダウン リスト コントロールを使用し、[カタログ] を選択してページをカタログ モードに切り替えます。 コントロールとImportCatalogPart共にカスタム CatalogZone コントロールが表示されます。 [ 参照 ] ボタンをクリックして、 を見つけます。コントロール用 TextDisplayWebPart にエクスポートした WebPart 記述ファイル。 [ アップロード] をクリックし、インポートしたコントロールの横にあるチェック ボックスをオンにし、[ 追加 ] をクリックしてページに追加できます。 [ カタログを閉じる ] をクリックして、ページを通常のブラウズ モードに戻します。 インポートしたコントロールがページに表示され、コントロールのタイトル バーに表示されるタイトルは、 に追加したタイトル テキストである必要があります。WebPart の説明ファイル。

注釈

Web パーツ コントロール セット内では、ゾーンは Web パーツ コントロールを含む Web ページ上の領域です。 Web パーツ ゾーンは、他のコントロールを格納するように設計された の CompositeControl 一種であるゾーン コントロールによって作成されます。 ゾーンの主な機能は、ゾーンに含まれるコントロールをレイアウトし、それらのコントロールに共通のユーザー インターフェイス (UI) を提供することです。 ゾーンと Web パーツ アプリケーションでのゾーンの使用方法に関する一般的な情報については、基本 WebZone クラスと Web パーツ コントロール セットの概要に関するページを参照してください。

Web パーツ コントロールの主な機能は、エンド ユーザーが設定に従って Web ページを変更 (またはカスタマイズ) し、今後のブラウザー セッション用にカスタマイズした設定を保存できるようにすることです。 Web パーツ ページを変更する 1 つの側面には、コントロールまたは他のサーバー コントロールを Web パーツ ページに追加 WebPart する機能があります。 コントロールは CatalogZone 、ユーザーがページに追加できるコントロールのリストまたはカタログを提供します。

コントロールは CatalogZone 、Web パーツ コントロール セットの基本的なコントロールの 1 つです。 クラスから CatalogZoneBase 派生し、その動作のほとんどはそのクラスから継承されます。 クラスは CatalogZone 基本的に、インターフェイスの実装であるゾーン テンプレートを基底クラスに ITemplate 追加します。 ゾーン テンプレートを使用すると、開発者はページ永続化形式でゾーンにコントロールを宣言的に追加 CatalogPart できます。

コントロールは CatalogZone 、ユーザーが Web ページをカタログ表示モード (CatalogDisplayMode) に切り替えた場合にのみ表示されます。 カタログには、いくつかの種類の CatalogPart コントロールを含めることができます。 各 CatalogPart コントロールは、ユーザーがページに追加できるサーバー コントロールを含むコンテナーの一種です。 コントロールは CatalogPart 、コントロールに含まれるサーバー コントロールの取得元によって異なります。 次の表は、 CatalogPart Web パーツ コントロール セットに用意されているコントロールと、各コントロールに含まれるサーバー コントロールの種類をまとめたものです。

クラスは基本クラスの CatalogZone 動作にゾーン テンプレートのみを追加するため、メンバーはほとんどありません。 コンストラクターは CatalogZone パラメーターなしのコンストラクターです。これを使用すると、 クラスの新しいインスタンスを CatalogZone 初期化できます。 プロパティは ZoneTemplate 、ゾーンのコントロールを ITemplate 含むオブジェクトへの参照を取得または設定します。 メソッドは CreateCatalogParts 重要です。 基本メソッドをオーバーライドして、ゾーン テンプレートに含まれるすべての CatalogPart コントロールのコレクションを作成します。

ユーザー補助

このコントロールに対して既定でレンダリングされるマークアップは、Web コンテンツ アクセシビリティ ガイドライン 1.0 (WCAG) 優先度 1 のガイドラインなどのアクセシビリティ標準に準拠していない可能性があります。 このコントロールのアクセシビリティサポートの詳細については、「 ASP.NET コントロールとアクセシビリティ」を参照してください。

注意 (継承者)

カタログ UI のレンダリングと動作をより詳細に制御する場合は、カスタム CatalogZone クラスを作成できます。 コントロールのユーザーに宣言的にコントロールを追加 CatalogPart する機能を提供する必要がない場合は、 クラスから CatalogZoneBase 直接継承できます。 コントロールを宣言的に追加できるようにする場合、単純な方法は、重要なゾーン テンプレートを提供するため、 クラスから CatalogZone 継承することです。

クラスから継承する CatalogZone 場合は、 メソッドを CreateCatalogParts() オーバーライドし、 メソッドを使用して カスタム CatalogPart コントロールを に追加できます。カスタム コントロールをゾーンに CatalogPartCollection追加 CatalogPart するプログラムによる制御を強化する場合は、 を使用します。

コンストラクター

プロパティ

メソッド

イベント

明示的なインターフェイスの実装

拡張メソッド

適用対象

こちらもご覧ください

• CatalogPart
• Web パーツ コントロール セットの概要
• Web パーツのパーソナル化の概要
• ASP.NET Web パーツ コントロール