WebZone Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 CompositeControlPublic 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 |
| 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 |
| 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 |
| FindControl(String, Int32) |
Cerca nel contenitore di denominazione corrente un controllo server con il parametro |
| 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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per