WebPart Classe

Definizione

Spazio dei nomi:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

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 alla classe base Part alcune proprietà aggiuntive 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à: Object

Control

WebControl

Panel

Part
WebPart

Derivato: System.Web.UI.WebControls.WebParts.GenericWebPart

System.Web.UI.WebControls.WebParts.ProxyWebPart

Implementazioni: IWebActionable IWebEditable IWebPart

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, inserirlo in una sottocartella Bin dell'applicazione Web e fare 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 di ASP.NET esistenti, i controlli server personalizzati e i controlli utente possono essere tutti dotati di funzionalità web part complete 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 di 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à , AllowEdit AllowMinimize AllowConnect AllowHidee 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à , ChromeType ChromeState, Description Title HelpUrl Height TitleIconImageUrl TitleUrl Hiddene 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à come 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 all'interno di una WebZone sola volta alla volta.

Annotazioni

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 univoche dei WebPart controlli. La AuthorizationFilter proprietà consente agli sviluppatori di impostare una stringa arbitraria che può essere utilizzata 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 visualizzazioni 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 una zona 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 corrispondente 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 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 modificarne il WebPart controllo. Il metodo viene chiamato quando un utente fa clic sul verbo di modifica in un WebPart controllo .

Costruttori

Nome	Descrizione
WebPart()	Inizializza la classe per l'uso da parte di un'istanza della classe ereditata. Questo costruttore può essere chiamato solo da una classe ereditata.

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)
AllowClose	Ottiene o imposta un valore che indica se un utente finale può chiudere un WebPart controllo in una pagina Web.
AllowConnect	Ottiene o imposta un valore che indica se il WebPart controllo consente ad altri controlli di formare connessioni.
AllowEdit	Ottiene o imposta un valore che indica se un utente finale può modificare un WebPart controllo tramite l'interfaccia utente fornita da uno o più EditorPart controlli.
AllowHide	Ottiene o imposta un valore che indica se gli utenti finali possono nascondere un WebPart controllo.
AllowMinimize	Ottiene o imposta un valore che indica se gli utenti finali possono ridurre al minimo un WebPart controllo.
AllowZoneChange	Ottiene o imposta un valore che indica se un utente può spostare un WebPart controllo tra WebPartZoneBase le zone.
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)
AuthorizationFilter	Ottiene o imposta una stringa arbitraria per determinare se un WebPart controllo è autorizzato ad essere aggiunto 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 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)
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 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)
ConnectErrorMessage	Ottiene un messaggio di errore da visualizzare agli utenti se si verificano errori 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 ControlCollection oggetto 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 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 orizzontale che il contenuto scorre all'interno del controllo.
DisplayTitle	Ottiene una stringa contenente il testo completo del titolo effettivamente visualizzato nella barra del titolo di un'istanza WebPart del controllo.
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)
ExportMode	Ottiene o imposta un valore che indica se è possibile esportare tutte, alcune o nessuna delle proprietà di un WebPart controllo.
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)
HasSharedData	Ottiene un valore che indica se a un WebPart controllo sono associati dati di personalizzazione condivisi.
HasUserData	Ottiene un valore che indica se a un WebPart controllo sono associati dati di personalizzazione utente.
Height	Ottiene o imposta l'altezza di una zona.
HelpMode	Ottiene o imposta il tipo di interfaccia utente utilizzato per visualizzare il contenuto della Guida per un WebPart controllo.
HelpUrl	Ottiene o imposta l'URL di un file della Guida per un WebPart controllo .
Hidden	Ottiene o imposta un valore che indica se un WebPart controllo 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 programmatico 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 verificano errori quando viene importato un WebPart controllo.
IsChildControlStateCleared	Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo hanno uno stato di controllo. (Ereditato da Control)
IsClosed	Ottiene un valore che indica se un WebPart controllo è attualmente 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 WebPart controllo è condiviso, ovvero è visibile a tutti gli utenti di una pagina web part.
IsStandalone	Ottiene un valore che indica se un WebPart controllo è autonomo, ovvero che non è contenuto all'interno di una WebPartZoneBase zona.
IsStatic	Ottiene un valore che indica se un WebPart controllo è un controllo statico, ovvero il controllo viene 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 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)
Subtitle	Ottiene una stringa concatenata con il valore della Title proprietà per formare un titolo completo per un WebPart controllo.
SupportsDisabledAttribute	Ottiene un valore che indica se il controllo deve impostare l'attributo dell'elemento `disabled` HTML sottoposto a rendering su "disabled" quando la proprietà del IsEnabled controllo è `false`. (Ereditato da Panel)
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.
TitleIconImageUrl	Ottiene o imposta l'URL di un'immagine utilizzata per rappresentare un controllo Web part nella barra del titolo del controllo.
TitleUrl	Ottiene o imposta un URL per informazioni supplementari su un WebPart controllo .
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)
Verbs	Ottiene una raccolta di verbi personalizzati associati a un WebPart controllo .
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)
WebBrowsableObject	Ottiene un riferimento al WebPart controllo per consentirne la modifica da parte di controlli personalizzati EditorPart .
WebPartManager	Ottiene un riferimento al controllo associato a un'istanza WebPartManager del WebPart controllo.
Width	Ottiene o imposta la larghezza del controllo server Web.
Wrap	Ottiene o imposta un valore che indica se il contenuto viene disposto all'interno del pannello. (Ereditato da Panel)
Zone	Ottiene la WebPartZoneBase zona che contiene attualmente un WebPart controllo .
ZoneIndex	Ottiene la posizione di indice di un WebPart controllo all'interno della relativa zona.

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 `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 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)
CreateEditorParts()	Restituisce un insieme di controlli personalizzati EditorPart che possono essere utilizzati per modificare un WebPart controllo quando è in modalità di modifica.
DataBind()	Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. (Ereditato da Part)
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 `id` e un numero intero, specificato nel `pathOffset` parametro , che facilita la ricerca. Non è consigliabile eseguire l'override di questa versione del FindControl metodo . (Ereditato da Control)
FindControl(String)	Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato `id` . (Ereditato da Control)
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)
OnClosing(EventArgs)	Consente alle classi derivate di fornire una gestione personalizzata quando un WebPart controllo viene chiuso in una pagina web part.
OnConnectModeChanged(EventArgs)	Consente alle classi derivate di fornire una gestione personalizzata quando un WebPart controllo 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 WebPart controllo viene rimosso definitivamente da una pagina web part.
OnEditModeChanged(EventArgs)	Consente alle classi derivate di fornire una gestione personalizzata quando un WebPart controllo entra o lascia la 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 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)
SetPersonalizationDirty()	Imposta un flag che indica che i dati di personalizzazione sono stati modificati per l'istanza del controllo corrente WebPart .
SetPersonalizationDirty(Control)	Imposta un flag che indica che i dati di personalizzazione sono stati modificati per il controllo server specificato che risiede in una WebPartZoneBase zona.
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 .

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

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.

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?