WebPart 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 i controlli web part ASP.NET personalizzati, aggiungendo alle funzionalità della classe base Part alcune proprietà supplementari dell'interfaccia utente, la possibilità di creare connessioni e il comportamento di personalizzazione.
public ref class WebPart abstract : System::Web::UI::WebControls::WebParts::Part, System::Web::UI::WebControls::WebParts::IWebActionable, System::Web::UI::WebControls::WebParts::IWebEditable, System::Web::UI::WebControls::WebParts::IWebPartpublic abstract class WebPart : System.Web.UI.WebControls.WebParts.Part, System.Web.UI.WebControls.WebParts.IWebActionable, System.Web.UI.WebControls.WebParts.IWebEditable, System.Web.UI.WebControls.WebParts.IWebParttype WebPart = class
inherit Part
interface IWebPart
interface IWebActionable
interface IWebEditablePublic MustInherit Class WebPart
Inherits Part
Implements IWebActionable, IWebEditable, IWebPart- Ereditarietà
- Derivato
- Implementazioni
Esempio
Nell'esempio di codice seguente viene illustrato come creare un WebPart controllo e farvi riferimento in una pagina Web.
La prima parte dell'esempio contiene il codice per un controllo personalizzato WebPart denominato TextDisplayWebPart. Questo controllo illustra come creare un controllo personalizzato WebPart semplice che consente di accedere alle funzionalità del set di controlli Web part. Per eseguire l'esempio di codice, è necessario compilare questo codice sorgente. È possibile compilarlo in modo esplicito e inserire l'assembly risultante nella cartella Bin del sito Web o nella Global Assembly Cache. In alternativa, è possibile inserire il codice sorgente nella cartella App_Code del sito, in cui verrà compilato in modo dinamico in fase di esecuzione. In questo esempio di codice si presuppone che il codice sorgente venga compilato in un assembly, lo si inserisca in una sottocartella Bin dell'applicazione Web e si faccia riferimento all'assembly con una Register direttiva nella pagina Web. Per una procedura dettagliata che illustra entrambi i metodi di compilazione, vedere Procedura dettagliata: Sviluppo e uso di un controllo server Web personalizzato.
using System;
using System.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;
public TextDisplayWebPart()
{
this.AllowClose = false;
}
[Personalizable(), 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))
{
_contentText = input.Text + @"<br />";
input.Text = String.Empty;
DisplayContent.Text = this.ContentText;
}
}
}
}
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 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
_contentText = input.Text & "<br />"
input.Text = String.Empty
DisplayContent.Text = Me.ContentText
End If
End Sub
End Class
End Namespace
Nella seconda parte dell'esempio viene illustrato come fare riferimento al TextDisplayWebPart controllo in una pagina Web ASP.NET. Si noti che molte delle varie WebPart proprietà possono essere assegnate in modo dichiarativo al controllo personalizzato.
<%@ 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"
title="Zone 1"
PartChromeType="TitleAndBorder">
<parttitlestyle font-bold="true" ForeColor="#3300cc" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart" />
</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"
title="Zone 1"
PartChromeType="TitleAndBorder">
<parttitlestyle font-bold="true" ForeColor="#3300cc" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
Commenti
Quando si creano controlli con funzionalità Web part, sono disponibili due opzioni di base. È possibile creare controlli personalizzati che derivano dalla WebPart classe oppure è possibile creare o usare altri controlli server. I controlli ASP.NET esistenti, i controlli server personalizzati e i controlli utente possono avere tutte funzionalità complete delle web part dichiarandole all'interno (o aggiungendole a livello di codice) a un WebPartZone controllo zona, con il risultato che verranno sottoposti a wrapping con GenericWebPart oggetti in fase di esecuzione e considerati come controlli true WebPart . Per informazioni dettagliate, vedere la documentazione per la GenericWebPart classe . Per velocizzare lo sviluppo e il riutilizzo massimo del codice, l'uso dei controlli server esistenti può essere un'ottima opzione. Per il controllo massimo a livello di codice sul comportamento e sulle funzionalità web part dei controlli, la creazione di un controllo personalizzato che eredita dalla WebPart classe è spesso l'opzione migliore.
La classe astratta WebPart eredita dal controllo di base Part e fornisce gli elementi di base per tutti i WebPart controlli. La classe include un set comune di proprietà che influiscono sull'aspetto dell'interfaccia utente. Le AllowCloseproprietà , AllowConnect, AllowHideAllowEdit, AllowMinimize, e AllowZoneChange specificano se l'utente di un'applicazione Web può interagire con il controllo della parte nel modo indicato dal nome della proprietà specificato. Le CatalogIconImageUrlproprietà , ChromeTypeChromeState, DescriptionTitleHelpUrlHeightTitleIconImageUrlTitleUrlHiddene Width determinano le dimensioni, la visibilità, l'aspetto e il contenuto di supporto (ad esempio un titolo e una descrizione) per un WebPart controllo.
La relazione di un WebPart controllo con il relativo contesto all'interno del set di controlli Web part è determinata da proprietà quali WebPartManager, che contiene un riferimento all'oggetto associato WebPartManager del controllo e Zone, che fa riferimento all'oggetto WebZone che contiene il controllo . Può essere presente un WebPartManager solo controllo per pagina e ogni istanza di un WebPart controllo può trovarsi solo una WebZone alla volta.
Nota
Un WebPart controllo può essere posizionato all'esterno di un'area in una pagina Web, ma in questo caso funziona come un normale controllo server e perde quasi tutte le funzionalità web part.
Molte altre proprietà importanti influiscono sulle caratteristiche univoci dei WebPart controlli. La AuthorizationFilter proprietà consente agli sviluppatori di impostare una stringa arbitraria che può essere usata come filtro in fase di esecuzione per determinare se un controllo viene aggiunto alla pagina. Usato insieme a una funzionalità, ad esempio la gestione dei ruoli, la AuthorizationFilter proprietà fornisce un meccanismo utile per la creazione di viste in base ai ruoli utente definiti. La ExportMode proprietà indica se, durante un'esportazione, tutti i dati delle proprietà disponibili in un controllo vengono esportati o solo i dati non sensibili. Ciò consente agli sviluppatori di distinguere tra i dati sensibili e i dati che non sono, a scopo di sicurezza. La WebBrowsableObject proprietà restituisce un riferimento a un'istanza di un WebPart controllo, in modo che un EditorPart controllo possa modificarlo quando la pagina è in modalità di modifica. Infine, esistono diverse proprietà che indicano lo stato del controllo rispetto al resto della pagina. La IsClosed proprietà indica se un controllo è chiuso (e quindi aggiunto a un PageCatalogPart oggetto) o se è aperto e disponibile nella pagina. La IsShared proprietà indica se un controllo è un controllo condiviso (rispetto a un controllo specifico dell'utente), ovvero è visibile a tutti gli utenti di una pagina Web. La IsStandalone proprietà indica se un controllo è attualmente contenuto in una WebPartZoneBasezona derivata da , ad esempio WebPartZone. Un valore indica che il controllo si trova all'interno di false un'area e pertanto dispone di funzionalità web part complete. La IsStatic proprietà indica se un controllo è statico o dinamico. Un controllo statico viene dichiarato nel markup di una pagina Web, mentre un controllo dinamico viene aggiunto a livello di codice.
La WebPart classe fornisce anche diversi metodi che determinano cosa accade in vari punti del ciclo di vita del controllo. Ad esempio, i OnConnectModeChanged metodi e OnEditModeChanged possono essere sottoposti a override in una classe derivata per fornire un controllo programmatico sul rendering del contenuto di un controllo durante l'evento che corrisponde al nome di ogni metodo.
Le classi che derivano da WebPart possono aggiungere WebPartVerb oggetti all'insieme Verbs . Il rendering dei verbi viene eseguito in un menu dei verbi, visualizzato nella barra del titolo di un WebPart controllo. WebPartVerb gli oggetti forniscono semplici elementi dell'interfaccia utente per azioni utente comuni, ad esempio nascondere o ridurre al minimo il controllo o visualizzare la Guida.
Il CreateEditorParts metodo crea una raccolta di tutti i controlli personalizzati EditorPart associati a un WebPart controllo . Gli sviluppatori possono eseguire l'override di questo metodo in modo che crei controlli personalizzati progettati appositamente per modificare il controllo WebPart . Il metodo viene chiamato quando un utente fa clic sul verbo di modifica in un WebPart controllo .
Costruttori
| WebPart() |
Inizializza la classe per l'uso da parte di un'istanza di una classe ereditata. Questo costruttore può essere chiamato solo da una classe ereditata. |
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) |
| AllowClose |
Ottiene o imposta un valore che indica se un utente finale può chiudere un controllo WebPart in una pagina Web. |
| AllowConnect |
Ottiene o imposta un valore che indica se il controllo WebPart consente la creazione di connessioni con altri controlli. |
| AllowEdit |
Ottiene o imposta un valore che indica se un utente finale può modificare un controllo WebPart attraverso l'interfaccia utente fornita da uno o più controlli EditorPart. |
| AllowHide |
Ottiene o imposta un valore che indica se agli utenti finali è consentito nascondere un controllo WebPart. |
| AllowMinimize |
Ottiene o imposta un valore che indica se gli utenti finali possono ridurre a icona un controllo WebPart. |
| AllowZoneChange |
Ottiene o imposta un valore che indica se un utente può spostare un controllo WebPart tra zone WebPartZoneBase. |
| 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) |
| AuthorizationFilter |
Ottiene o imposta una stringa arbitraria per determinare se è stata autorizzata l'aggiunta di un controllo WebPart a una pagina. |
| 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 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) |
| CatalogIconImageUrl |
Ottiene o imposta l'URL di un'immagine che rappresenta un controllo Web part in un catalogo di controlli. |
| ChildControlsCreated |
Ottiene un valore che indica se i controlli figli del controllo server sono stati creati. (Ereditato da Control) |
| ChromeState |
Ottiene o imposta un controllo di parte in stato normale o ridotto a icona. |
| ChromeType |
Ottiene o imposta il tipo di bordo che delimita 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 proprietà ClientID. (Ereditato da Control) |
| ClientIDSeparator |
Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID. (Ereditato da Control) |
| ConnectErrorMessage |
Ottiene un messaggio di errore da visualizzare agli utenti se si verifica un errore durante il processo di connessione. |
| Context |
Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control) |
| Controls |
Ottiene un oggetto ControlCollection che contiene i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da Part) |
| 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) |
| DefaultButton |
Ottiene o imposta l'identificatore per il pulsante predefinito contenuto nel controllo Panel. (Ereditato da Panel) |
| Description |
Ottiene o imposta una breve frase che riepiloga la funzione del controllo di parte da utilizzare nelle descrizioni comando e nei cataloghi dei controlli di 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 orizzontale del flusso del contenuto all'interno del controllo. |
| DisplayTitle |
Ottiene una stringa che contiene il testo completo del titolo effettivamente visualizzato sulla barra del titolo di un'istanza del controllo WebPart. |
| 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) |
| Events |
Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è di sola lettura. (Ereditato da Control) |
| ExportMode |
Ottiene o imposta la possibilità di esportare, tutte, alcune o nessuna delle proprietà di un controllo WebPart. |
| Font |
Ottiene le proprietà del 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 del gruppo di controlli contenuto nel controllo pannello. (Ereditato da Panel) |
| 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) |
| HasSharedData |
Ottiene un valore che indica se a un controllo WebPart sono associati dati sulla personalizzazione condivisi. |
| HasUserData |
Ottiene un valore che indica se a un controllo WebPart sono associati dati sulla personalizzazione. |
| Height |
Ottiene o imposta l'altezza di una zona. |
| HelpMode |
Ottiene o imposta il tipo di interfaccia utente utilizzato per visualizzare la Guida relativa a un controllo WebPart. |
| HelpUrl |
Ottiene o imposta l'URL di una file della Guida relativo a un controllo WebPart. |
| Hidden |
Ottiene o imposta un valore che indica se un controllo WebPart viene visualizzato in una pagina Web. |
| HorizontalAlign |
Ottiene o imposta l'allineamento orizzontale del contenuto all'interno del pannello. (Ereditato da Panel) |
| 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) |
| ImportErrorMessage |
Ottiene o imposta un messaggio di errore utilizzato se si verifica un errore durante l'importazione di un controllo WebPart. |
| IsChildControlStateCleared |
Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo. (Ereditato da Control) |
| IsClosed |
Ottiene un valore che indica se un controllo WebPart viene al momento chiuso in una pagina Web part. |
| IsEnabled |
Ottiene un valore che indica se il controllo è abilitato. (Ereditato da WebControl) |
| IsShared |
Ottiene un valore che indica se un controllo WebPart è condiviso, ovvero se è visibile a tutti gli utenti di una pagina Web part. |
| IsStandalone |
Ottiene un valore che indica se un controllo WebPart è autonomo, vale a dire non contenuto in una zona WebPartZoneBase. |
| IsStatic |
Ottiene un valore che indica se un controllo WebPart è statico, ovvero dichiarato nel markup di una pagina Web part e non aggiunto alla pagina a livello di codice. |
| 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) |
| 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) |
| 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) |
| ScrollBars |
Ottiene o imposta la visibilità e la posizione delle barre di scorrimento in un controllo Panel. (Ereditato da Panel) |
| 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) |
| Subtitle |
Ottiene una stringa concatenata al valore della proprietà Title per creare un titolo completo per un controllo WebPart. |
| 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. (Ereditato da WebControl) |
| 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) |
| Title |
Ottiene o imposta il titolo di un controllo Web part. |
| TitleIconImageUrl |
Ottiene o imposta l'URL di un'immagine utilizzata per rappresentare un controllo Web part sulla barra del titolo del controllo. |
| TitleUrl |
Ottiene o imposta un URL di informazioni supplementari relative a un controllo WebPart. |
| 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) |
| Verbs |
Ottiene un insieme di verbi personalizzati associati a un controllo WebPart. |
| 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) |
| WebBrowsableObject |
Ottiene un riferimento al controllo WebPart per far sì che possa essere modificato dai controlli EditorPart personalizzati. |
| WebPartManager |
Ottiene un riferimento al controllo WebPartManager associato all'istanza di un controllo WebPart. |
| Width |
Ottiene o imposta la larghezza del controllo server Web. |
| Wrap |
Ottiene o imposta un valore che indica se il contenuto va a capo nel pannello. (Ereditato da Panel) |
| Zone |
Ottiene la zona WebPartZoneBase che al momento contiene un controllo WebPart. |
| ZoneIndex |
Ottiene la posizione dell'indice di un controllo WebPart all'interno della zona di appartenenza. |
Metodi
| AddAttributesToRender(HtmlTextWriter) |
Aggiunge all'elenco degli attributi di cui eseguire il rendering informazioni sull'immagine di sfondo, l'allineamento, il ritorno a capo e la direzione. (Ereditato da Panel) |
| 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 un oggetto stile usato internamente dal controllo Panel per implementare tutte le proprietà correlate allo stile. (Ereditato da Panel) |
| CreateEditorParts() |
Restituisce un insieme di controlli EditorPart personalizzati che è possibile utilizzare per modificare un controllo WebPart impostato sulla modalità di modifica. |
| DataBind() |
Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio. (Ereditato da Part) |
| 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) |
| 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) |
Ripristina informazioni sullo stato della visualizzazione da una richiesta precedente salvata con il metodo SaveViewState(). (Ereditato da WebControl) |
| 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) |
| OnClosing(EventArgs) |
Consente alle classi derivate di fornire una gestione personalizzata quando un controllo WebPart viene chiuso in una pagina Web part. |
| OnConnectModeChanged(EventArgs) |
Consente alle classi derivate di fornire una gestione personalizzata quando un controllo WebPart inizia o termina il processo di connessione ad altri controlli. |
| OnDataBinding(EventArgs) |
Genera l'evento DataBinding. (Ereditato da Control) |
| OnDeleting(EventArgs) |
Consente alle classi derivate di fornire una gestione personalizzata quando un controllo WebPart viene rimosso definitivamente da una pagina Web part. |
| OnEditModeChanged(EventArgs) |
Consente alle classe derivate di fornire una gestione personalizzata quando un controllo WebPart entra o esce dalla modalità di modifica. |
| 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 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) |
| RemovedControl(Control) |
Chiamato dopo che un controllo figlio viene rimosso dalla raccolta 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 HTML di apertura del controllo Panel nel writer specificato. (Ereditato da Panel) |
| 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 del contenuto del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| 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 Panel nel writer specificato. (Ereditato da Panel) |
| 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 qualsiasi stato modificato dopo la chiamata del metodo TrackViewState(). (Ereditato da WebControl) |
| SetDesignModeState(IDictionary) |
Imposta i dati della fase di progettazione per un controllo. (Ereditato da Control) |
| SetPersonalizationDirty() |
Imposta un flag che indica che i dati di personalizzazione dell'istanza del controllo WebPart corrente sono stati modificati. |
| SetPersonalizationDirty(Control) |
Imposta un flag che indica che i dati di personalizzazione sono stati modificati per il controllo server specificato presente in una zona WebPartZoneBase. |
| 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() |
Indica al controllo di tenere traccia delle modifiche apportate allo proprio stato di visualizzazione in modo che tali modifiche possano essere archiviate nella proprietà ViewState dell'oggetto. |
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 allo sviluppatore di una finestra di progettazione per un controllo di parte composito di creare nuovamente i controlli figlio sull'area di progettazione. (Ereditato da Part) |
| 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 dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere: https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per