CatalogZone Classe

Definizione

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

Ereditarietà

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

CatalogZoneBase

CatalogZone

Esempio

Nell'esempio di codice seguente viene illustrato l'uso dichiarativo e programmatico del CatalogZone controllo . L'esempio di codice ha quattro parti:

• Controllo utente che consente di modificare le modalità di visualizzazione nella pagina Web.

• Un file con il codice sorgente per un controllo personalizzato CatalogZone e un controllo personalizzato WebPart importato dal catalogo e aggiunto alla pagina Web.

• Pagina Web che dichiara il controllo utente e il controllo personalizzato CatalogZone .

• Spiegazione di come eseguire l'esempio.

La prima parte di questo esempio di codice è il controllo utente che consente agli utenti di modificare le modalità di visualizzazione in una pagina Web. Per informazioni dettagliate sulle modalità di visualizzazione e una descrizione del codice sorgente in questo controllo, vedere Procedura dettagliata: Modifica delle modalità di visualizzazione in una pagina Web part.

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

La seconda parte dell'esempio di codice contiene il codice per i controlli e WebPart personalizzatiCatalogZone. Il codice per il CatalogZone controllo illustra come ereditare dalla CatalogZone classe e personalizzarne le proprietà impostando alcuni valori di proprietà predefiniti nel costruttore. Il codice sorgente illustra anche come creare una classe personalizzata denominata WebPartTextDisplayWebPart. Si tratta del controllo associato all'oggetto . File di descrizione webpart che verrà importato come parte di questo esempio di codice. Dopo aver importato il file di descrizione usando il ImportCatalogPart controllo nella pagina Web, sarà possibile aggiungere il TextDisplayWebPart controllo alla pagina, completamente preconfigurato come specificato nel file di descrizione.

Per eseguire l'esempio di codice, è necessario compilare questo codice sorgente. È possibile compilarlo in modo esplicito e inserire l'assembly risultante nella cartella Bin del sito Web o nella Global Assembly Cache. In alternativa, è possibile inserire il codice sorgente nella cartella App_Code del sito, in cui verrà compilato in modo dinamico in fase di esecuzione. In questo esempio di codice viene usata la compilazione dinamica, quindi se si vuole eseguire l'esempio in questo modo, denominare il file del codice sorgente e aggiungerlo a una sottocartella App_Code della directory radice dell'applicazione Web. Per una procedura dettagliata che illustra entrambi i metodi di compilazione, vedere Procedura dettagliata: Sviluppo e uso di un controllo server Web personalizzato.

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

La terza parte dell'esempio di codice è la pagina Web che contiene i controlli. Contiene una Register direttiva per il controllo utente e un'altra per il file di origine con i controlli personalizzati. Si noti che nella seconda direttiva non viene assegnato un nome all'assembly, poiché l'esempio non usa un assembly, usa la compilazione dinamica con il codice sorgente inserito nella sottocartella App_Code. La pagina Web dichiara un WebPartZone controllo e, all'interno dell'elemento figlio <zonetemplate> , dichiara un BulletedList controllo . Anche se si tratta di un controllo ASP.NET standard, avrà funzionalità web part complete in fase di esecuzione, perché il controllo esegue il WebPartManager wrapping di qualsiasi controllo server posizionato in un WebPartZone oggetto GenericWebPart , in modo che altri controlli server possano partecipare alle applicazioni Web part. Dichiarato anche in questa zona è il controllo personalizzato WebPart denominato TextDisplayWebPart. Si noti che per questo controllo è stato dichiarato un attributo ExportMode="All" . In questo modo è possibile esportare un oggetto . File di descrizione webpart contenente i valori delle proprietà del controllo, che possono essere importati da altri utenti per aggiungere il controllo preconfigurato ad altre pagine Web.

La pagina Web dichiara anche il controllo personalizzato CatalogZone e, all'interno di esso, un <zonetemplate> elemento che contiene un ImportCatalogPart controllo . L'utente userà questo controllo in fase di esecuzione per importare . File di descrizione webpart per il controllo personalizzato 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>

Eseguire ora l'esempio di codice. Caricare la pagina Web in un browser. Il primo passaggio consiste nell'esportare un oggetto . File di descrizione webpart per il TextDisplayWebPart controllo. Fare clic sul menu dei verbi nel controllo personalizzato (rappresentato dalla freccia verso il basso nella barra del titolo) e fare clic su Esporta. Seguire le istruzioni per salvare un file di descrizione per il controllo . Aprire . File di descrizione webpart in un editor e modificare il valore del testo della proprietà titolo. Trovare l'elemento <property> con l'attributo name="Title"e modificare il testo del titolo contenuto tra i tag di apertura e chiusura <property> . Chiudere ora la pagina Web e modificare l'origine della pagina in un editor. Eliminare l'elemento di dichiarazione del <aspSample:TextDisplayWebPart> controllo, quindi salvare e chiudere il file.

Caricare di nuovo la pagina Web in un browser. Il TextDisplayWebPart controllo non dovrebbe essere visualizzato perché è stato rimosso. Usare il controllo elenco a discesa Modalità di visualizzazione e selezionare Catalogo per passare alla modalità catalogo. Si noti che viene visualizzato il controllo personalizzato CatalogZone , insieme al ImportCatalogPart controllo . Fare clic sul pulsante Sfoglia per individuare . File di descrizione webpart esportato per il TextDisplayWebPart controllo. È possibile fare clic su Carica, selezionare la casella di controllo accanto al controllo importato e fare clic su Aggiungi per aggiungerla alla pagina. Fare clic su Chiudi catalogo per restituire la pagina alla modalità di esplorazione normale. Il controllo importato dovrebbe ora essere visualizzato nella pagina e il titolo visualizzato nella barra del titolo del controllo deve essere il testo del titolo aggiunto a . File di descrizione webpart.

Commenti

All'interno del set di controlli Web part, una zona è un'area in una pagina Web che contiene controlli Web part. Un'area Web part viene creata da un controllo zona, che è un tipo di CompositeControl progettato per contenere altri controlli. Le funzioni principali di una zona devono disporre i controlli contenuti e fornire un'interfaccia utente comune per tali controlli. Per informazioni generali sulle zone e sul modo in cui vengono usati nelle applicazioni Web part, vedere la classe di base WebZone e Panoramica del set di controlli web part.

Una funzionalità chiave dei controlli Web part è che consentono agli utenti finali di modificare (o personalizzare) pagine Web in base alle proprie preferenze e salvare le impostazioni personalizzate per le sessioni del browser future. Un aspetto della modifica delle pagine web part include la possibilità di aggiungere WebPart controlli o altri controlli server a una pagina web part. Il CatalogZone controllo fornisce un elenco o un catalogo di controlli che gli utenti possono aggiungere a una pagina.

Il CatalogZone controllo è uno dei controlli fondamentali nel set di controlli Web part. Deriva dalla CatalogZoneBase classe e la maggior parte del relativo comportamento viene ereditata da tale classe. La CatalogZone classe aggiunge essenzialmente alla classe base un modello di zona, ovvero un'implementazione dell'interfaccia ITemplate . Il modello di zona consente agli sviluppatori di aggiungere CatalogPart in modo dichiarativo i controlli a una zona nel formato di persistenza della pagina.

Un CatalogZone controllo diventa visibile solo quando un utente passa una pagina Web alla modalità di visualizzazione del catalogo (CatalogDisplayMode). Un catalogo può contenere diversi tipi di CatalogPart controlli. Ogni CatalogPart controllo è un tipo di contenitore contenente i controlli server che gli utenti possono aggiungere alla pagina. I CatalogPart controlli differiscono in base al luogo in cui provengono i controlli del server. La tabella seguente riepiloga i CatalogPart controlli forniti con il set di controlli Web part e, per ogni controllo, quale tipo di controlli server contiene.

Poiché la CatalogZone classe aggiunge solo un modello di zona al comportamento della classe di base, ha pochi membri. Il CatalogZone costruttore è un costruttore senza parametri, con esso è possibile inizializzare una nuova istanza della CatalogZone classe. La ZoneTemplate proprietà ottiene o imposta un riferimento all'oggetto ITemplate contenente i controlli per la zona. Il CreateCatalogParts metodo è fondamentale. Esegue l'override del metodo di base per creare la raccolta di tutti i CatalogPart controlli contenuti nel modello di zona.

Accessibilità

Il markup eseguito per impostazione predefinita per questo controllo potrebbe non essere conforme agli standard di accessibilità, ad esempio le linee guida per l'accessibilità del contenuto Web 1.0 (WCAG). Per informazioni dettagliate sul supporto dell'accessibilità per questo controllo, vedere Controlli e accessibilità ASP.NET.

Note per gli eredi

È possibile creare classi personalizzate CatalogZone se si vuole un maggiore controllo sul rendering e sul comportamento dell'interfaccia utente del catalogo. Se non è necessario fornire agli utenti del controllo la possibilità di aggiungere CatalogPart controlli in modo dichiarativo, è possibile ereditare direttamente dalla CatalogZoneBase classe . Se si vuole abilitare l'aggiunta dichiarativa dei controlli, l'approccio semplice consiste nell'ereditare dalla CatalogZone classe , perché fornisce il modello di zona essenziale.

Se si eredita dalla CatalogZone classe , è possibile eseguire l'override del CreateCatalogParts() metodo e usare il metodo per aggiungere controlli personalizzati CatalogPart a un CatalogPartCollectionoggetto , se si vuole un maggiore controllo programmatico sull'aggiunta di controlli personalizzati CatalogPart alla zona.

Costruttori

Proprietà

Metodi

Eventi

Implementazioni dell'interfaccia esplicita

Metodi di estensione

Si applica a

Vedi anche

• CatalogPart
• Panoramica del set di controlli web part
• Panoramica della personalizzazione delle web part
• ASP.NET controlli web part