Part 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 controlli web part, che eseguono il rendering di un'interfaccia utente modulare in una pagina Web Form.
public ref class Part abstract : System::Web::UI::WebControls::Panel, System::Web::UI::INamingContainer, System::Web::UI::WebControls::ICompositeControlDesignerAccessorpublic abstract class Part : System.Web.UI.WebControls.Panel, System.Web.UI.INamingContainer, System.Web.UI.WebControls.ICompositeControlDesignerAccessortype Part = class
inherit Panel
interface INamingContainer
interface ICompositeControlDesignerAccessorPublic MustInherit Class Part
Inherits Panel
Implements ICompositeControlDesignerAccessor, INamingContainer- Ereditarietà
- Derivato
- Implementazioni
Esempio
Gli esempi di codice seguenti illustrano l'uso dichiarativo di diverse proprietà della Part classe usando due istanze di un controllo personalizzato WebPart a cui viene fatto riferimento in una pagina Web ASP.NET. 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.
La prima parte dell'esempio contiene il codice per il controllo personalizzato, denominato TextDisplayWebPart. Poiché il controllo deriva da WebPart, eredita anche le proprietà comuni fornite dalla Part classe e illustra l'uso di tali proprietà in questo esempio di codice.
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 TextDisplayWebPart : WebPart
{
private String _contentText = null;
TextBox input;
Label DisplayContent;
const string _subTitle = "Contoso, Ltd";
public TextDisplayWebPart()
{
this.AllowClose = false;
}
[
Personalizable(PersonalizationScope.User, true),
WebBrowsable()
]
public String ContentText
{
get { return _contentText; }
set { _contentText = value; }
}
protected override void CreateChildControls()
{
Controls.Clear();
DisplayContent = new Label();
DisplayContent.BackColor =
System.Drawing.Color.LightBlue;
DisplayContent.Text = this.ContentText;
this.Controls.Add(DisplayContent);
input = new TextBox();
this.Controls.Add(input);
Button update = new Button();
update.Text = "Set Label Content";
update.Click += new EventHandler(this.submit_Click);
this.Controls.Add(update);
ChildControlsCreated = true;
}
private void submit_Click(object sender, EventArgs e)
{
// Update the label string.
if (!string.IsNullOrEmpty(input.Text))
{
this.ContentText = Page.Server.HtmlEncode(input.Text) + @"<br />";
// Clear the input textbox.
input.Text = String.Empty;
DisplayContent.Text = this.ContentText;
}
}
}
}
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, _
Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class TextDisplayWebPart
Inherits WebPart
Private _contentText As String = Nothing
Private input As TextBox
Private DisplayContent As Label
Public Sub New()
Me.AllowClose = False
End Sub
<Personalizable(), WebBrowsable()> _
Public Property ContentText() As String
Get
Return _contentText
End Get
Set
_contentText = value
End Set
End Property
Protected Overrides Sub CreateChildControls()
Controls.Clear()
DisplayContent = New Label()
DisplayContent.Text = Me.ContentText
DisplayContent.BackColor = _
System.Drawing.Color.LightBlue
Me.Controls.Add(DisplayContent)
input = New TextBox()
Me.Controls.Add(input)
Dim update As New Button()
update.Text = "Set Label Content"
AddHandler update.Click, AddressOf Me.submit_Click
Me.Controls.Add(update)
ChildControlsCreated = True
End Sub
Private Sub submit_Click(ByVal sender As Object, _
ByVal e As EventArgs)
' Update the label string.
If input.Text <> String.Empty Then
Me.ContentText = Page.Server.HtmlEncode(input.Text) + "<br />"
' Clear the input textbox.
input.Text = String.Empty
DisplayContent.Text = Me.ContentText
End If
End Sub
End Class
End Namespace
La seconda parte dell'esempio mostra come fare riferimento ai controlli della parte personalizzata in una pagina Web ASP.NET. Si noti che le varie Part proprietà vengono assegnate in modo dichiarativo alle istanze del controllo personalizzato. Confrontare il codice dichiarativo che fa riferimento alle due istanze nella pagina e quindi caricare la pagina in un browser. Si noti che le varie proprietà influiscono sull'aspetto dei controlli. Ad esempio, dopo aver caricato la pagina in un browser, la seconda istanza del TextDisplayWebPart controllo viene ridotta a icona, perché il ChromeState relativo valore della proprietà è impostato su Minimized.
<%@ page language="C#" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="TextDisplayWebPartCS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
Description="A text content WebPart control."
ChromeType="TitleAndBorder"
width="350px" />
</zonetemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart2"
title = "Text Content WebPart 2"
Description="A text content WebPart control."
ChromeType="TitleOnly"
ChromeState="Minimized"
width="350px" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="TextDisplayWebPartVB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
Description="A text content WebPart control."
ChromeType="TitleAndBorder"
width="350px" />
</zonetemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart2"
title = "Text Content WebPart 2"
Description="A text content WebPart control."
ChromeType="TitleOnly"
ChromeState="Minimized"
width="350px" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
Commenti
La Part classe definisce le proprietà comuni a tutti i controlli della parte e consente loro di avere un aspetto modulare e coerente in una pagina Web. Queste proprietà comuni includono un titolo, una descrizione e le caratteristiche del riquadro o del frame che circonda un controllo parte.
La Title proprietà specifica un titolo per il controllo parte. La Description proprietà viene utilizzata per riepilogare lo scopo del controllo della parte e viene visualizzata come descrizione comando nella barra del titolo del controllo. La ChromeType proprietà determina il tipo di bordo di cui viene eseguito il rendering intorno a un controllo parte, mentre la ChromeState proprietà indica se il rendering di un controllo parte viene eseguito normalmente o ridotto a icona. Il bordo di un controllo parte è interessato dalle proprietà della zona che lo contiene; Ad esempio, la PartChromeType proprietà influisce sui frame di tutti i controlli parte contenuti in una zona.
Un tipo di controllo parte è il controllo , che esegue il WebPart rendering del contenuto all'interno di una zona corrispondente. Un altro tipo è il EditorPart controllo , che fornisce controlli dell'interfaccia utente usati per modificare (personalizzare) singoli WebPart controlli. Un terzo tipo di controllo parte è il CatalogPart controllo , che fornisce un elenco di WebPart controlli che gli utenti possono aggiungere o rimuovere da una pagina Web.
I controlli delle parti sono contenuti in zone, tutte derivate dalla classe astratta WebZone . Una zona è responsabile dell'organizzazione dei controlli della parte che contiene. Ogni zona esegue anche il rendering degli elementi dell'interfaccia utente per se stesso, tra cui un'intestazione, un piè di pagina, una barra del titolo e gli elementi dell'interfaccia utente intorno a ogni controllo della parte contenuta, ad esempio i bordi.
Annotazioni
Mentre i controlli di parte si trovano in genere in zone, è possibile posizionare un controllo parte all'esterno di una zona, se il controllo viene fatto riferimento in modo dichiarativo nel markup di una pagina Web. Se un controllo parte viene dichiarato all'esterno di un'area in una pagina Web, il controllo continua a funzionare, ma perde la maggior parte delle funzionalità delle web part. Ad esempio, il controllo non può essere modificato e non può essere trascinato in un fuso in fase di esecuzione. È anche utile ricordare che nessun controllo parte può essere trascinato da una zona e rilasciato in una pagina all'esterno di un fuso orario in fase di esecuzione.
Nella tabella seguente sono riportati alcuni esempi di tipi di parti di base e i relativi tipi di zona corrispondenti.
| Tipo di controllo parte | Tipo di zona |
|---|---|
| WebPart | WebPartZone |
| EditorPart | EditorZone |
| CatalogPart | CatalogZone |
I vari tipi di controlli di parte che derivano dalla Part classe gestiscono le proprietà ereditate orientate all'interfaccia utente in modo diverso.
WebPart I controlli eseguono l'override di diverse proprietà dell'interfaccia utente ereditate e le contrassegnano con l'attributo Personalizable (per informazioni dettagliate, vedere la documentazione della PersonalizableAttribute classe), che consente di salvare i valori di tali proprietà per le sessioni future del browser, una funzionalità nota come personalizzazione. Ad esempio, se a livello di codice si abilita un utente ad aggiornare il valore della proprietà di un WebPart controllo in fase di Title esecuzione, tale valore verrà personalizzato (presupponendo che la personalizzazione sia abilitata, ovvero l'impostazione predefinita). Diverse proprietà dell'interfaccia utente che WebPart i controlli ereditano dalla Part classe e dalla WebControl classe vengono gestite nello stesso modo.
Al contrario, altri controlli di parte, ad esempio EditorPart e CatalogPart, non consentono di personalizzare le proprietà dell'interfaccia utente ereditate. Per questo motivo, i valori delle proprietà assegnati a livello di codice non vengono salvati per le sessioni future del browser. Ad esempio, se a livello di codice si abilita un utente ad aggiornare la proprietà di un PropertyGridEditorPart controllo in fase di Title esecuzione, il valore aggiornato viene perso dopo la chiusura del controllo o la sessione del browser termina.
Un modo semplice per salvare i valori in tali proprietà ereditate dell'interfaccia utente per i controlli e CatalogPart per EditorPart le sessioni future del browser consiste nel dichiarare i valori delle proprietà nel formato di persistenza della pagina. Tuttavia, si tratta di un approccio statico e ancora non consente agli utenti di personalizzare i valori delle proprietà. In alternativa, se vuoi abilitare gli aggiornamenti a livello di codice alle proprietà ereditate dell'interfaccia utente in modo che gli utenti possano personalizzarli in fase di esecuzione, puoi usare variabili statiche private per salvare i valori delle proprietà. Ogni volta che viene creata una nuova istanza di un EditorPart controllo o CatalogPart , ad esempio nel metodo che gestisce l'evento del Init controllo, è possibile riassegnare il valore di una variabile statica a una proprietà corrispondente. Questo approccio consente agli utenti di personalizzare l'interfaccia utente di modifica e l'interfaccia utente del catalogo di un'applicazione web part.
Note per gli implementatori
In genere, non è consigliabile ereditare direttamente dalla Part classe per sviluppare controlli web part personalizzati. Per fornire funzionalità web part complete, il set di controlli Web part richiede le classi derivate dalla Part classe , ovvero WebPart, EditorParte CatalogPart, in modo da poter derivare da esse per sviluppare controlli personalizzati. Tuttavia, è comunque importante comprendere il comportamento della classe di base Part , perché fornisce un set comune di proprietà usate da tutte le altre classi di parti.
Proprietà
| Nome | Descrizione |
|---|---|
| AccessKey |
Ottiene o imposta la chiave di accesso che consente di passare 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 che contiene questo controllo. (Ereditato da Control) |
| Attributes |
Ottiene la raccolta 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 dell'immagine di sfondo per il controllo pannello. (Ereditato da Panel) |
| BindingContainer |
Ottiene il controllo che contiene il data binding di questo controllo. (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 sono stati creati i controlli figlio del controllo server. (Ereditato da Control) |
| ChromeState |
Ottiene o imposta un valore che indica se un controllo parte si trova in uno stato ridotto a icona o normale. |
| ChromeType |
Ottiene o imposta il tipo di bordo che incornicia un controllo Web part. |
| 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 ClientID proprietà . (Ereditato da Control) |
| ClientIDSeparator |
Ottiene un valore di carattere che rappresenta il carattere separatore utilizzato nella ClientID proprietà . (Ereditato da Control) |
| Context |
Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control) |
| Controls |
Ottiene un ControlCollection oggetto che contiene i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. |
| ControlStyle |
Ottiene lo stile del controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| ControlStyleCreated |
Ottiene un valore che indica se è stato creato un Style oggetto per la ControlStyle proprietà . Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| CssClass |
Ottiene o imposta la classe CSS (Cascading Style Sheet) sottoposta a rendering dal controllo server Web nel 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) |
| DefaultButton |
Ottiene o imposta l'identificatore per il pulsante predefinito contenuto nel Panel controllo . (Ereditato da Panel) |
| Description |
Ottiene o imposta una breve frase che riepiloga le operazioni del controllo parte da utilizzare nelle descrizioni comandi e nei cataloghi dei controlli parte. |
| DesignMode |
Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control) |
| Direction |
Ottiene o imposta la direzione in cui visualizzare i controlli che includono testo in un Panel controllo . (Ereditato da Panel) |
| 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 i temi si applicano a questo controllo. (Ereditato da WebControl) |
| EnableViewState |
Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione di tutti i controlli figlio contenuti, al client richiedente. (Ereditato da Control) |
| Events |
Ottiene un elenco di delegati del gestore eventi per il controllo . Questa proprietà è di sola lettura. (Ereditato da Control) |
| Font |
Ottiene le proprietà del tipo di carattere associate al controllo server Web. (Ereditato da WebControl) |
| ForeColor |
Ottiene o imposta il colore di primo piano (in genere il colore del testo) del controllo server Web. (Ereditato da WebControl) |
| GroupingText |
Ottiene o imposta la didascalia per il gruppo di controlli contenuti nel controllo pannello. (Ereditato da Panel) |
| HasAttributes |
Ottiene un valore che indica se il controllo dispone di attributi impostati. (Ereditato da WebControl) |
| HasChildViewState |
Ottiene un valore che indica se i controlli figlio del controllo server corrente hanno impostazioni dello stato di visualizzazione salvate. (Ereditato da Control) |
| Height |
Ottiene o imposta l'altezza del controllo server Web. (Ereditato da WebControl) |
| HorizontalAlign |
Ottiene o imposta l'allineamento orizzontale del contenuto all'interno del pannello. (Ereditato da Panel) |
| ID |
Ottiene o imposta l'identificatore programmatico 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 all'interno di questo controllo hanno uno stato di 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 apportate allo stato di visualizzazione. (Ereditato da Control) |
| IsViewStateEnabled |
Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo. (Ereditato da Control) |
| LoadViewStateByID |
Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione in ID base al posto dell'indice. (Ereditato da Control) |
| NamingContainer |
Ottiene un riferimento al contenitore di denominazione del controllo server, che crea uno spazio dei nomi univoco per la differenziazione tra i controlli server con lo stesso ID valore della proprietà. (Ereditato da Control) |
| 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 pagina. (Ereditato da Control) |
| RenderingCompatibility |
Ottiene un valore che specifica la versione ASP.NET con cui è stato eseguito il rendering del codice HTML sarà compatibile. (Ereditato da Control) |
| ScrollBars |
Ottiene o imposta la visibilità e la posizione delle barre di scorrimento in un Panel controllo . (Ereditato da Panel) |
| Site |
Ottiene informazioni sul contenitore che ospita il controllo corrente durante il rendering in un'area di progettazione. (Ereditato da Control) |
| SkinID |
Ottiene o imposta l'interfaccia da applicare al controllo. (Ereditato da WebControl) |
| Style |
Ottiene una raccolta di attributi di testo di cui verrà eseguito il rendering come attributo di stile sul tag esterno del controllo server Web. (Ereditato da WebControl) |
| SupportsDisabledAttribute |
Ottiene un valore che indica se il controllo deve impostare l'attributo dell'elemento |
| TabIndex |
Ottiene o imposta l'indice della scheda del controllo server Web. (Ereditato da WebControl) |
| TagKey |
Ottiene il HtmlTextWriterTag valore che corrisponde a questo controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| TagName |
Ottiene il nome del tag di controllo. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| TemplateControl |
Ottiene o imposta un riferimento al modello che contiene questo controllo. (Ereditato da Control) |
| TemplateSourceDirectory |
Ottiene la directory virtuale dell'oggetto Page o UserControl che contiene il controllo server corrente. (Ereditato da Control) |
| Title |
Ottiene o imposta il titolo di un controllo parte. |
| ToolTip |
Ottiene o imposta il testo visualizzato quando il puntatore del mouse passa il mouse sul controllo server Web. (Ereditato da WebControl) |
| UniqueID |
Ottiene l'identificatore univoco e qualificato gerarchicamente per il controllo server. (Ereditato da Control) |
| ValidateRequestMode |
Ottiene o imposta un valore che indica se il controllo controlla l'input client dal browser per individuare valori potenzialmente pericolosi. (Ereditato da Control) |
| ViewState |
Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste per la stessa pagina. (Ereditato da Control) |
| ViewStateIgnoresCase |
Ottiene un valore che indica se l'oggetto StateBag non fa distinzione tra maiuscole e minuscole. (Ereditato da Control) |
| ViewStateMode |
Ottiene o imposta la modalità dello stato di visualizzazione di questo controllo. (Ereditato da Control) |
| Visible |
Ottiene o imposta un valore che indica se il rendering di un controllo server viene eseguito come interfaccia utente nella pagina. (Ereditato da Control) |
| Width |
Ottiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl) |
| Wrap |
Ottiene o imposta un valore che indica se il contenuto viene disposto all'interno del pannello. (Ereditato da Panel) |
Metodi
| Nome | Descrizione |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Aggiunge informazioni sull'immagine di sfondo, l'allineamento, il ritorno a capo e la direzione all'elenco di attributi di cui eseguire il rendering. (Ereditato da Panel) |
| AddedControl(Control, Int32) |
Chiamato dopo l'aggiunta di un controllo figlio all'insieme 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 del ControlCollection controllo server. (Ereditato da Control) |
| ApplyStyle(Style) |
Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, sovrascrivendo tutti gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| ApplyStyleSheetSkin(Page) |
Applica le proprietà di stile definite nel foglio di stile della pagina al controllo . (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 distribuisce alla Trace proprietà da visualizzare quando la traccia è abilitata per la pagina. (Ereditato da Control) |
| ClearCachedClientID() |
Imposta il valore memorizzato nella ClientID cache 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 ClientIDMode proprietà 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 da cui viene chiamato questo metodo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| CreateChildControls() |
Chiamato dal framework di pagina ASP.NET per notificare ai controlli server che usano l'implementazione basata sulla composizione per creare tutti i controlli figlio che contengono in preparazione alla registrazione o al rendering. (Ereditato da Control) |
| CreateControlCollection() |
Crea un nuovo ControlCollection oggetto per contenere i controlli figlio (sia letterali che server) del controllo server. (Ereditato da Control) |
| CreateControlStyle() |
Crea un oggetto di stile utilizzato internamente dal Panel controllo per implementare tutte le proprietà correlate allo stile. (Ereditato da Panel) |
| DataBind() |
Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. |
| DataBind(Boolean) |
Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding . (Ereditato da Control) |
| DataBindChildren() |
Associa un'origine dati ai controlli figlio del controllo server. (Ereditato da Control) |
| Dispose() |
Consente a un controllo server di eseguire la pulizia finale prima che venga rilasciata 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, crea controlli figlio. (Ereditato da Control) |
| EnsureID() |
Crea un identificatore per i controlli a cui non è assegnato un identificatore. (Ereditato da Control) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| FindControl(String, Int32) |
Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato |
| FindControl(String) |
Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato |
| Focus() |
Imposta lo stato attivo dell'input su un controllo . (Ereditato da Control) |
| GetDesignModeState() |
Ottiene i dati in fase di progettazione per un controllo . (Ereditato da Control) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetRouteUrl(Object) |
Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control) |
| GetRouteUrl(RouteValueDictionary) |
Ottiene l'URL che corrisponde 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 un nome di route. (Ereditato da Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| GetUniqueIDRelativeTo(Control) |
Restituisce la parte con prefisso della UniqueID proprietà 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 per i controlli figlio. (Ereditato da Control) |
| IsLiteralContent() |
Determina se il controllo server contiene solo contenuto letterale. (Ereditato da Control) |
| LoadControlState(Object) |
Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal SaveControlState() metodo . (Ereditato da Control) |
| LoadViewState(Object) |
Ripristina le informazioni sullo stato di visualizzazione da una richiesta precedente salvata con il SaveViewState() metodo . (Ereditato da WebControl) |
| MapPathSecure(String) |
Recupera il percorso fisico a cui viene mappato un percorso virtuale, assoluto o relativo. (Ereditato da Control) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| MergeStyle(Style) |
Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, ma non sovrascriverà gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Determina se l'evento per il controllo server viene passato alla gerarchia di controllo server dell'interfaccia utente della pagina. (Ereditato da Control) |
| OnDataBinding(EventArgs) |
Genera l'evento DataBinding. (Ereditato da Control) |
| OnInit(EventArgs) |
Genera l'evento Init. (Ereditato da Control) |
| OnLoad(EventArgs) |
Genera l'evento Load. (Ereditato da Control) |
| OnPreRender(EventArgs) |
Genera l'evento PreRender. (Ereditato da Control) |
| OnUnload(EventArgs) |
Genera l'evento Unload. (Ereditato da Control) |
| OpenFile(String) |
Ottiene un Stream oggetto utilizzato per leggere un file. (Ereditato da Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Assegna tutte le origini dell'evento e le relative informazioni all'elemento padre del controllo. (Ereditato da Control) |
| RemovedControl(Control) |
Chiamato dopo che un controllo figlio viene rimosso dall'insieme Controls dell'oggetto Control . (Ereditato da Control) |
| Render(HtmlTextWriter) |
Esegue il rendering del controllo nel writer HTML specificato. (Ereditato da WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Esegue il rendering del tag di apertura HTML del Panel controllo nel writer specificato. (Ereditato da Panel) |
| RenderChildren(HtmlTextWriter) |
Restituisce il contenuto degli elementi figlio di un controllo server in un oggetto fornito HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control) |
| RenderContents(HtmlTextWriter) |
Esegue il rendering del contenuto del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter . (Ereditato da Control) |
| RenderControl(HtmlTextWriter) |
Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata. (Ereditato da Control) |
| RenderEndTag(HtmlTextWriter) |
Esegue il rendering del tag di chiusura HTML del Panel controllo nel writer specificato. (Ereditato da Panel) |
| ResolveAdapter() |
Ottiene l'adattatore di 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 URL utilizzabile nel client richiedente. (Ereditato da Control) |
| SaveControlState() |
Salva le modifiche apportate allo stato del controllo server dopo il postback della pagina al server. (Ereditato da Control) |
| SaveViewState() |
Salva qualsiasi stato modificato dopo che il TrackViewState() metodo è stato richiamato. (Ereditato da WebControl) |
| SetDesignModeState(IDictionary) |
Imposta i dati in 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, Object) |
Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control) |
| SetTraceData(Object, Object) |
Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando 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() |
Fa in modo che il controllo possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà dell'oggetto ViewState . (Ereditato da WebControl) |
Eventi
| Nome | Descrizione |
|---|---|
| DataBinding |
Si verifica quando il controllo server viene associato a un'origine dati. (Ereditato da Control) |
| Disposed |
Si verifica quando viene rilasciato un controllo server dalla memoria, ovvero l'ultima fase del ciclo di vita del controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control) |
| Init |
Si verifica quando il controllo server viene inizializzato, ovvero il primo passaggio del ciclo di vita. (Ereditato da Control) |
| Load |
Si verifica quando il controllo server viene caricato nell'oggetto Page . (Ereditato da Control) |
| PreRender |
Si verifica dopo il caricamento dell'oggetto Control , ma prima del rendering. (Ereditato da Control) |
| Unload |
Si verifica quando il controllo server viene scaricato dalla memoria. (Ereditato da Control) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| 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 sul valore specificati. (Ereditato da WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Consente allo sviluppatore di una finestra di progettazione di un controllo di parte composita di ricreare i controlli figlio del controllo nell'area di progettazione. |
| 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
| Nome | Descrizione |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Abilita il comportamento dei dati dinamici per il controllo dati specificato. |
| EnableDynamicData(INamingContainer, Type, Object) |
Abilita il comportamento dei dati dinamici per il controllo dati specificato. |
| EnableDynamicData(INamingContainer, Type) |
Abilita il comportamento dei dati dinamici per il controllo dati specificato. |
| 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 metatable per il controllo dati contenitore. |
| GetDefaultValues(INamingContainer) |
Ottiene la raccolta dei valori predefiniti per il controllo dati specificato. |
| GetMetaTable(INamingContainer) |
Ottiene i metadati della tabella per il controllo dati specificato. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Imposta i metadati della tabella e il mapping dei valori predefiniti per il controllo dati specificato. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Imposta i metadati della tabella e il mapping dei valori predefiniti per il controllo dati specificato. |
| SetMetaTable(INamingContainer, MetaTable) |
Imposta i metadati della tabella per il controllo dati specificato. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Determina se i metadati della tabella sono disponibili. |
