Condividi tramite


WebZone Classe

Definizione

Funge da classe base per tutti i controli che agiscono da contenitore per i controlli server (tra cui i controlli Part, i controlli server e i controlli utente Web part) nelle applicazioni Web part.

public ref class WebZone abstract : System::Web::UI::WebControls::CompositeControl
[System.ComponentModel.Bindable(false)]
public abstract class WebZone : System.Web.UI.WebControls.CompositeControl
[<System.ComponentModel.Bindable(false)>]
type WebZone = class
    inherit CompositeControl
Public MustInherit Class WebZone
Inherits CompositeControl
Ereditarietà
Derivato
Attributi

Esempio

Nell'esempio di codice seguente viene illustrato l'uso della WebZone classe .

La prima parte dell'esempio di codice mostra due controlli personalizzati che derivano dalla WebPart classe . 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. 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.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class CalendarWebPart : WebPart
  {
    Calendar _calendar;

    public CalendarWebPart()
    {
      this.AllowClose = false;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      _calendar = new Calendar();
      _calendar.Caption = "My Calendar";
      this.Controls.Add(_calendar);
      ChildControlsCreated = true;
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class LinksWebPart : WebPart
  {
    Literal _literal;
    const string _literalText = @"
      <table>
      <tr>
        <td><a href='http://msdn.microsoft.com'>MSDN</a></td>
      </tr>
      <tr>
        <td><a href='http://msn.microsoft.com'>MSN</a></td>
      </tr>
      <tr>
        <td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>
      </tr>
      </table>";

    public LinksWebPart()
    {
      this.AllowClose = false;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();

      _literal = new Literal();
      _literal.Text = _literalText;
      this.Controls.Add(_literal);

      ChildControlsCreated = true;
    }
  }
}
Imports System.Security.Permissions 
Imports System.Web
Imports System.Web.UI.WebControls 
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

<AspNetHostingPermission(SecurityAction.Demand, _ 
  Level := AspNetHostingPermissionLevel.Minimal)> _ 
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _ 
Public Class CalendarWebPart
  Inherits WebPart
  Private _calendar As Calendar

  Public Sub New()
    Me.AllowClose = False

  End Sub

  Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      _calendar = New Calendar()
      _calendar.Caption = "My Calendar"
      Me.Controls.Add(_calendar)
      ChildControlsCreated = True
  
  End Sub 
  
End Class 

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class LinksWebPart
    Inherits WebPart
    Private _literal As Literal
    Private Const _literalText As String = _
      "<table>" & _
      "<tr>" & _
      "<td><a href='http://msdn.microsoft.com'>MSDN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://msn.microsoft.com'>MSN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>" & _
      "</tr>" & _
      "</table>"

    Public Sub New()
      Me.AllowClose = False

    End Sub


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()

      _literal = New Literal()
      _literal.Text = _literalText
      Me.Controls.Add(_literal)

      ChildControlsCreated = True

    End Sub
  End Class

End Namespace

La seconda parte dell'esempio di codice mostra una pagina Web che ospita i WebPart controlli. Si noti che il markup dichiarativo contiene due WebPartZone controlli, un CatalogZone controllo e un EditorZone controllo .

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ZoneWebPartsCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</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"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <ZoneTemplate>
          <aspSample:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>
<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="ZoneWebPartsVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</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"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <ZoneTemplate>
          <aspSample:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>

È possibile caricare la pagina in un browser e passare tra le varie modalità di visualizzazione della pagina per vedere il comportamento delle diverse zone. Per altre informazioni sulle modalità di visualizzazione e su come consentire agli utenti di spostarsi tra di essi, vedere Procedura dettagliata: Modifica delle modalità di visualizzazione in una pagina web part.

Commenti

Un'area Web part è un'area definita che contiene controlli server in una pagina Web e fornisce un'interfaccia utente coerente, un layout e un rendering per i controlli contenuti. Il rendering delle zone viene eseguito in un browser come tabelle HTML.

La WebZone classe è la classe base per tutte le aree web part. Un controllo zona è un controllo composito progettato per contenere altri controlli, pertanto la WebZone classe eredita dalla CompositeControl classe . Insieme al WebPartManager controllo e Part ai controlli (o ad altri controlli utente o server che possono essere posizionati in zone), i controlli di zona derivati dalla WebZone classe base formano i blocchi predefiniti essenziali di un'applicazione Web part.

Un ruolo fondamentale delle aree web part consiste nell'abilitare la funzionalità web part completa per i controlli che contengono. Ogni pagina web part contiene almeno un'area e un'area può contenere zero o più controlli di parte. Le zone sono necessarie per la funzionalità web part. Senza zone, anche i controlli che derivano dalla WebPart classe possono avere pochissime funzionalità web part. Al contrario, a causa della progettazione del set di controlli Web part, è possibile posizionare controlli di ASP.NET ordinari, controlli server o controlli utente in una WebPartZoneBase zona (che deriva da WebZone) e, in virtù dell'essere nella zona, questi controlli server ordinari sono abilitati a fungere WebPart da controlli in fase di esecuzione. Per informazioni dettagliate, vedere la documentazione per la GenericWebPart classe .

Nota

È possibile aggiungere Part o WebPart controlli a una pagina all'esterno di una zona, ma in questo caso funzionano semplicemente come controlli server ordinari.

Esistono due ampie categorie di zone nel set di controlli Web part, che ereditano dalla classe base WebZone .

  • WebPartZoneBase Zone. WebPart Contengono (e altri controlli server e utenti) e formano l'interfaccia utente principale delle pagine web part che gli utenti interagiscono con la maggior parte del tempo.

  • ToolZone Zone. Queste zone offrono visualizzazioni speciali di una pagina Web part che consentono agli utenti di modificare (personalizzare) il contenuto, il layout, l'aspetto, il comportamento e le proprietà dei controlli contenuti in zone in WebPartZoneBase una pagina web part. Ad esempio, una CatalogZoneBase zona è un ToolZone oggetto che fornisce una visualizzazione catalogo di una pagina, consentendo agli utenti di aggiungere e rimuovere controlli server. Un'area EditorZoneBase è un altro tipo di che fornisce una visualizzazione di ToolZone modifica di una pagina, consentendo agli utenti di modificare e modificare il layout della pagina, insieme alle proprietà, all'aspetto e al comportamento dei controlli.

Ogni zona nel set di controlli Web part è progettata per contenere un tipo di controllo corrispondente derivato dalla Part classe, con i controlli della parte che fungono da contenuto principale e interfaccia utente primaria della zona. I tipi di zona nel set di controlli Web part, insieme ai tipi corrispondenti di controlli parti contenuti, sono illustrati nella tabella seguente.

Tipo di controllo della parte Tipo di zona
WebPart (e i controlli server e utente, di cui è stato eseguito il wrapping con un controllo GenericWebPart in fase di esecuzione) WebPartZone (la classe di base è WebPartZoneBase )
EditorPart (sono disponibili diversi controlli derivati con il set di controlli Web part e possono essere sviluppati controlli personalizzati EditorPart ) EditorZone (la classe di base è EditorZoneBase )
CatalogPart (sono disponibili diversi controlli derivati con il set di controlli Web part e possono essere sviluppati controlli personalizzati CatalogPart ) CatalogZone (la classe di base è CatalogZoneBase )
WebPartConnection (i controlli di connessione sono univoci in quanto non sono controlli di parte che ereditano dalla classe base) ConnectionsZone (eredita direttamente da ToolZone )

Tutte le zone nel controllo Web part hanno elementi di interfaccia utente comuni di base che ereditano dalla classe base WebZone . Non tutti questi elementi sono visibili in ogni zona, ma ogni tipo di zona è in grado di avere questi elementi comuni dell'interfaccia utente correlati alla zona, come descritto nella tabella seguente.

Sezione Zona Descrizione
Intestazione Sezione superiore di una zona. Include il testo dell'intestazione, che può includere un titolo per la zona; attributi di stile (ad esempio un bordo o un colore di sfondo) che distinguono l'intestazione; e verbi a livello di zona (rappresentati da pulsanti, collegamenti ipertestuali o immagini) su cui gli utenti possono fare clic per eseguire azioni dell'interfaccia utente che si applicano all'intera zona, ad esempio la chiusura di una zona. Diverse WebZone proprietà, ad esempio HasHeader, HeaderStylee HeaderText, sono correlate all'area di intestazione di una zona. Se nella zona sono presenti verbi a livello di zona, le VerbButtonType proprietà e VerbStyle vengono applicate. Si noti che queste due proprietà verbo si applicano solo ai verbi a livello di zona, non ai verbi nei singoli controlli di parte contenuti nella zona. Le intestazioni non sono presenti in ogni tipo di zona; in genere vengono visualizzati in ToolZone zone in cui è necessario avere un'area di intestazione comune con testo e un verbo, ad esempio un verbo vicino.
Corpo Sezione principale del contenuto di una zona. Ogni zona che deriva da WebZone ha una sezione del corpo. Per tutti i tipi di zone nel set di controlli Web part, il corpo della zona contiene il tipo designato di Part controlli (o altri controlli server) che corrispondono a un tipo di zona, come indicato nella tabella precedente. I vari membri della WebZone classe influiscono sul contenuto della sezione body, ad esempio le BackImageUrlproprietà , PartChromeStyle, PartChromeTypee PartStyle . Se la sezione body è vuota, il EmptyZoneText messaggio può essere visualizzato in determinate situazioni.
Chrome Gli elementi comuni dell'interfaccia utente sottoposti a rendering per ogni controllo di parte in una zona. Ciò è diverso da una discussione degli attributi di stile che si applicano alla zona stessa; Chrome si applica in modo specifico ai controlli della parte contenuta. Chrome include verbi, bordi e altri attributi di stile, ad esempio il colore di sfondo o lo stile del carattere del testo del titolo, per i controlli parte di una zona. Una zona determina i dettagli del riquadro usando un singolo oggetto chrome appropriato al tipo di controlli di parte che contiene , ad esempio un CatalogPartChrome oggetto per un CatalogZone oggetto contenente CatalogPart i controlli. Questo singolo oggetto chrome gestisce i dettagli del riquadro e il rendering per tutti i controlli della parte nella zona. In questo modo gli sviluppatori possono creare zone in cui possono specificare un aspetto coerente e comune per tutti i controlli della parte. Alcune proprietà correlate al riquadro per i controlli di parte di una zona includono le PartChromeStyleproprietà , PartChromeType, PartStylee PartTitleStyle . Si noti che la maggior parte delle proprietà correlate a Chrome, inclusa una proprietà specifica per fare riferimento all'oggetto chrome per un particolare tipo di zona, non viene implementata nella classe base WebZone . Al contrario, la maggior parte delle funzionalità specifiche di chrome delle zone viene implementata in tipi di zona specifici in base alle esigenze specifiche dei controlli di parte. Vedere gli argomenti per ogni tipo di zona elencato nella tabella precedente di questo argomento.
Controlli parte Controlli che risiedono nella sezione corpo di una zona. Ogni zona che eredita dalla WebZone classe contiene nella sezione del corpo uno o più controlli parte di un tipo corrispondente, come illustrato nella tabella precedente di questo argomento. Questi controlli della parte costituiscono l'interfaccia utente principale delle applicazioni Web part. La maggior parte dei tipi di zona che derivano da WebZone hanno una proprietà di raccolta che consente di fare riferimento a tutti i relativi controlli di parte contenuti, ad esempio la WebParts proprietà nella WebPartZoneBase classe e la EditorParts proprietà nella EditorZoneBase classe .
Piè di pagina Sezione inferiore di una zona. Analogamente alla sezione dell'intestazione, non è presente in ogni tipo di zona, ma in genere si verifica nelle ToolZone zone. Il contenuto tipico di una sezione piè di pagina è costituito da verbi come un verbo ok o un verbo apply, che viene visualizzato nel piè di pagina delle EditorZoneBase zone. Alcune proprietà correlate alla sezione piè di pagina includono le HasFooterproprietà , FooterStyle, VerbButtonTypee VerbStyle .

La maggior parte delle WebZone proprietà della classe è descritta nella tabella precedente che descrive gli elementi comuni dell'interfaccia utente delle zone. La WebZone classe include anche diversi metodi relativi al ruolo del contenuto di rendering. È possibile eseguire l'override dei RenderBodymetodi , RenderContents, RenderFootere RenderHeader per fornire il controllo a livello di codice sul rendering di ogni sezione specifica di una zona. Ad esempio, se si vuole personalizzare il rendering di tutte le sezioni piè di pagina delle zone di catalogo nell'applicazione, è possibile ereditare dalla CatalogZoneBase classe , eseguire l'override del RenderFooter metodo ereditato da WebZonee modificare il rendering della sezione piè di pagina.

Note per gli implementatori

Raramente è necessario ereditare direttamente dalla WebZone classe per sviluppare aree web part personalizzate. Il set di controlli Web part contiene le zone specializzate elencate in precedenza nella sezione Osservazioni e in genere è possibile derivare da una di esse per aggiungere un comportamento personalizzato a una zona. Se si decide di ereditare direttamente dalla WebZone classe , è necessario eseguire l'override di una serie di proprietà e metodi (vedere la documentazione per i membri della WebZone classe). È anche necessario creare un controllo personalizzato WebPartManager , facoltativamente un controllo personalizzato WebPartDisplayMode per creare una modalità di visualizzazione univoca in cui visualizzare la zona e altre personalizzazioni per rendere la zona funzionante all'interno del set di controlli Web part.

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)
AppRelativeTemplateSourceDirectory

Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo.

(Ereditato da Control)
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.

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)
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)
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)
EmptyZoneText

Ottiene o imposta un messaggio che viene visualizzato quando un'area non contiene controlli.

EmptyZoneTextStyle

Ottiene gli attributi di stile per il testo segnaposto in una zona vuota.

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.

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.

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.

HasHeader

Ottiene un valore che indica se una zona comprende un'area di intestazione.

HeaderStyle

Ottiene gli attributi di stile per il contenuto dell'area di intestazione di una zona.

HeaderText

Ottiene o imposta il testo dell'area di intestazione di un'area.

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)
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)
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.

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.

PartChromeStyle

Ottiene le caratteristiche di stile applicabili ai bordi dei controlli Web part contenuti in una zona.

PartChromeType

Ottiene o imposta il tipo di bordo che delimita i controlli Web part contenuti in una zona.

PartStyle

Ottiene le caratteristiche di stile applicabili al bordo e al contenuto di ogni controllo Web part contenuto in una zona.

PartTitleStyle

Ottiene gli attributi di stile relativi al contenuto della barra del titolo per ogni controllo Web part contenuto in una zona.

RenderClientScript

Ottiene un valore che indica se eseguire o meno il rendering dello script client su una pagina Web part.

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)
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.

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.

VerbStyle

Ottiene gli attributi di stile per i verbi dell'interfaccia utente associati ai controlli Web part di una zona.

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 viene eseguito il rendering di un controllo server come interfaccia utente nella pagina.

(Ereditato da Control)
WebPartManager

Ottiene un riferimento al controllo WebPartManager associato a un'istanza del controllo WebZone in una pagina Web part.

Width

Ottiene o imposta la larghezza del controllo server Web.

(Ereditato da WebControl)

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)
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)
CreateChildControls()

Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che usano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti in preparazione per il postback o il rendering.

(Ereditato da Control)
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.

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)
IsLiteralContent()

Determina se il controllo server conserva solo il contenuto literal.

(Ereditato da Control)
LoadControlState(Object)

Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState().

(Ereditato da Control)
LoadViewState(Object)

Carica le informazioni sullo stato precedentemente salvate per una zona.

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)
OnInit(EventArgs)

Genera l'evento Init.

OnLoad(EventArgs)

Genera l'evento Load.

(Ereditato da Control)
OnPreRender(EventArgs)

Genera l'evento PreRender.

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)
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)

Scrive il contenuto di CompositeControl nell'oggetto HtmlTextWriter specificato, per la visualizzazione sul client.

(Ereditato da CompositeControl)
RenderBeginTag(HtmlTextWriter)

Esegue il rendering del tag HTML di apertura del controllo zona nell'oggetto HtmlTextWriter specificato.

RenderBody(HtmlTextWriter)

Esegue l'override del rendering per il corpo di un controllo zona.

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.

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 l'override del rendering per il piè di pagina di un controllo zona.

RenderHeader(HtmlTextWriter)

Esegue l'override del rendering per l'intestazione di un controllo zona.

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()

Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server.

(Ereditato da Control)
SaveViewState()

Salva tutte le modifiche dello stato di visualizzazione avvenute dopo il reinserimento di una pagina nel server.

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.

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)

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.

Si applica a

Vedi anche