CatalogZone Klas

Definitie

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

Overname

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

CatalogZoneBase

CatalogZone

Voorbeelden

In het volgende codevoorbeeld ziet u het declaratieve en programmatische gebruik van het CatalogZone besturingselement. Het codevoorbeeld heeft vier delen:

• Een gebruikersbeheer waarmee u weergavemodi op de webpagina kunt wijzigen.

• Een bestand met de broncode voor een aangepast besturingselement CatalogZone en een aangepast WebPart besturingselement dat door de catalogus wordt geïmporteerd en aan de webpagina wordt toegevoegd.

• Een webpagina die het gebruikersbeheer en het aangepaste CatalogZone besturingselement declareert.

• Een uitleg over het uitvoeren van het voorbeeld.

Het eerste deel van dit codevoorbeeld is het gebruikersbeheer waarmee gebruikers weergavemodi op een webpagina kunnen wijzigen. Zie Overzicht: Weergavemodi wijzigen op een pagina met webonderdelen voor meer informatie over weergavemodi en een beschrijving van de broncode in dit besturingselement.

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

Het tweede deel van het codevoorbeeld bevat de code voor de aangepaste CatalogZone en WebPart besturingselementen. De code voor het CatalogZone besturingselement laat zien hoe u de eigenschappen van de CatalogZone klasse overneemt en de eigenschappen ervan aanpast door een aantal standaardeigenschapswaarden in de constructor in te stellen. De broncode laat ook zien hoe u een aangepaste WebPart klasse maakt met de naam TextDisplayWebPart. Dit is het besturingselement dat is gekoppeld aan de . Beschrijvingsbestand van webonderdelen dat u gaat importeren als onderdeel van dit codevoorbeeld. Nadat u het beschrijvingsbestand hebt geïmporteerd met behulp van het ImportCatalogPart besturingselement op de webpagina, kunt u het TextDisplayWebPart besturingselement toevoegen aan de pagina, volledig vooraf geconfigureerd zoals opgegeven in het beschrijvingsbestand.

Als u het codevoorbeeld wilt uitvoeren, moet u deze broncode compileren. U kunt deze expliciet compileren en de resulterende assembly in de map Bin van uw website of de globale assemblycache plaatsen. U kunt de broncode ook in de map App_Code van uw site plaatsen, waar deze dynamisch wordt gecompileerd tijdens runtime. In dit codevoorbeeld wordt dynamische compilatie gebruikt, dus als u het voorbeeld op deze manier wilt uitvoeren, noemt u het broncodebestand en voegt u het toe aan een App_Code submap van de hoofdmap van uw webtoepassing. Zie Walkthrough: Een aangepast webserverbeheer ontwikkelen en gebruiken voor een overzicht van beide methoden voor het compileren.

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

Het derde deel van het codevoorbeeld is de webpagina die de besturingselementen bevat. Het bevat een Register instructie voor het gebruikersbesturingselement en een andere voor het bronbestand met de aangepaste besturingselementen. Houd er rekening mee dat in de tweede instructie de assembly geen naam krijgt, omdat in het voorbeeld geen assembly wordt gebruikt, wordt dynamische compilatie gebruikt met de broncode die in de submap App_Code is geplaatst. De webpagina declareert een WebPartZone besturingselement en binnen het onderliggende <zonetemplate> element wordt een BulletedList besturingselement declareren. Hoewel dit een standaardbesturingselement ASP.NET is, heeft het volledige functionaliteit voor webonderdelen tijdens runtime, omdat het besturingselement WebPartManager alle serverbesturingselementen in een WebPartZone met een GenericWebPart-object verpakt, zodat andere serverbesturingselementen kunnen deelnemen aan webonderdelentoepassingen. Ook gedeclareerd in deze zone is het aangepaste WebPart besturingselement met de naam TextDisplayWebPart. U ziet dat dit besturingselement een kenmerk heeft dat ExportMode="All" erop is gedeclareerd. Hiermee kunt u een . Beschrijvingsbestand van webonderdeel dat de eigenschapswaarden van het besturingselement bevat, die door andere gebruikers kunnen worden geïmporteerd om het vooraf geconfigureerde besturingselement toe te voegen aan andere webpagina's.

De webpagina declareert ook het aangepaste CatalogZone besturingselement en daarin een element dat een <zonetemplate>ImportCatalogPart besturingselement bevat. De gebruiker gebruikt dit besturingselement tijdens runtime om het te importeren. Beschrijvingsbestand van webonderdelen voor het aangepaste WebPart besturingselement.

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

Voer nu het codevoorbeeld uit. Laad de webpagina in een browser. De eerste stap is het exporteren van een . Beschrijvingsbestand van webonderdeel voor het TextDisplayWebPart besturingselement. Klik op het menu Werkwoorden in het aangepaste besturingselement (vertegenwoordigd door de pijl-omlaag in de titelbalk) en klik op Exporteren. Volg de instructies om een beschrijvingsbestand voor het besturingselement op te slaan. Open het . Beschrijvingsbestand van webonderdelen in een editor en bewerk de waarde van de tekst van de titeleigenschap. Zoek het <property> element met het kenmerk name="Title"en bewerk de titeltekst tussen de openings- en afsluittags <property> . Sluit nu de webpagina en bewerk de paginabron in een editor. Verwijder het declaratie-element van het <aspSample:TextDisplayWebPart> besturingselement en sla het bestand op en sluit het.

Laad de webpagina opnieuw in een browser. Het TextDisplayWebPart besturingselement mag niet worden weergegeven omdat u het hebt verwijderd. Gebruik het besturingselement voor de vervolgkeuzelijst Weergavemodus en selecteer Catalogus om de pagina over te schakelen naar de catalogusmodus. U ziet dat het aangepaste CatalogZone besturingselement wordt weergegeven, samen met het ImportCatalogPart besturingselement. Klik op de knop Bladeren om de knop te zoeken. Beschrijvingsbestand van webonderdeel dat u voor het TextDisplayWebPart besturingselement hebt geëxporteerd. U kunt op Uploaden klikken, het selectievakje naast het geïmporteerde besturingselement inschakelen en op Toevoegen klikken om het toe te voegen aan de pagina. Klik op Catalogus sluiten om de pagina terug te keren naar de normale bladermodus. Het geïmporteerde besturingselement moet nu worden weergegeven op de pagina en de titel die op de titelbalk van het besturingselement wordt weergegeven, moet de titeltekst zijn die u aan het besturingselement hebt toegevoegd. Beschrijvingsbestand van webonderdeel.

Opmerkingen

Binnen de besturingsset webonderdelen is een zone een regio op een webpagina met besturingselementen voor webonderdelen. Een webonderdelenzone wordt gemaakt door een zonebesturingselement. Dit is een type CompositeControl dat is ontworpen om andere besturingselementen te bevatten. De primaire functies van een zone zijn om de besturingselementen in te delen die deze bevat en om een gemeenschappelijke gebruikersinterface (UI) te bieden voor deze besturingselementen. Zie de basisklasse WebZone en overzicht van set webonderdelen voor algemene informatie over zones en hoe ze worden gebruikt in webonderdelentoepassingen.

Een belangrijke functie van besturingselementen voor webonderdelen is dat eindgebruikers webpagina's kunnen wijzigen (of personaliseren) op basis van hun voorkeuren en hun persoonlijke instellingen kunnen opslaan voor toekomstige browsersessies. Een aspect van het wijzigen van pagina's met webonderdelen omvat de mogelijkheid om besturingselementen of andere serverbesturingselementen toe te voegen WebPart aan een pagina met webonderdelen. Het CatalogZone besturingselement bevat een lijst of catalogus met besturingselementen die gebruikers aan een pagina kunnen toevoegen.

Het CatalogZone besturingselement is een van de fundamentele besturingselementen in de besturingsset webonderdelen. Het is afgeleid van de CatalogZoneBase klasse en het grootste deel van het gedrag ervan wordt overgenomen van die klasse. De CatalogZone klasse voegt in wezen toe aan de basisklasse een zonesjabloon, een implementatie van de ITemplate interface. Met de zonesjabloon kunnen ontwikkelaars declaratief besturingselementen toevoegen CatalogPart aan een zone in de indeling voor paginapersistentie.

Een CatalogZone besturingselement wordt alleen zichtbaar wanneer een gebruiker een webpagina overschakelt naar de catalogusweergavemodus (CatalogDisplayMode). Een catalogus kan verschillende typen CatalogPart besturingselementen bevatten. Elk CatalogPart besturingselement is een type container dat de serverbesturingselementen bevat die gebruikers aan de pagina kunnen toevoegen. De CatalogPart besturingselementen verschillen afhankelijk van waar de serverbesturingselementen vandaan komen. De volgende tabel bevat een overzicht van de CatalogPart besturingselementen die worden geleverd met de set webonderdelen en voor elk besturingselement welk type server het bevat.

Omdat de CatalogZone klasse slechts een zonesjabloon toevoegt aan het gedrag van de basisklasse, heeft deze weinig leden. De CatalogZone constructor is een parameterloze constructor. Hiermee kunt u een nieuw exemplaar van de CatalogZone klasse initialiseren. Met ZoneTemplate de eigenschap wordt een verwijzing naar het ITemplate object opgehaald of ingesteld dat de besturingselementen voor de zone bevat. De CreateCatalogParts methode is kritiek. De basismethode wordt overschreven om de verzameling van alle CatalogPart besturingselementen in de zonesjabloon te maken.

Toegankelijkheid

De standaard weergegeven markeringen voor dit besturingselement voldoen mogelijk niet aan toegankelijkheidsstandaarden zoals de wcAG-richtlijnen (Web Content Accessibility Guidelines 1.0) prioriteit 1. Zie ASP.NET Besturingselementen en toegankelijkheid voor meer informatie over toegankelijkheidsondersteuning voor dit besturingselement.

Notities voor overnemers

U kunt aangepaste CatalogZone klassen maken als u meer controle wilt over de weergave en het gedrag van de catalogusgebruikersinterface. Als u gebruikers van uw besturingselement niet de mogelijkheid hoeft te bieden om besturingselementen declaratief toe te voegen CatalogPart , kunt u deze rechtstreeks overnemen van de CatalogZoneBase klasse. Als u wel wilt inschakelen dat besturingselementen declaratief worden toegevoegd, is de eenvoudige benadering om over te nemen van de CatalogZone klasse, omdat deze de essentiële zonesjabloon biedt.

Als u de klasse overschrijft CatalogZone , kunt u de CreateCatalogParts() methode overschrijven en de methode gebruiken om aangepaste CatalogPart besturingselementen toe te voegen aan een CatalogPartCollection, als u meer programmatisch beheer wilt over het toevoegen van aangepaste CatalogPart besturingselementen aan uw zone.

Zie ook

• CatalogPart
• Overzicht van set webonderdelen
• Overzicht van persoonlijke instellingen voor webonderdelen
• ASP.NET besturingselementen voor webonderdelen