Condividi tramite


WebPart Classe

Definizione

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::IWebPart
public 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.IWebPart
type WebPart = class
    inherit Part
    interface IWebPart
    interface IWebActionable
    interface IWebEditable
Public 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 disabled dell'elemento HTML di cui è stato eseguito il rendering su "disabilitato" quando la proprietà IsEnabled del controllo è false.

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

(Ereditato da Control)
ClearChildControlState()

Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server.

(Ereditato da Control)
ClearChildState()

Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server.

(Ereditato da Control)
ClearChildViewState()

Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server.

(Ereditato da Control)
ClearEffectiveClientIDMode()

Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit.

(Ereditato da Control)
CopyBaseAttributes(WebControl)

Copia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web dal quale è stato chiamato il metodo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
CreateChildControls()

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

(Ereditato da Control)
CreateControlCollection()

Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server.

(Ereditato da Control)
CreateControlStyle()

Crea 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 id specificato.

(Ereditato da Control)
FindControl(String, Int32)

Cerca nel contenitore di denominazione corrente un controllo server con il parametro id indicato e un intero, specificato nel parametro pathOffset, che agevola la ricerca. Non eseguire l'override di questa versione del metodo FindControl.

(Ereditato da Control)
Focus()

Imposta lo stato attivo per l'input su un controllo.

(Ereditato da Control)
GetDesignModeState()

Ottiene i dati della fase di progettazione per un controllo.

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