CatalogZone Classe

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Funge da controllo primario nell'insieme di controlli web part per l'hosting dei controlli CatalogPart in una pagina Web.

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 include 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 e un controllo personalizzato CatalogZoneWebPart 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. Questo è il 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 configurato 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 dinamicamente in fase di esecuzione. Questo esempio di codice usa la compilazione dinamica, quindi se si vuole eseguire l'esempio in questo modo, assegnare un nome al file di 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 assegna 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. Sebbene si tratti di un controllo ASP.NET standard, le web part saranno complete in fase di esecuzione, perché il controllo esegue il WebPartManager wrapping di qualsiasi controllo server inserito 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 questo controllo ha un attributo di ExportMode="All" dichiarato su di esso. Ciò consente di 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.

Nota

Per consentire agli utenti di un'applicazione Web part di esportare un file di descrizione per WebPart i controlli, è necessario abilitare anche la funzionalità di esportazione nell'applicazione Web aggiungendo un enableExport="true" attributo all'elemento <webParts> (figlio dell'elemento <system.web> ) nel file Web.config. L'esportazione è disabilitata per impostazione predefinita, quindi se non è ancora stata abilitata l'esportazione per l'applicazione, modificare il file Web.config e farlo ora.

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 verbi sul 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 con l'attributo <property>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 dichiarazione di <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à 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 aggiungerlo 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 all'oggetto . 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. Una zona web part viene creata da un controllo zona, che è un tipo di CompositeControl progettato per contenere altri controlli. Le funzioni principali di una zona sono la disposizione dei controlli contenuti e per fornire un'interfaccia utente comune per tali controlli. Per informazioni generali sulle zone e su come vengono usate nelle applicazioni web part, vedere panoramica della classe di base WebZone e del set di controlli Web part.

Una funzionalità chiave dei controlli Web part è che consentono agli utenti finali di modificare (o personalizzare) le pagine Web in base alle proprie preferenze e di salvare le impostazioni personalizzate per le sessioni future del browser. 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 del 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, che è un'implementazione dell'interfaccia ITemplate . Il modello di zona consente agli sviluppatori di aggiungere CatalogPart in modo dichiarativo controlli a una zona nel formato di persistenza della pagina.

Importante

Una CatalogZone zona può contenere solo CatalogPart controlli e, viceversa, CatalogPart i controlli possono risiedere solo in zone che derivano dalla CatalogZoneBase classe , ad esempio CatalogZone.

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 che contiene i controlli server che gli utenti possono aggiungere alla pagina. I CatalogPart controlli differiscono in base al percorso da cui provengono i controlli server. Nella tabella seguente vengono riepilogati i CatalogPart controlli forniti con il set di controlli Web part e, per ogni controllo, il tipo di controlli server in esso contenuti.

Controllo	Descrizione
PageCatalogPart	Gestisce i riferimenti ai controlli chiusi in una pagina. Questi controlli possono essere riaperti (aggiunti di nuovo alla pagina) dagli utenti.
DeclarativeCatalogPart	Contiene riferimenti ai controlli dichiarati in un catalogo web part nel markup di una pagina Web. Questi controlli possono essere aggiunti a una pagina Web da parte degli utenti.
ImportCatalogPart	Fornisce l'interfaccia utente per consentire a un utente di caricare un file di definizione (un file XML con . Estensione WebPart e un formato specificato che contiene informazioni sullo stato) per un controllo in un catalogo, in modo che il controllo possa essere aggiunto a una pagina Web.

Poiché la CatalogZone classe aggiunge solo un modello di zona al comportamento della relativa classe 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 che contiene i controlli per la zona. Il CreateCatalogParts metodo è critico. Esegue l'override del metodo di base per creare la raccolta di tutti i CatalogPart controlli contenuti nel modello di zona.

Nota

I pulsanti nell'interfaccia CatalogZone utente richiedono script sul lato client per funzionare correttamente. Se lo scripting è disabilitato nel browser, l'utente non sarà in grado di eseguire azioni tramite l'interfaccia CatalogZone utente.

Accessibilità

Il markup sottoposto a rendering 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) con priorità 1. Per informazioni dettagliate sul supporto dell'accessibilità per questo controllo, vedere ASP.NET Controlli e accessibilità.

Note per gli eredi

È possibile creare classi personalizzate CatalogZone se si vuole più 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 dichiarativi, è possibile ereditare direttamente dalla CatalogZoneBase classe. Se si desidera abilitare i controlli da aggiungere in modo dichiarativo, l'approccio semplice consiste nell'ereditare dalla CatalogZone classe, perché fornisce il modello di zona essenziale.

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

Costruttori

CatalogZone()

Inizializza una nuova istanza della classe CatalogZone.

Proprietà

AccessKey	Ottiene o imposta il tasto di scelta che consente di accedere rapidamente al controllo server Web. (Ereditato da WebControl)
Adapter	Ottiene l'adattatore specifico del browser per il controllo. (Ereditato da Control)
AddVerb	Ottiene un riferimento a un oggetto WebPartVerb che consente agli utenti finali di aggiungere controlli da un catalogo a una pagina Web part. (Ereditato da CatalogZoneBase)
AppRelativeTemplateSourceDirectory	Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo. (Ereditato da Control)
AssociatedDisplayModes	Ottiene l'insieme di oggetti WebPartDisplayMode associati a una particolare zona ToolZone. (Ereditato da ToolZone)
Attributes	Ottiene l'insieme di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo. (Ereditato da WebControl)
BackColor	Ottiene o imposta il colore di sfondo del controllo server Web. (Ereditato da WebControl)
BackImageUrl	Ottiene o imposta l'URL di un'immagine di sfondo per una zona. (Ereditato da WebZone)
BindingContainer	Ottiene il controllo contenente l'associazione dati del controllo corrente. (Ereditato da Control)
BorderColor	Ottiene o imposta il colore del bordo del controllo Web. (Ereditato da WebControl)
BorderStyle	Ottiene o imposta lo stile del bordo del controllo server Web. (Ereditato da WebControl)
BorderWidth	Ottiene o imposta la larghezza del bordo del controllo server Web. (Ereditato da WebControl)
CatalogPartChrome	Ottiene un riferimento all'istanza della classe CatalogPartChrome associata alla zona CatalogZoneBase. (Ereditato da CatalogZoneBase)
CatalogParts	Ottiene un insieme di tutti i controlli CatalogPart contenuti in una zona CatalogZoneBase. (Ereditato da CatalogZoneBase)
ChildControlsCreated	Ottiene un valore che indica se i controlli figli del controllo server sono stati creati. (Ereditato da Control)
ClientID	Ottiene l'ID di controllo per il markup HTML generato da ASP.NET. (Ereditato da Control)
ClientIDMode	Ottiene o imposta l'algoritmo utilizzato per generare il valore della proprietà ClientID. (Ereditato da Control)
ClientIDSeparator	Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID. (Ereditato da Control)
CloseVerb	Ottiene un riferimento a un oggetto WebPartVerb che consente agli utenti finali di chiudere l'interfaccia utente del catalogo e riportare la pagina in modalità di visualizzazione normale. (Ereditato da CatalogZoneBase)
Context	Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
Controls	Ottiene un oggetto ControlCollection che rappresenta i controlli figlio di un oggetto CompositeControl. (Ereditato da CompositeControl)
ControlStyle	Ottiene lo stile del controllo server Web. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ControlStyleCreated	Ottiene un valore che indica se è stato creato un oggetto Style per la proprietà ControlStyle. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CssClass	Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. (Ereditato da WebControl)
DataItemContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
DataKeysContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
DesignMode	Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control)
Display	Ottiene un valore che indica se un controllo ToolZone è attualmente visualizzato. (Ereditato da ToolZone)
EditUIStyle	Ottiene gli attributi di stile per i controlli modificabili contenuti in un controllo ToolZone. (Ereditato da ToolZone)
EmptyZoneText	Ottiene o imposta un messaggio che viene visualizzato quando un'area non contiene controlli. (Ereditato da CatalogZoneBase)
EmptyZoneTextStyle	Ottiene gli attributi di stile per il testo segnaposto in una zona vuota. (Ereditato da WebZone)
Enabled	Ottiene o imposta un valore che indica se il controllo server Web è abilitato. (Ereditato da WebControl)
EnableTheming	Ottiene o imposta un valore che indica se al controllo vengono applicati i temi. (Ereditato da WebControl)
EnableViewState	Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente. (Ereditato da Control)
ErrorStyle	Ottiene gli attributi di stile per il rendering del messaggio di errore visualizzato se non è possibile caricare o creare un controllo WebPart. (Ereditato da WebZone)
Events	Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è di sola lettura. (Ereditato da Control)
Font	Ottiene le proprietà del carattere associate al controllo server Web. (Ereditato da WebControl)
FooterStyle	Ottiene gli attributi di stile per il contenuto dell'area di piè di pagina di una zona. (Ereditato da WebZone)
ForeColor	Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. (Ereditato da WebControl)
HasAttributes	Ottiene un valore che indica se sono impostati attributi per il controllo. (Ereditato da WebControl)
HasChildViewState	Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate. (Ereditato da Control)
HasFooter	Ottiene un valore che indica se una zona comprende o meno un'area di piè di pagina. (Ereditato da WebZone)
HasHeader	Ottiene un valore che indica se una zona comprende un'area di intestazione. (Ereditato da WebZone)
HeaderCloseVerb	Ottiene un riferimento all'oggetto WebPartVerb nell'intestazione di un controllo ToolZone utilizzato per chiudere il controllo. (Ereditato da ToolZone)
HeaderStyle	Ottiene gli attributi di stile per il contenuto dell'area di intestazione di una zona. (Ereditato da WebZone)
HeaderText	Ottiene o imposta il testo dell'area di intestazione di un'area. (Ereditato da CatalogZoneBase)
HeaderVerbStyle	Ottiene gli attributi di stile per tutti i verbi di intestazione visualizzati in un controllo ToolZone. (Ereditato da ToolZone)
Height	Ottiene o imposta l'altezza del controllo server Web. (Ereditato da WebControl)
ID	Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server. (Ereditato da Control)
IdSeparator	Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control)
InstructionText	Ottiene o imposta il testo in una zona che fornisce indicazioni agli utenti finali. (Ereditato da CatalogZoneBase)
InstructionTextStyle	Ottiene gli attributi di stile per il testo di istruzioni che appare nella parte superiore di un controllo ToolZone. (Ereditato da ToolZone)
IsChildControlStateCleared	Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo. (Ereditato da Control)
IsEnabled	Ottiene un valore che indica se il controllo è abilitato. (Ereditato da WebControl)
IsTrackingViewState	Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione. (Ereditato da Control)
IsViewStateEnabled	Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente. (Ereditato da Control)
LabelStyle	Ottiene gli attributi di stile per il contenuto delle etichette che appaiono accanto ai controlli di modifica all'interno di un controllo ToolZone. I controlli ToolZone derivati, ad esempio CatalogZone e EditorZone, applicano gli stili alle etichette. (Ereditato da ToolZone)
LoadViewStateByID	Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice. (Ereditato da Control)
NamingContainer	Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà ID. (Ereditato da Control)
Padding	Ottiene o imposta gli attributi di spaziatura interna delle celle sulla tabella che contiene i controlli WebPart in una zona. (Ereditato da WebZone)
Page	Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control)
Parent	Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina. (Ereditato da Control)
PartChromePadding	Ottiene o imposta la distanza tra il contenuto di un controllo WebPart e il bordo del controllo. (Ereditato da WebZone)
PartChromeStyle	Ottiene le caratteristiche di stile applicabili ai bordi dei controlli Web part contenuti in una zona. (Ereditato da WebZone)
PartChromeType	Ottiene o imposta il tipo di bordo che delimita i controlli Web part contenuti in una zona. (Ereditato da WebZone)
PartLinkStyle	Ottiene un oggetto contenente gli attributi di stile per i controlli CatalogPart che non sono attualmente selezionati nella zona. (Ereditato da CatalogZoneBase)
PartStyle	Ottiene le caratteristiche di stile applicabili al bordo e al contenuto di ogni controllo Web part contenuto in una zona. (Ereditato da WebZone)
PartTitleStyle	Ottiene gli attributi di stile relativi al contenuto della barra del titolo per ogni controllo Web part contenuto in una zona. (Ereditato da WebZone)
RenderClientScript	Ottiene un valore che indica se eseguire o meno il rendering dello script client su una pagina Web part. (Ereditato da WebZone)
RenderingCompatibility	Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering. (Ereditato da Control)
SelectedCatalogPartID	Ottiene o imposta una stringa come identificatore per il controllo CatalogPart attualmente selezionato in una zona. (Ereditato da CatalogZoneBase)
SelectedPartLinkStyle	Ottiene un oggetto contenente gli attributi di stile per il controllo CatalogPart attualmente selezionato nella zona. (Ereditato da CatalogZoneBase)
SelectTargetZoneText	Ottiene o imposta il testo con il controllo nell'interfaccia utente del catalogo che consente agli utenti di scegliere a quale zona aggiungere i controlli selezionati. (Ereditato da CatalogZoneBase)
ShowCatalogIcons	Ottiene o imposta un valore che indica se per i controlli server presenti nel catalogo vengono visualizzate o meno le icone associate. (Ereditato da CatalogZoneBase)
Site	Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. (Ereditato da Control)
SkinID	Ottiene o imposta l'interfaccia personalizzata da applicare al controllo. (Ereditato da WebControl)
Style	Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. (Ereditato da WebControl)
SupportsDisabledAttribute	Ottiene un valore che indica se il controllo deve impostare l'attributo disabled dell'elemento HTML di cui è stato eseguito il rendering su "disabilitato" quando la proprietà IsEnabled del controllo è false. (Ereditato da CompositeControl)
TabIndex	Ottiene o imposta l'indice di tabulazione del controllo server Web. (Ereditato da WebControl)
TagKey	Ottiene il valore HtmlTextWriterTag corrispondente al controllo server Web. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebZone)
TagName	Ottiene il nome del tag del controllo. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
TemplateControl	Ottiene o imposta un riferimento al modello che contiene il controllo. (Ereditato da Control)
TemplateSourceDirectory	Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente. (Ereditato da Control)
ToolTip	Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. (Ereditato da WebControl)
UniqueID	Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server. (Ereditato da Control)
ValidateRequestMode	Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser. (Ereditato da Control)
VerbButtonType	Ottiene o imposta il tipo di pulsante da utilizzare per rappresentare i verbi in una zona. (Ereditato da WebZone)
VerbStyle	Ottiene gli attributi di stile per i verbi dell'interfaccia utente associati ai controlli Web part di una zona. (Ereditato da WebZone)
ViewState	Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina. (Ereditato da Control)
ViewStateIgnoresCase	Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole. (Ereditato da Control)
ViewStateMode	Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo. (Ereditato da Control)
Visible	Ottiene o imposta un valore che indica se un controllo server viene o meno sottoposto a rendering come elemento dell'interfaccia utente nella pagina. (Ereditato da ToolZone)
WebPartManager	Ottiene un riferimento al controllo WebPartManager associato a un'istanza del controllo WebZone in una pagina Web part. (Ereditato da WebZone)
Width	Ottiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl)
ZoneTemplate	Ottiene o imposta un modello per inserire i controlli figlio in un controllo CatalogZone nel formato di persistenza nella pagina.

Metodi

AddAttributesToRender(HtmlTextWriter)	Aggiunge attributi e stili HTML dei quali è necessario eseguire il rendering nell'oggetto HtmlTextWriterTag specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
AddedControl(Control, Int32)	Chiamato dopo che un controllo figlio viene aggiunto alla raccolta Controls dell'oggetto Control. (Ereditato da Control)
AddParsedSubObject(Object)	Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server. (Ereditato da Control)
ApplyStyle(Style)	Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, sovrascrivendo eventuali elementi di stile del controllo. Il metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ApplyStyleSheetSkin(Page)	Applica al controllo le proprietà di stile definite nel foglio di stile della pagina. (Ereditato da Control)
BeginRenderTracing(TextWriter, Object)	Inizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
BuildProfileTree(String, Boolean)	Raccoglie informazioni sul controllo server e le recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina. (Ereditato da Control)
ClearCachedClientID()	Imposta il valore memorizzato nella cache ClientID su null. (Ereditato da Control)
ClearChildControlState()	Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control)
ClearChildState()	Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearChildViewState()	Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearEffectiveClientIDMode()	Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control)
Close()	Passa la pagina Web dalla modalità di visualizzazione catalogo alla modalità di visualizzazione normale. (Ereditato da CatalogZoneBase)
CopyBaseAttributes(WebControl)	Copia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web dal quale è stato chiamato il metodo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CreateCatalogPartChrome()	Crea un'istanza di un oggetto CatalogPartChrome utilizzato per il rendering degli elementi periferici dell'interfaccia utente relativi ai controlli CatalogPart di una zona. (Ereditato da CatalogZoneBase)
CreateCatalogParts()	Crea un'istanza di ogni tipo CatalogPart dichiarato nella zona.
CreateChildControls()	Crea il set dei controlli figlio associati a una zona CatalogZoneBase. (Ereditato da CatalogZoneBase)
CreateControlCollection()	Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server. (Ereditato da Control)
CreateControlStyle()	Crea l'oggetto di stile utilizzato internamente dalla classe WebControl per implementare tutte le proprietà correlate allo stile. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
DataBind()	Associa un'origine dati al controllo CompositeControl e a tutti i relativi controlli figlio. (Ereditato da CompositeControl)
DataBind(Boolean)	Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding. (Ereditato da Control)
DataBindChildren()	Associa un'origine dati al controllo server e ai relativi controlli figlio. (Ereditato da Control)
Dispose()	Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria. (Ereditato da Control)
EndRenderTracing(TextWriter, Object)	Termina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
EnsureChildControls()	Determina se il controllo server contiene controlli figlio. In caso contrario, li crea. (Ereditato da Control)
EnsureID()	Crea un identificatore per i controlli a cui non è assegnato alcun identificatore. (Ereditato da Control)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindControl(String)	Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato. (Ereditato da Control)
FindControl(String, Int32)	Cerca nel contenitore di denominazione corrente un controllo server con il parametro id indicato e un intero, specificato nel parametro pathOffset, che agevola la ricerca. Non eseguire l'override di questa versione del metodo FindControl. (Ereditato da Control)
Focus()	Imposta lo stato attivo per l'input su un controllo. (Ereditato da Control)
GetDesignModeState()	Ottiene i dati della fase di progettazione per un controllo. (Ereditato da Control)
GetEffectiveChromeType(Part)	Restituisce il valore PartChromeType corrente effettivo di un controllo WebPart, una volta specificate la proprietà PartChromeType della zona e la modalità di visualizzazione corrente della pagina Web part. (Ereditato da WebZone)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetRouteUrl(Object)	Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(RouteValueDictionary)	Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(String, Object)	Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetUniqueIDRelativeTo(Control)	Restituisce la parte con prefisso della proprietà UniqueID del controllo specificato. (Ereditato da Control)
HasControls()	Determina se il controllo server contiene controlli figlio. (Ereditato da Control)
HasEvents()	Restituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio. (Ereditato da Control)
InvalidateCatalogParts()	Elimina in modo permanente l'insieme di controlli CatalogPart associati a una zona CatalogZoneBase. (Ereditato da CatalogZoneBase)
IsLiteralContent()	Determina se il controllo server conserva solo il contenuto literal. (Ereditato da Control)
LoadControlState(Object)	Carica lo stato dalla richiesta di una pagina precedente per le proprietà del controllo che devono persistere durante i postback, anche quando viene disabilitato lo stato di visualizzazione sul controllo. (Ereditato da CatalogZoneBase)
LoadPostData(String, NameValueCollection)	Elabora lo stato delle caselle di controllo che corrispondono ai controlli WebPart nel catalogo, quando viene eseguito il postback della pagina al server. (Ereditato da CatalogZoneBase)
LoadViewState(Object)	Carica le informazioni sullo stato precedentemente salvate per una zona. (Ereditato da CatalogZoneBase)
MapPathSecure(String)	Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MergeStyle(Style)	Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, ma non sovrascrive eventuali elementi di stile del controllo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se l'evento per il controllo server viene passato a un livello superiore nella gerarchia dei controlli server dell'interfaccia utente per la pagina. (Ereditato da Control)
OnDataBinding(EventArgs)	Genera l'evento DataBinding. (Ereditato da Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)	Fornisce una dichiarazione del metodo base che i controlli ToolZone derivati possono sottoporre a override per gestire i dettagli del cambiamento delle modalità di visualizzazione pagina per una zona specializzata. (Ereditato da ToolZone)
OnInit(EventArgs)	Registra l'oggetto pagina in modo che la pagina richieda lo stato del controllo. (Ereditato da CatalogZoneBase)
OnLoad(EventArgs)	Genera l'evento Load. (Ereditato da Control)
OnPreRender(EventArgs)	Genera l'evento PreRender e registra l'oggetto pagina in modo che richieda postback. (Ereditato da CatalogZoneBase)
OnSelectedWebPartChanged(Object, WebPartEventArgs)	Fornisce una dichiarazione del metodo base che i controlli ToolZone derivati possono sottoporre a override per gestire l'evento di cambiare quale controllo Web part è selezionato all'interno di una zona specializzata. (Ereditato da ToolZone)
OnUnload(EventArgs)	Genera l'evento Unload. (Ereditato da Control)
OpenFile(String)	Ottiene un oggetto Stream utilizzato per leggere un file. (Ereditato da Control)
RaiseBubbleEvent(Object, EventArgs)	Assegna eventuali origini dell'evento e relative informazioni al controllo padre. (Ereditato da Control)
RaisePostBackEvent(String)	Esegue le azioni associate a uno dei verbi di zona oppure genera un evento che esegue il postback al server. (Ereditato da CatalogZoneBase)
RecreateChildControls()	Ricrea i controlli figlio in un controllo derivato da CompositeControl. (Ereditato da CompositeControl)
RemovedControl(Control)	Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control. (Ereditato da Control)
Render(HtmlTextWriter)	Esegue il rendering della zona sull'oggetto HtmlTextWriter specificato. (Ereditato da CatalogZoneBase)
RenderBeginTag(HtmlTextWriter)	Esegue il rendering del tag HTML di apertura del controllo zona nell'oggetto HtmlTextWriter specificato. (Ereditato da WebZone)
RenderBody(HtmlTextWriter)	Esegue l'override del metodo base per eseguire il rendering dell'area del corpo di una zona derivata dalla classe CatalogZoneBase. (Ereditato da CatalogZoneBase)
RenderCatalogPartLinks(HtmlTextWriter)	Esegue il rendering dei collegamenti ai singoli controlli CatalogPart di una zona CatalogZoneBase. (Ereditato da CatalogZoneBase)
RenderChildren(HtmlTextWriter)	Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto HtmlTextWriter specificato, che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control)
RenderContents(HtmlTextWriter)	Esegue il rendering dell'intero contenuto di un controllo zona compreso tra il tag di inizio e quello di fine sull'oggetto HtmlTextWriter specificato. (Ereditato da WebZone)
RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata. (Ereditato da Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato. (Ereditato da Control)
RenderEndTag(HtmlTextWriter)	Esegue il rendering del tag HTML di chiusura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
RenderFooter(HtmlTextWriter)	Esegue il rendering dell'area di piè di pagina relativa a una zona CatalogZoneBase. (Ereditato da CatalogZoneBase)
RenderHeader(HtmlTextWriter)	Esegue l'override del metodo base per fornire il rendering specializzato per l'area di intestazione richiesto dai controlli ToolZone. (Ereditato da ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)	Esegue il rendering di un singolo verbo con un controllo ToolZone. (Ereditato da ToolZone)
RenderVerbs(HtmlTextWriter)	Esegue il rendering dei verbi nell'area di piè di pagina di una zona CatalogZoneBase. (Ereditato da CatalogZoneBase)
ResolveAdapter()	Ottiene l'adattatore del controllo responsabile del rendering del controllo specificato. (Ereditato da Control)
ResolveClientUrl(String)	Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
ResolveUrl(String)	Converte un URL in un formato utilizzabile dal client richiedente. (Ereditato da Control)
SaveControlState()	Salvare le eventuali modifiche in uno stato del controllo CatalogZoneBase che si verifica dopo il postback della pagina Web al server. (Ereditato da CatalogZoneBase)
SaveViewState()	Salva tutte le modifiche dello stato di visualizzazione avvenute dopo il reinserimento di una pagina nel server. (Ereditato da CatalogZoneBase)
SetDesignModeState(IDictionary)	Imposta i dati della fase di progettazione per un controllo. (Ereditato da Control)
SetRenderMethodDelegate(RenderMethod)	Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control)
SetTraceData(Object, Object)	Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
SetTraceData(Object, Object, Object)	Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TrackViewState()	Tiene traccia delle modifiche apportate allo stato di visualizzazione di un controllo zona. (Ereditato da CatalogZoneBase)

Eventi

DataBinding	Viene generato quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
Disposed	Si verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control)
Init	Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata. (Ereditato da Control)
Load	Viene generato quando il controllo server è caricato nell'oggetto Page. (Ereditato da Control)
PreRender	Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering. (Ereditato da Control)
Unload	Viene generato quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)

Implementazioni dell'interfaccia esplicita

IAttributeAccessor.GetAttribute(String)	Ottiene un attributo del controllo Web con il nome specificato. (Ereditato da WebControl)
IAttributeAccessor.SetAttribute(String, String)	Imposta un attributo del controllo Web sul nome e il valore specificati. (Ereditato da WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Consente a uno strumento di progettazione di ricreare l'insieme di controlli figlio del controllo composito nell'ambiente di progettazione. (Ereditato da CompositeControl)
IControlBuilderAccessor.ControlBuilder	Per una descrizione di questo membro, vedere ControlBuilder. (Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()	Per una descrizione di questo membro, vedere GetDesignModeState(). (Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary). (Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Per una descrizione di questo membro, vedere SetOwnerControl(Control). (Ereditato da Control)
IControlDesignerAccessor.UserData	Per una descrizione di questo membro, vedere UserData. (Ereditato da Control)
IDataBindingsAccessor.DataBindings	Per una descrizione di questo membro, vedere DataBindings. (Ereditato da Control)
IDataBindingsAccessor.HasDataBindings	Per una descrizione di questo membro, vedere HasDataBindings. (Ereditato da Control)
IExpressionsAccessor.Expressions	Per una descrizione di questo membro, vedere Expressions. (Ereditato da Control)
IExpressionsAccessor.HasExpressions	Per una descrizione di questo membro, vedere HasExpressions. (Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)	Per una descrizione di questo membro, vedere AddParsedSubObject(Object). (Ereditato da Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Implementa il metodo LoadPostData(String, NameValueCollection) mediante la chiamata del metodo LoadPostData(String, NameValueCollection) della classe CatalogZoneBase. (Ereditato da CatalogZoneBase)
IPostBackDataHandler.RaisePostDataChangedEvent()	Per una descrizione di questo membro, vedere RaisePostDataChangedEvent(). (Ereditato da CatalogZoneBase)
IPostBackEventHandler.RaisePostBackEvent(String)	Implementa il metodo RaisePostBackEvent(String). (Ereditato da ToolZone)

Metodi di estensione

FindDataSourceControl(Control)	Restituisce l'origine dati associata al controllo dati per il controllo specificato.
FindFieldTemplate(Control, String)	Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.
FindMetaTable(Control)	Restituisce l'oggetto metatabella per il controllo contenitore dei dati.
GetDefaultValues(INamingContainer)	Ottiene l'insieme di valori predefiniti per il controllo dei dati specificato.
GetMetaTable(INamingContainer)	Ottiene i metadati della tabella per il controllo dei dati specificato.
SetMetaTable(INamingContainer, MetaTable)	Imposta i metadati della tabella per il controllo dei dati specificato.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato.
SetMetaTable(INamingContainer, MetaTable, Object)	Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se sono disponibili i metadati della tabella.
EnableDynamicData(INamingContainer, Type)	Abilita il comportamento dati dinamici per il controllo dei dati specificato.
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Abilita il comportamento dati dinamici per il controllo dei dati specificato.
EnableDynamicData(INamingContainer, Type, Object)	Abilita il comportamento dati dinamici per il controllo dei dati specificato.

Vedi anche

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