Condividi tramite


EditorZone Classe

Definizione

Funge da controllo primario nell'insieme di controlli web part per l'hosting dei controlli EditorPart in una pagina Web.

public ref class EditorZone : System::Web::UI::WebControls::WebParts::EditorZoneBase
public class EditorZone : System.Web.UI.WebControls.WebParts.EditorZoneBase
type EditorZone = class
    inherit EditorZoneBase
Public Class EditorZone
Inherits EditorZoneBase
Ereditarietà

Esempio

Nell'esempio di codice seguente vengono illustrati diversi usi dichiarativi e programmatici della EditorZone classe . Nell'esempio viene creata una zona dell'editor EditorZone personalizzata che eredita dalla classe e la usa in una pagina Web part.

L'esempio di codice include tre parti:

  • Controllo utente che consente di modificare le modalità di visualizzazione nella pagina Web.

  • Pagina Web che fa riferimento al controllo personalizzato EditorZone .

  • Spiegazione del funzionamento dell'esempio.

La prima parte di questo esempio di codice è il controllo utente che consente agli utenti di modificare le modalità di visualizzazione in una pagina Web. Per altre informazioni sulle modalità di visualizzazione e una descrizione del codice sorgente in questo controllo, vedere Procedura dettagliata: Modifica delle modalità di visualizzazione in una pagina web part.

<%@ control language="C#" classname="DisplayModeMenuCS"%>

<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName + " Mode", modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, 
    EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;

  }

  void Page_PreRender(object sender, EventArgs e)
  {
    DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name;
  }
  
</script>
<div>
  <asp:DropDownList ID="DisplayModeDropdown" 
    runat="server"  
    AutoPostBack="true" 
    OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>

<script runat="server">
  
' Use a field to reference the current WebPartManager.
Dim _manager As WebPartManager


Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs) 
    AddHandler Page.InitComplete, AddressOf InitComplete

End Sub 


Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs) 
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
    
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
    
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In  _manager.SupportedDisplayModes
        Dim modeName As String = mode.Name
        ' Make sure a mode is enabled before adding it.
        If mode.IsEnabled(_manager) Then
            Dim item As New ListItem(modeName + " Mode", modeName)
            DisplayModeDropdown.Items.Add(item)
        End If
    Next mode

End Sub 
 

' Change the page to the selected display mode.
Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs) 
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue
    
    Dim mode As WebPartDisplayMode = _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
        _manager.DisplayMode = mode
    End If
 
End Sub 


Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs) 
    DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name

End Sub 

</script>
<div>
  <asp:DropDownList ID="DisplayModeDropdown" 
    runat="server"  
    AutoPostBack="true" 
    OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</div>

La seconda parte dell'esempio di codice è una pagina Web. Nella parte superiore della pagina è presente una Register direttiva per il controllo utente. Il tag del controllo utente viene dichiarato nella pagina con un uc1: prefisso per l'elemento . Si noti che sotto l'elemento <asp:WebPartZone> è presente un <asp:EditorZone> elemento che contiene diversi EditorPart controlli, con alcuni tag e proprietà impostati per determinarne l'aspetto e il comportamento. Esistono anche diversi metodi che accedono a vari membri del EditorZone controllo a livello di codice.

<%@ Page Language="C#" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuCS" 
  src="displaymodecs.ascx" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  // <snippet3>

  void Button1_Click(object sender, EventArgs e)
  {
    if (EditorZone1.ApplyVerb.Enabled == true)
      EditorZone1.ApplyVerb.Enabled = false;
    else
      EditorZone1.ApplyVerb.Enabled = true;
  }

  void Button2_Click(object sender, EventArgs e)
  {
    EditorZone1.BorderWidth = 2;
    EditorZone1.BorderColor = System.Drawing.Color.DarkBlue;
  }

  void Button3_Click(object sender, EventArgs e)
  {
    Label1.Text = "<br />";
    foreach (EditorPart part in EditorZone1.EditorParts)
    {
      Label1.Text += part.ID + "<br />";
    }
  }

  void Button4_Click(object sender, EventArgs e)
  {
    EditorZone1.InstructionText = "My custom instruction text.";
  }
  // </snippet3>
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>EditorZoneBase Examples</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="mgr" runat="server" />
    <uc1:DisplayModeMenuCS runat="server" id="displaymodemenu1" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <asp:Calendar ID="Calendar1" Runat="server" 
          Title="My Calendar" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <asp:EditorZone ID="EditorZone1" runat="server" >
      <VerbStyle Font-Italic="true" />
      <EditUIStyle BackColor="lightgray" />
      <PartChromeStyle BorderWidth="1" />
      <LabelStyle Font-Bold="true" />
      <CancelVerb Text="Cancel Changes" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Enable or Disable Apply" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Set Zone BorderColor" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorPart Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Set Instruction Text" OnClick="Button4_Click" /> 
  </form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuVB" 
  src="displaymodevb.ascx" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  ' <snippet3>

  Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
    If EditorZone1.ApplyVerb.Enabled = True Then
      EditorZone1.ApplyVerb.Enabled = False
    Else
      EditorZone1.ApplyVerb.Enabled = True
    End If
  End Sub
 
  Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
    EditorZone1.BorderWidth = 2
    EditorZone1.BorderColor = System.Drawing.Color.DarkBlue
  End Sub

  Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
    Label1.Text = "<br />"
    Dim part As EditorPart
    For Each part In EditorZone1.EditorParts
      Label1.Text += part.ID + "<br />"
    Next part
  End Sub

  Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
    EditorZone1.InstructionText = "My custom instruction text."
  End Sub
  ' </snippet3>
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>EditorZoneBase Examples</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="mgr" runat="server" />
    <uc1:DisplayModeMenuVB runat="server" id="displaymodemenu1" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <asp:Calendar ID="Calendar1" Runat="server" 
          Title="My Calendar" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <asp:EditorZone ID="EditorZone1" runat="server" >
      <VerbStyle Font-Italic="true" />
      <EditUIStyle BackColor="lightgray" />
      <PartChromeStyle BorderWidth="1" />
      <LabelStyle Font-Bold="true" />
      <CancelVerb Text="Cancel Changes" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Enable or Disable Apply" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Set Zone BorderColor" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorPart Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Set Instruction Text" OnClick="Button4_Click" /> 
  </form>
</body>
</html>

Quando si carica la pagina in un browser, è possibile selezionare Modalità di modifica nell'elenco a discesa per passare alla modalità di modifica. Per visualizzare l'interfaccia utente di modifica, è possibile fare clic sul menu verbi (freccia verso il basso) nella barra del titolo di uno dei due controlli e fare clic su Modifica per modificare il controllo. Con l'interfaccia utente di modifica visibile, è possibile visualizzare gli effetti degli usi dichiarativi e programmatici dei membri della EditorZone classe.

Commenti

All'interno del set di controlli Web part, una zona è un controllo composito che copre un'area definita in una pagina Web e contiene controlli server. Le funzioni principali di una zona devono disporre i controlli contenuti e fornire un'interfaccia utente comune per tali controlli. Per informazioni generali sulle zone e sul modo in cui vengono usati nelle applicazioni Web part, vedere la documentazione di riferimento per la classe di base WebZone e Panoramica del set di controlli Web part.

Il EditorZone controllo è uno dei controlli fondamentali del set di controlli Web part. Una funzionalità chiave delle web part è la possibilità degli utenti finali di modificare (o personalizzare) le pagine Web in base alle proprie preferenze e di salvare le impostazioni personalizzate per le sessioni future del browser. Un aspetto della modifica delle pagine web part include la modifica; gli utenti possono modificare l'aspetto, il layout, il comportamento e altre proprietà dei controlli visibili WebPart . Diversi controlli nel set di controlli Web part forniscono le funzionalità di modifica, incluso il EditorZone controllo .

Un EditorZone controllo diventa visibile quando una pagina Web part entra in modalità di modifica e rende disponibili vari EditorPart controlli che possono essere usati per personalizzare WebPart i controlli. Il EditorZone controllo è molto simile al relativo padre, la EditorZoneBase classe , con una differenza chiave: il EditorZone controllo fornisce un modello di zona, a cui fa riferimento nella relativa ZoneTemplate proprietà. Il modello di zona aggiunge la possibilità di dichiarare il contenuto nel formato di persistenza della pagina. Gli sviluppatori di pagine possono inserire un EditorZone controllo nel markup dichiarativo di una pagina Web, aggiungere un elemento figlio <zonetemplate> e all'interno dell'elemento <zonetemplate> aggiungere riferimenti dichiarativi ai EditorPart controlli.

Il EditorZone controllo include anche un metodo , CreateEditorParts, che esegue l'override di un metodo di base nella EditorZoneBase classe . Questo metodo è necessario in modo che un EditorZone controllo possa creare il modello di zona per contenere tutti i EditorPart controlli aggiunti alla zona in modo dichiarativo.

Nota

I pulsanti nell'interfaccia EditorZone utente richiedono script sul lato client per funzionare correttamente. Se lo scripting è disabilitato nel browser, l'utente non sarà in grado di eseguire azioni tramite l'interfaccia EditorZone utente.

Accessibilità

Il markup sottoposto a rendering per impostazione predefinita per questo controllo potrebbe non essere conforme agli standard di accessibilità, ad esempio le linee guida per l'accessibilità del contenuto Web 1.0 (WCAG) con priorità 1. Per informazioni dettagliate sul supporto dell'accessibilità per questo controllo, vedere ASP.NET Controlli e accessibilità.

Note per gli eredi

Se si vuole creare una zona personalizzata EditorZone per ottenere un maggiore controllo sul rendering dell'interfaccia utente di modifica, è possibile ereditare direttamente dalla EditorZoneBase classe, purché non sia necessario fornire supporto per i modelli di zona per gli sviluppatori di pagine per aggiungere EditorPart controlli alla zona in modo dichiarativo. In questo caso, si aggiungerebbero tutti i EditorPart controlli a una zona a livello di codice. Se si vuole fornire il supporto del modello di zona, è necessario ereditare dalla EditorZone classe .

Costruttori

EditorZone()

Inizializza una nuova istanza della classe EditorZone.

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)
ApplyVerb

Ottiene un riferimento a un oggetto WebPartVerb che consente agli utenti finali di applicare le modifiche a un controllo in modalità di modifica.

(Ereditato da EditorZoneBase)
AppRelativeTemplateSourceDirectory

Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo.

(Ereditato da Control)
AssociatedDisplayModes

Ottiene l'insieme di oggetti WebPartDisplayMode associati a una particolare zona ToolZone.

(Ereditato da ToolZone)
Attributes

Ottiene l'insieme di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo.

(Ereditato da WebControl)
BackColor

Ottiene o imposta il colore di sfondo del controllo server Web.

(Ereditato da WebControl)
BackImageUrl

Ottiene o imposta l'URL di un'immagine di sfondo per una zona.

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

Ottiene un riferimento a un oggetto WebPartVerb che consente agli utenti finali di annullare le modifiche apportate a un controllo in modalità di modifica.

(Ereditato da EditorZoneBase)
ChildControlsCreated

Ottiene un valore che indica se i controlli figli del controllo server sono stati creati.

(Ereditato da Control)
ClientID

Ottiene l'ID di controllo per il markup HTML generato da ASP.NET.

(Ereditato da Control)
ClientIDMode

Ottiene o imposta l'algoritmo utilizzato per generare il valore della proprietà ClientID.

(Ereditato da Control)
ClientIDSeparator

Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID.

(Ereditato da Control)
Context

Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente.

(Ereditato da Control)
Controls

Ottiene un oggetto ControlCollection che rappresenta i controlli figlio di un oggetto CompositeControl.

(Ereditato da CompositeControl)
ControlStyle

Ottiene lo stile del controllo server Web. Questa proprietà viene usata principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
ControlStyleCreated

Ottiene un valore che indica se è stato creato un oggetto Style per la proprietà ControlStyle. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
CssClass

Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client.

(Ereditato da WebControl)
DataItemContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer.

(Ereditato da Control)
DataKeysContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl.

(Ereditato da Control)
DesignMode

Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione.

(Ereditato da Control)
Display

Ottiene un valore che indica se un controllo ToolZone è attualmente visualizzato.

(Ereditato da EditorZoneBase)
EditorPartChrome

Ottiene un riferimento all'istanza della classe EditorPartChrome associata alla zona EditorZoneBase.

(Ereditato da EditorZoneBase)
EditorParts

Ottiene un insieme di tutti i controlli EditorPart contenuti in una zona EditorZoneBase.

(Ereditato da EditorZoneBase)
EditUIStyle

Ottiene gli attributi di stile per i controlli modificabili contenuti in un controllo ToolZone.

(Ereditato da ToolZone)
EmptyZoneText

Ottiene o imposta un messaggio che viene visualizzato quando un'area non contiene controlli.

(Ereditato da EditorZoneBase)
EmptyZoneTextStyle

Ottiene gli attributi di stile per il testo segnaposto in una zona vuota.

(Ereditato da WebZone)
Enabled

Ottiene o imposta un valore che indica se il controllo server Web è abilitato.

(Ereditato da WebControl)
EnableTheming

Ottiene o imposta un valore che indica se al controllo vengono applicati i temi.

(Ereditato da WebControl)
EnableViewState

Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente.

(Ereditato da Control)
ErrorStyle

Ottiene gli attributi di stile per il rendering del messaggio di errore visualizzato se non è possibile caricare o creare un controllo WebPart.

(Ereditato da WebZone)
ErrorText

Ottiene o imposta il testo di un messaggio di errore a livello di zona da visualizzare nella parte superiore dell'interfaccia utente di modifica.

(Ereditato da EditorZoneBase)
Events

Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è di sola lettura.

(Ereditato da Control)
Font

Ottiene le proprietà del carattere associate al controllo server Web.

(Ereditato da WebControl)
FooterStyle

Ottiene gli attributi di stile per il contenuto dell'area di piè di pagina di una zona.

(Ereditato da WebZone)
ForeColor

Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web.

(Ereditato da WebControl)
HasAttributes

Ottiene un valore che indica se sono impostati attributi per il controllo.

(Ereditato da WebControl)
HasChildViewState

Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate.

(Ereditato da Control)
HasFooter

Ottiene un valore che indica se una zona comprende o meno un'area di piè di pagina.

(Ereditato da WebZone)
HasHeader

Ottiene un valore che indica se una zona comprende un'area di intestazione.

(Ereditato da WebZone)
HeaderCloseVerb

Ottiene un riferimento all'oggetto WebPartVerb nell'intestazione di un controllo ToolZone utilizzato per chiudere il controllo.

(Ereditato da ToolZone)
HeaderStyle

Ottiene gli attributi di stile per il contenuto dell'area di intestazione di una zona.

(Ereditato da WebZone)
HeaderText

Ottiene o imposta il testo dell'area di intestazione di un'area.

(Ereditato da EditorZoneBase)
HeaderVerbStyle

Ottiene gli attributi di stile per tutti i verbi di intestazione visualizzati in un controllo ToolZone.

(Ereditato da ToolZone)
Height

Ottiene o imposta l'altezza del controllo server Web.

(Ereditato da WebControl)
ID

Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server.

(Ereditato da Control)
IdSeparator

Ottiene il carattere utilizzato per separare gli identificatori di controllo.

(Ereditato da Control)
InstructionText

Ottiene o imposta il testo in un controllo ToolZone che fornisce le indicazioni per gli utenti finali.

(Ereditato da EditorZoneBase)
InstructionTextStyle

Ottiene gli attributi di stile per il testo di istruzioni che appare nella parte superiore di un controllo ToolZone.

(Ereditato da ToolZone)
IsChildControlStateCleared

Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo.

(Ereditato da Control)
IsEnabled

Ottiene un valore che indica se il controllo è abilitato.

(Ereditato da WebControl)
IsTrackingViewState

Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione.

(Ereditato da Control)
IsViewStateEnabled

Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente.

(Ereditato da Control)
LabelStyle

Ottiene gli attributi di stile per il contenuto delle etichette che appaiono accanto ai controlli di modifica all'interno di un controllo ToolZone. I controlli ToolZone derivati, ad esempio CatalogZone e EditorZone, applicano gli stili alle etichette.

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

Ottiene un riferimento a un oggetto WebPartVerb che applica le modifiche a un controllo in modalità di modifica e nasconde l'interfaccia utente di modifica.

(Ereditato da EditorZoneBase)
Padding

Ottiene o imposta gli attributi di spaziatura interna delle celle sulla tabella che contiene i controlli WebPart in una zona.

(Ereditato da WebZone)
Page

Ottiene un riferimento all'istanza Page che contiene il controllo server.

(Ereditato da Control)
Parent

Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina.

(Ereditato da Control)
PartChromePadding

Ottiene o imposta la distanza tra il contenuto di un controllo WebPart e il bordo del controllo.

(Ereditato da WebZone)
PartChromeStyle

Ottiene le caratteristiche di stile applicabili ai bordi dei controlli Web part contenuti in una zona.

(Ereditato da WebZone)
PartChromeType

Ottiene o imposta il tipo di bordo che delimita i controlli Web part contenuti in una zona.

(Ereditato da WebZone)
PartStyle

Ottiene le caratteristiche di stile applicabili al bordo e al contenuto di ogni controllo Web part contenuto in una zona.

(Ereditato da WebZone)
PartTitleStyle

Ottiene gli attributi di stile relativi al contenuto della barra del titolo per ogni controllo Web part contenuto in una zona.

(Ereditato da WebZone)
RenderClientScript

Ottiene un valore che indica se eseguire o meno il rendering dello script client su una pagina Web part.

(Ereditato da WebZone)
RenderingCompatibility

Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering.

(Ereditato da Control)
Site

Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione.

(Ereditato da Control)
SkinID

Ottiene o imposta l'interfaccia personalizzata da applicare al controllo.

(Ereditato da WebControl)
Style

Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web.

(Ereditato da WebControl)
SupportsDisabledAttribute

Ottiene un valore che indica se il controllo deve impostare l'attributo disabled dell'elemento HTML di cui è stato eseguito il rendering su "disabilitato" quando la proprietà IsEnabled del controllo è false.

(Ereditato da CompositeControl)
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 WebZone)
TagName

Ottiene il nome del tag del controllo. Questa proprietà viene usata principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
TemplateControl

Ottiene o imposta un riferimento al modello che contiene il controllo.

(Ereditato da Control)
TemplateSourceDirectory

Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente.

(Ereditato da Control)
ToolTip

Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web.

(Ereditato da WebControl)
UniqueID

Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server.

(Ereditato da Control)
ValidateRequestMode

Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser.

(Ereditato da Control)
VerbButtonType

Ottiene o imposta il tipo di pulsante da utilizzare per rappresentare i verbi in una zona.

(Ereditato da WebZone)
VerbStyle

Ottiene gli attributi di stile per i verbi dell'interfaccia utente associati ai controlli Web part di una zona.

(Ereditato da WebZone)
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 un controllo server viene o meno sottoposto a rendering come elemento dell'interfaccia utente nella pagina.

(Ereditato da ToolZone)
WebPartManager

Ottiene un riferimento al controllo WebPartManager associato a un'istanza del controllo WebZone in una pagina Web part.

(Ereditato da WebZone)
WebPartToEdit

Ottiene un riferimento al controllo WebPart in corso di modifica.

(Ereditato da EditorZoneBase)
Width

Ottiene o imposta la larghezza del controllo server Web.

(Ereditato da WebControl)
ZoneTemplate

Fornisce un modello che contiene controlli figlio all'interno di un controllo EditorZone in un formato di persistenza della pagina.

Metodi

AddAttributesToRender(HtmlTextWriter)

Aggiunge attributi e stili HTML dei quali è necessario eseguire il rendering nell'oggetto HtmlTextWriterTag specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
AddedControl(Control, Int32)

Chiamato dopo che un controllo figlio viene aggiunto alla raccolta Controls dell'oggetto Control.

(Ereditato da Control)
AddParsedSubObject(Object)

Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server.

(Ereditato da Control)
ApplyStyle(Style)

Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, sovrascrivendo eventuali elementi di stile del controllo. Il metodo viene utilizzato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
ApplyStyleSheetSkin(Page)

Applica al controllo le proprietà di stile definite nel foglio di stile della pagina.

(Ereditato da Control)
BeginRenderTracing(TextWriter, Object)

Inizia la traccia in fase di progettazione dei dati di rendering.

(Ereditato da Control)
BuildProfileTree(String, Boolean)

Raccoglie informazioni sul controllo server e le recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina.

(Ereditato da Control)
ClearCachedClientID()

Imposta il valore memorizzato nella cache ClientID su 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)
Close()

Questo metodo, chiamato quando un utente fa clic su un verbo di chiusura nell'intestazione di una zona, termina il processo di modifica dei controlli WebPart e reimposta la modalità di visualizzazione della pagina Web part sulla modalità browse.

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

Crea il set dei controlli figlio associati a una zona EditorZoneBase.

(Ereditato da EditorZoneBase)
CreateControlCollection()

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

(Ereditato da Control)
CreateControlStyle()

Crea l'oggetto di stile utilizzato internamente dalla classe WebControl per implementare tutte le proprietà correlate allo stile. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
CreateEditorPartChrome()

Ottiene un riferimento a un nuovo oggetto EditorPartChrome utilizzato per eseguire il rendering degli elementi di interfaccia periferici intorno a una zona EditorZoneBase.

(Ereditato da EditorZoneBase)
CreateEditorParts()

Crea tutti i controlli EditorPart dichiarati in un modello di zona nel formato di persistenza della pagina.

DataBind()

Associa un'origine dati al controllo CompositeControl e a tutti i relativi controlli figlio.

(Ereditato da CompositeControl)
DataBind(Boolean)

Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding.

(Ereditato da Control)
DataBindChildren()

Associa un'origine dati al controllo server e ai relativi controlli figlio.

(Ereditato da Control)
Dispose()

Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria.

(Ereditato da Control)
EndRenderTracing(TextWriter, Object)

Termina la traccia in fase di progettazione dei dati di rendering.

(Ereditato da Control)
EnsureChildControls()

Determina se il controllo server contiene controlli figlio. In caso contrario, li crea.

(Ereditato da Control)
EnsureID()

Crea un identificatore per i controlli a cui non è assegnato alcun identificatore.

(Ereditato da Control)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
FindControl(String)

Cerca un controllo server nel contenitore dei nomi corrente con il parametro 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)
GetEffectiveChromeType(Part)

Restituisce il valore PartChromeType corrente effettivo di un controllo WebPart, una volta specificate la proprietà PartChromeType della zona e la modalità di visualizzazione corrente della pagina Web part.

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

Imposta l'insieme di controlli EditorPart associati a una zona EditorZoneBase su null. In tal modo, il metodo CreateEditorParts() viene chiamato per ricreare l'insieme.

(Ereditato da EditorZoneBase)
IsLiteralContent()

Determina se il controllo server conserva solo il contenuto literal.

(Ereditato da Control)
LoadControlState(Object)

Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState().

(Ereditato da Control)
LoadViewState(Object)

Carica le informazioni sullo stato precedentemente salvate per una zona.

(Ereditato da EditorZoneBase)
MapPathSecure(String)

Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo.

(Ereditato da Control)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
MergeStyle(Style)

Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, ma non sovrascrive eventuali elementi di stile del controllo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
OnBubbleEvent(Object, EventArgs)

Determina se l'evento per il controllo server viene passato a un livello superiore nella gerarchia dei controlli server dell'interfaccia utente per la pagina.

(Ereditato da Control)
OnDataBinding(EventArgs)

Genera l'evento DataBinding.

(Ereditato da Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Genera l'evento DisplayModeChanged e distrugge tutti i controlli EditorPart e i controlli figlio nella zona in preparazione dell'entrata o dell'uscita di una pagina Web dalla modalità di modifica.

(Ereditato da EditorZoneBase)
OnInit(EventArgs)

Crea gestori di eventi specializzati utilizzati dal controllo WebPartManager in una pagina Web.

(Ereditato da ToolZone)
OnLoad(EventArgs)

Genera l'evento Load.

(Ereditato da Control)
OnPreRender(EventArgs)

Genera l'evento PreRender e chiama il metodo PerformPreRender() per gli elementi del colore dei controlli EditorPart.

(Ereditato da EditorZoneBase)
OnSelectedWebPartChanged(Object, WebPartEventArgs)

Genera l'evento SelectedWebPartChanged e imposta l'insieme EditorParts su null nella zona in preparazione all'entrata o all'uscita del controllo WebPart dalla modalità di modifica.

(Ereditato da EditorZoneBase)
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)
RaisePostBackEvent(String)

Esegue le azioni associate a uno dei verbi di zona oppure genera un evento che esegue il postback al server.

(Ereditato da EditorZoneBase)
RecreateChildControls()

Ricrea i controlli figlio in un controllo derivato da CompositeControl.

(Ereditato da CompositeControl)
RemovedControl(Control)

Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control.

(Ereditato da Control)
Render(HtmlTextWriter)

Esegue il rendering della zona sull'oggetto HtmlTextWriter specificato.

(Ereditato da EditorZoneBase)
RenderBeginTag(HtmlTextWriter)

Esegue il rendering del tag HTML di apertura del controllo zona nell'oggetto HtmlTextWriter specificato.

(Ereditato da WebZone)
RenderBody(HtmlTextWriter)

Esegue l'override del metodo base per eseguire il rendering dell'area del corpo di una zona derivata dalla classe EditorZoneBase.

(Ereditato da EditorZoneBase)
RenderChildren(HtmlTextWriter)

Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto HtmlTextWriter specificato, che scrive il contenuto di cui eseguire il rendering nel client.

(Ereditato da Control)
RenderContents(HtmlTextWriter)

Esegue il rendering dell'intero contenuto di un controllo zona compreso tra il tag di inizio e quello di fine sull'oggetto HtmlTextWriter specificato.

(Ereditato da WebZone)
RenderControl(HtmlTextWriter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata.

(Ereditato da Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato.

(Ereditato da Control)
RenderEndTag(HtmlTextWriter)

Esegue il rendering del tag HTML di chiusura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
RenderFooter(HtmlTextWriter)

Esegue l'override del metodo base per il rendering dei verbi nel piè di pagina di un controllo ToolZone.

(Ereditato da ToolZone)
RenderHeader(HtmlTextWriter)

Esegue l'override del metodo base per fornire il rendering specializzato per l'area di intestazione richiesto dai controlli ToolZone.

(Ereditato da ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)

Esegue il rendering di un singolo verbo con un controllo ToolZone.

(Ereditato da ToolZone)
RenderVerbs(HtmlTextWriter)

Esegue il rendering dei verbi applicabili a livello di zona.

(Ereditato da EditorZoneBase)
ResolveAdapter()

Ottiene l'adattatore del controllo responsabile del rendering del controllo specificato.

(Ereditato da Control)
ResolveClientUrl(String)

Ottiene un URL che può essere utilizzato dal browser.

(Ereditato da Control)
ResolveUrl(String)

Converte un URL in un formato utilizzabile dal client richiedente.

(Ereditato da Control)
SaveControlState()

Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server.

(Ereditato da Control)
SaveViewState()

Salva tutte le modifiche dello stato di visualizzazione avvenute dopo il reinserimento di una pagina nel server.

(Ereditato da EditorZoneBase)
SetDesignModeState(IDictionary)

Imposta i dati della fase di progettazione per un controllo.

(Ereditato da Control)
SetRenderMethodDelegate(RenderMethod)

Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre.

(Ereditato da Control)
SetTraceData(Object, Object)

Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia.

(Ereditato da Control)
SetTraceData(Object, Object, Object)

Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia.

(Ereditato da Control)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
TrackViewState()

Tiene traccia delle modifiche apportate allo stato di visualizzazione di un controllo zona.

(Ereditato da EditorZoneBase)

Eventi

DataBinding

Viene generato quando il controllo server viene associato a un'origine dati.

(Ereditato da Control)
Disposed

Si verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET.

(Ereditato da Control)
Init

Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata.

(Ereditato da Control)
Load

Viene generato quando il controllo server è caricato nell'oggetto Page.

(Ereditato da Control)
PreRender

Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering.

(Ereditato da Control)
Unload

Viene generato quando il controllo server viene scaricato dalla memoria.

(Ereditato da Control)

Implementazioni dell'interfaccia esplicita

IAttributeAccessor.GetAttribute(String)

Ottiene un attributo del controllo Web con il nome specificato.

(Ereditato da WebControl)
IAttributeAccessor.SetAttribute(String, String)

Imposta un attributo del controllo Web sul nome e il valore specificati.

(Ereditato da WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Consente a uno strumento di progettazione di ricreare l'insieme di controlli figlio del controllo composito nell'ambiente di progettazione.

(Ereditato da CompositeControl)
IControlBuilderAccessor.ControlBuilder

Per una descrizione di questo membro, vedere ControlBuilder.

(Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()

Per una descrizione di questo membro, vedere GetDesignModeState().

(Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary).

(Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Per una descrizione di questo membro, vedere SetOwnerControl(Control).

(Ereditato da Control)
IControlDesignerAccessor.UserData

Per una descrizione di questo membro, vedere UserData.

(Ereditato da Control)
IDataBindingsAccessor.DataBindings

Per una descrizione di questo membro, vedere DataBindings.

(Ereditato da Control)
IDataBindingsAccessor.HasDataBindings

Per una descrizione di questo membro, vedere HasDataBindings.

(Ereditato da Control)
IExpressionsAccessor.Expressions

Per una descrizione di questo membro, vedere Expressions.

(Ereditato da Control)
IExpressionsAccessor.HasExpressions

Per una descrizione di questo membro, vedere HasExpressions.

(Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)

Per una descrizione di questo membro, vedere AddParsedSubObject(Object).

(Ereditato da Control)
IPostBackEventHandler.RaisePostBackEvent(String)

Implementa il metodo RaisePostBackEvent(String).

(Ereditato da ToolZone)

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