EditorZoneBase Classe

Definizione

Funge da classe base per tutti i controlli zona che agiscono da contenitori per i controlli EditorPart.Serves as the base class for all zone controls that act as containers for EditorPart controls.

public ref class EditorZoneBase abstract : System::Web::UI::WebControls::WebParts::ToolZone
public abstract class EditorZoneBase : System.Web.UI.WebControls.WebParts.ToolZone
type EditorZoneBase = class
    inherit ToolZone
Public MustInherit Class EditorZoneBase
Inherits ToolZone
Ereditarietà
Derivato

Esempi

Nell'esempio di codice seguente vengono illustrati diversi utilizzi dichiarativi e programmatici della classe EditorZoneBase.The following code example demonstrates several declarative and programmatic uses of the EditorZoneBase class. Poiché la classe è astratta, gli esempi di codice usano la classe EditorZone derivata fornita con il set di controlli Web part, dimostrando le proprietà e i metodi che eredita dalla classe EditorZoneBase.Because the class is abstract, the code examples use the derived EditorZone class that ships with the Web Parts control set, demonstrating the properties and methods that it inherits from the EditorZoneBase class.

L'esempio di codice è costituito da quattro parti:The code example has four parts:

  • Controllo utente che consente di modificare le modalità di visualizzazione nella pagina Web.A user control that enables you to change display modes on the Web page.

  • Pagina Web contenente un controllo EditorZone.A Web page that contains an EditorZone control.

  • Classe EditorZone personalizzata che illustra alcuni dei EditorZoneBase membri della classe.A custom EditorZone class that demonstrates some of the EditorZoneBase class members.

  • Descrizione del funzionamento dell'esempio in un browser.A description of how the example works in a browser.

Il codice sorgente per il controllo utente deriva da un altro argomento.The source code for the user control comes from another topic. Per il corretto funzionamento di questo esempio di codice, è necessario ottenere il file con estensione ascx per il controllo utente dall'argomento procedura dettagliata: modifica delle modalità di visualizzazione in un Web part pagina e inserire il file nella stessa cartella della pagina aspx in questo esempio di codice.For this code example to work, you need to obtain the .ascx file for the user control from the Walkthrough: Changing Display Modes on a Web Parts Page topic, and place the file in the same folder as the .aspx page in this code example.

La seconda parte dell'esempio di codice è una pagina Web che contiene un riferimento dichiarativo a un controllo EditorZone.The second part of the code example is a Web page that contains a declarative reference to an EditorZone control. Nella parte superiore della pagina è presente una direttiva Register per il controllo utente.Near the top of the page is a Register directive for the user control. Il tag di controllo utente viene dichiarato nella pagina con un elemento <uc1:DisplayModeMenu>.The user control tag is declared in the page with a <uc1:DisplayModeMenu> element. Si noti che sotto l'elemento <asp:WebPartZone> è presente un elemento <asp:EditorZone> che contiene EditorPart controlli e che include una serie di tag e proprietà impostati per determinarne l'aspetto e il comportamento.Notice that below the <asp:WebPartZone> element is an <asp:EditorZone> element that contains EditorPart controls, and has a variety of tags and properties set to determine its appearance and behavior. La maggior parte del codice nella pagina illustra i vari usi programmatici delle proprietà e dei metodi del EditorZoneBase.Most of the code in the page demonstrates the various programmatic uses of the EditorZoneBase properties and methods.

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

  // <snippet4> 
  void Button1_Click(object sender, EventArgs e)
  {
    if (EditorZone1.ApplyVerb.Enabled)
      EditorZone1.ApplyVerb.Enabled = false;
    else
      EditorZone1.ApplyVerb.Enabled = true;
  }
  // </snippet4>
  // <snippet5> 
  void Button2_Click(object sender, EventArgs e)
  {
    if (EditorZone1.CancelVerb.Enabled)
      EditorZone1.CancelVerb.Enabled = false;
    else
      EditorZone1.CancelVerb.Enabled = true;
  }
  // </snippet5>
  // <snippet6>
  void Button3_Click(object sender, EventArgs e)
  {
    Label1.Text = "<br />";
    foreach (EditorPart part in EditorZone1.EditorParts)
    {
      Label1.Text += part.ID + "<br />";
    }
  }
  // </snippet6>
  // <snippet7>
  void Button4_Click(object sender, EventArgs e)
  {
    if (EditorZone1.OKVerb.Enabled)
      EditorZone1.OKVerb.Enabled = false;
    else
      EditorZone1.OKVerb.Enabled = true;
  }
  // </snippet7>
  
// </snippet3>    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>EditorZoneBase Examples</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" 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>
    <aspSample:MyEditorZone ID="EditorZone1" runat="server">
      <ApplyVerb Text="Apply Changes" />
      <CancelVerb Text="Cancel Changes" />
      <OKVerb Text="Finished" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyEditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ApplyVerb Enabled" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Toggle CancelVerb Enabled" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorParts Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Toggle OKVerb Enabled" OnClick="Button4_Click" /> 
  </form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuVB" 
  src="displaymodevb.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  ' <snippet3> 

  ' <snippet4> 
  Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
    If EditorZone1.ApplyVerb.Enabled Then
      EditorZone1.ApplyVerb.Enabled = False
    Else
      EditorZone1.ApplyVerb.Enabled = True
    End If
  End Sub
  ' </snippet4>
  ' <snippet5> 
  Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
    If EditorZone1.CancelVerb.Enabled Then
      EditorZone1.CancelVerb.Enabled = False
    Else
      EditorZone1.CancelVerb.Enabled = True
    End If
  End Sub
  ' </snippet5>
  ' <snippet6>
  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
  ' </snippet6>
  ' <snippet7>
  Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
    If EditorZone1.OKVerb.Enabled Then
      EditorZone1.OKVerb.Enabled = False
    Else
      EditorZone1.OKVerb.Enabled = True
    End If

  End Sub
  ' </snippet7>
  
  ' </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="WebPartManager1" 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>
    <aspSample:MyEditorZone ID="EditorZone1" runat="server">
      <ApplyVerb Text="Apply Changes" />
      <CancelVerb Text="Cancel Changes" />
      <OKVerb Text="Finished" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyEditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ApplyVerb Enabled" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Toggle CancelVerb Enabled" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorParts Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Toggle OKVerb Enabled" OnClick="Button4_Click" /> 
  </form>
</body>
</html>

La terza parte dell'esempio di codice è una classe EditorZone personalizzata che Mostra come usare un numero di membri della classe di EditorZoneBase.The third part of the code example is a custom EditorZone class that shows how to work with a number of the EditorZoneBase class members. La classe personalizzata deriva da EditorZone in modo che possa essere usata con un modello di zona nel markup dichiarativo della pagina Web.The custom class derives from EditorZone so that it can be used with a zone template in the declarative markup of the Web page. Per eseguire l'esempio di codice, è necessario compilare questo codice sorgente.For the code example to run, you must compile this source code. È possibile compilarlo in modo esplicito e inserire l'assembly risultante nella cartella bin del sito Web o nel Global Assembly Cache.You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. In alternativa, è possibile inserire il codice sorgente nella cartella App_Code del sito, in cui verrà compilata dinamicamente in fase di esecuzione.Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. In questo esempio di codice viene utilizzata la compilazione dinamica. si noterà quindi che la direttiva Register nella parte superiore della pagina Web non fa riferimento a un file di assembly.This code example uses dynamic compilation; thus, you will notice that the Register directive near the top of the Web page does not reference an assembly file. Per una procedura dettagliata in cui vengono illustrati entrambi i metodi di compilazione, vedere procedura dettagliata: sviluppo e utilizzo di un controllo server Web personalizzato.For a walkthrough that demonstrates both methods of compiling, see Walkthrough: Developing and Using a Custom Web Server Control.

using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
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 MyEditorZone : EditorZone
  {
    public MyEditorZone()
    {
    }
    protected override void OnDisplayModeChanged(object sender, 
      WebPartDisplayModeEventArgs e)
    {
      this.BackColor = Color.LightGray;
      base.OnDisplayModeChanged(sender, e);
    }
    protected override void OnSelectedWebPartChanged(object sender, 
      WebPartEventArgs e)
    {
      if (e.WebPart != null)
        e.WebPart.Zone.SelectedPartChromeStyle.BackColor = 
          Color.LightGreen;
      base.OnSelectedWebPartChanged(sender, e);
    }
    protected override void RenderBody(HtmlTextWriter writer)
    {
      writer.WriteLine("<hr />");
      base.RenderBody(writer);
    }
    protected override void RenderVerbs(HtmlTextWriter writer)
    {
      WebPartVerb[] verbs = new WebPartVerb[] { OKVerb, 
        CancelVerb, ApplyVerb };
      foreach (WebPartVerb verb in verbs)
      {
        if (verb != null)
          verb.Text += " Verb";
      }
      base.RenderVerbs(writer);
    }
  }
}
Imports System.Collections
Imports System.ComponentModel
Imports System.Drawing
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class MyEditorZone
    Inherits EditorZone

    Public Sub New()
    End Sub

    Protected Overrides Sub OnDisplayModeChanged(ByVal sender _
      As Object, ByVal e As WebPartDisplayModeEventArgs)
      Me.BackColor = Color.LightGray
      MyBase.OnDisplayModeChanged(sender, e)
    End Sub
    Protected Overrides Sub OnSelectedWebPartChanged(ByVal sender _
      As Object, ByVal e As WebPartEventArgs)
      If Not (e.WebPart Is Nothing) Then
        e.WebPart.Zone.SelectedPartChromeStyle.BackColor = _
          Color.LightGreen
      End If
      MyBase.OnSelectedWebPartChanged(sender, e)

    End Sub
    Protected Overrides Sub RenderBody(ByVal writer As _
      HtmlTextWriter)
      writer.WriteLine("<hr />")
      MyBase.RenderBody(writer)
    End Sub
    Protected Overrides Sub RenderVerbs(ByVal writer As _
      HtmlTextWriter)
      Dim verbs() As WebPartVerb = {OKVerb, CancelVerb, ApplyVerb}
      Dim verb As WebPartVerb
      For Each verb In verbs
        If Not (verb Is Nothing) Then
          verb.Text += " Verb"
        End If
      Next verb
      MyBase.RenderVerbs(writer)
    End Sub
  End Class

End Namespace

Quando si carica la pagina in un browser, è possibile selezionare la modalità di modifica dall'elenco a discesa per passare alla modalità di modifica.When you load the page in a browser, you can select Edit Mode from the drop-down list to switch to edit mode. È possibile fare clic sul menu dei verbi (la freccia verso il basso) nella barra del titolo di uno dei due controlli, quindi fare clic su modifica per modificare il controllo.You can click the verbs menu (the downward arrow) in the title bar of one of the two controls, and click Edit to edit the control. Quando l'interfaccia utente di modifica è visibile, è possibile vedere gli effetti dei diversi usi dichiarativi e programmatici dei membri della classe EditorZoneBase.When the editing UI is visible, you can see the effects of the various declarative and programmatic uses of the EditorZoneBase class members.

Commenti

La classe EditorZoneBase è una classe di zona specializzata che eredita dalla classe ToolZone e fornisce un set di base di comportamenti per le zone derivate che contengono EditorPart controlli.The EditorZoneBase class is a specialized zone class that inherits from the ToolZone class and provides a base set of behaviors for derived zones that contain EditorPart controls. Esistono diversi altri tipi di classi di ToolZone; Per ulteriori informazioni, vedere l'argomento introduttivo relativo alla classe ToolZone.There are several other types of ToolZone classes; for more information, see the overview topic for the ToolZone class. Analogamente ad altre zone degli strumenti, le zone EditorZoneBase non sono visibili quando una pagina è in modalità di visualizzazione normale; sono visibili solo quando una pagina è in modalità di visualizzazione di modifica.Like other tool zones, EditorZoneBase zones are not visible when a page is in normal browse mode; they are visible only when a page is in edit display mode. Analogamente alle altre zone degli strumenti, EditorZoneBase zone possono contenere solo il tipo speciale di controlli che sono stati progettati per contenere, in questo caso EditorPart controlli.Also like the other tool zones, EditorZoneBase zones can only contain the special type of controls they were designed to contain (in this case, EditorPart controls).

Le zone EditorZoneBase forniscono una speciale interfaccia utente per i controlli di modifica che contengono.The EditorZoneBase zones provide a special UI for the editing controls they contain. Molti di questi elementi dell'interfaccia utente sono comuni a tutte le zone nel set di controlli Web part.Many of these UI elements are common to all zones in the Web Parts control set. Per una descrizione dettagliata degli elementi comuni dell'interfaccia utente in Web part zone, vedere l'argomento Panoramica della classe per la WebZone classe.For a detailed discussion of the common UI elements in Web Parts zones, see the class overview topic for the WebZone class.

Poiché la classe EditorZoneBase è astratta, non è possibile utilizzarla direttamente in una pagina Web.Because the EditorZoneBase class is abstract, you cannot use it directly on a Web page. È invece necessario utilizzare un controllo che eredita dalla classe EditorZoneBase e ne implementa il comportamento.Instead, you must use a control that inherits from the EditorZoneBase class and implements its behavior. È possibile usare la zona derivata fornita nel set di controllo Web part, il controllo EditorZone oppure è possibile derivare un controllo EditorZoneBase personalizzato.You can either use the derived zone that is provided in the Web Parts control set, the EditorZone control, or you can derive your own custom EditorZoneBase control.

La classe EditorZoneBase fornisce un'interfaccia utente comune per contenere controlli speciali che consentono agli utenti finali di modificare le proprietà, il layout, l'aspetto e altri attributi dei controlli WebPart.The EditorZoneBase class provides a common user interface (UI) to contain special controls that enable end users to edit the properties, layout, appearance, and other attributes of WebPart controls. Alcune proprietà che si applicano all'interfaccia utente fanno riferimento a verbi, ad esempio le proprietà ApplyVerb, CancelVerbe OKVerb.Some properties that apply to the UI refer to verbs, such as the ApplyVerb, CancelVerb, and OKVerb properties. I verbi sono azioni comuni eseguite dagli utenti in una pagina e sono rappresentate nell'interfaccia utente da pulsanti, collegamenti, voci di menu o altri elementi.Verbs are common actions carried out by users on a page, and are represented in the UI by buttons, links, menu items, or other elements. Ad esempio, quando gli utenti modificano le proprietà di un controllo, possono fare clic su un verbo Apply per salvare le modifiche.For example, when users edit properties on a control they can click an apply verb to save the changes.

Diverse altre proprietà influiscono sul testo visualizzato in diversi punti dell'interfaccia utente di modifica.Several other properties affect text that is displayed at various points in the editing UI. Sono incluse le proprietà EmptyZoneText, ErrorText, HeaderTexte InstructionText.These include the EmptyZoneText, ErrorText, HeaderText, and InstructionText properties.

Due proprietà importanti forniscono riferimenti a controlli correlati.Two important properties provide references to related controls. La proprietà EditorParts è una raccolta dei controlli EditorPart contenuti nella zona.The EditorParts property is a collection of the EditorPart controls contained in the zone. La proprietà WebPartToEdit è un riferimento a un oggetto di un controllo contenuto in un WebPartZone, che può essere un controllo WebPart o qualsiasi altro controllo server ASP.NET, controllo utente o controllo personalizzato attualmente in fase di modifica.The WebPartToEdit property is an object reference to a control contained in a WebPartZone--which might be a WebPart control or any other ASP.NET server control, user control, or custom control currently being edited.

Infine, la proprietà EditorPartChrome fa riferimento a un'istanza di un oggetto EditorPartChrome associato alla zona e che contiene le caratteristiche di stile degli elementi dell'interfaccia utente periferici (noti come Chrome), ad esempio gli stili del titolo e del bordo per EditorPart controlli nella zona.Finally, the EditorPartChrome property references an instance of an EditorPartChrome object that is associated with the zone, and that contains style characteristics of the peripheral UI elements (known as chrome) such as title and border styles for EditorPart controls in the zone.

Alcuni dei metodi della classe EditorZoneBase sono specializzati per gestire la modifica di altri controlli.A number of the methods of the EditorZoneBase class are specialized to handle the editing of other controls. Il metodo Close modifica la pagina dalla modalità di visualizzazione modifica a una visualizzazione di esplorazione normale.The Close method changes the page from the edit display mode back to a normal browsing view. Il metodo CreateEditorPartChrome è per la creazione di Chrome (elementi periferici dell'interfaccia utente, ad esempio un bordo, verbi, icone e un titolo), che racchiude ogni controllo EditorPart nella zona.The CreateEditorPartChrome method is for creating the chrome (peripheral UI elements such as a border, verbs, icons, and a title) that surrounds each EditorPart control in the zone. Il metodo CreateEditorParts è un metodo astratto; le classi derivate eseguono l'override per creare istanze di tutti i controlli EditorPart contenuti nella zona.The CreateEditorParts method is an abstract method; derived classes override it to create instances of all the EditorPart controls contained in the zone. Il metodo InvalidateEditorParts può essere chiamato da una classe derivata se la raccolta di controlli EditorPart nella zona viene modificata per qualche motivo a livello di codice, che contrassegna il set di controlli di Web part per ricreare e aggiornare la raccolta di controlli EditorPart.The InvalidateEditorParts method can be called by a derived class if the collection of EditorPart controls in the zone changes for some programmatic reason, which flags the Web Parts control set to recreate and update the collection of EditorPart controls. Il metodo OnDisplayModeChanged viene usato per impostare la raccolta di controlli EditorPart su null quando la modalità di visualizzazione passa dalla modalità di modifica alla modalità browse.The OnDisplayModeChanged method is used to set the collection of EditorPart controls to null when the display mode changes from edit mode back to browse mode. Infine, viene usato il metodo OnSelectedWebPartChanged per gestire l'evento quando un controllo WebPart entra o esce dalla modalità di modifica.Finally, the OnSelectedWebPartChanged method is used for handling the event when a WebPart control is either entering or leaving edit mode. Questo metodo, ad esempio, è una soluzione ideale per sincronizzare i valori delle proprietà di un controllo WebPart con i valori modificabili nei controlli EditorPart associati.For example, this method is a convenient place to synchronize the property values of a WebPart control with the editable values in the associated EditorPart controls.

Note per gli implementatori

Se si desidera sviluppare un'area personalizzata per l'hosting di controlli EditorPart, è necessario determinare se si desidera fornire il supporto del modello di zona.If you want to develop a custom zone for hosting EditorPart controls, you must determine whether you want to provide zone template support. Un modello di zona viene creato da tipi che implementano l'interfaccia ITemplate ed è necessario se si vuole consentire agli sviluppatori di pagine che usano la zona personalizzata di fare riferimento ai controlli EditorPart all'interno della zona nel markup dichiarativo di una pagina Web.A zone template is created by types that implement the ITemplate interface, and is necessary if you want to enable page developers using your custom zone to reference EditorPart controls within your zone in the declarative markup of a Web page. Se è necessario il supporto del modello di zona, è necessario ereditare dalla classe EditorZone.If you need zone template support, you should inherit from the EditorZone class.

Al contrario, se l'area personalizzata e i relativi controlli EditorPart saranno indipendenti e verranno creati a livello di programmazione senza alcuna opzione per gli sviluppatori di pagine per specificare i controlli in modo dichiarativo in un modello di zona, è possibile ereditare direttamente dalla classe EditorZoneBase.In contrast, if your custom zone and its EditorPart controls are going to be self-contained, and they will be created programmatically without any options for page developers to specify controls declaratively in a zone template, then you can inherit directly from the EditorZoneBase class. In tal caso, è fondamentale implementare il metodo CreateEditorParts() in modo che l'area personalizzata funzioni.If you do this, it is critical that you implement the CreateEditorParts() method so that your custom zone will work.

Costruttori

EditorZoneBase()

Inizializza la classe per l'uso da parte di un'istanza di una classe ereditata.Initializes the class for use by an inherited class instance. Questo costruttore può essere chiamato solo da una classe ereditata.This constructor can only be called by an inherited class.

Proprietà

AccessKey

Ottiene o imposta il tasto di scelta che consente di accedere rapidamente al controllo server Web.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Ereditato da WebControl)
Adapter

Ottiene l'adattatore specifico del browser per il controllo.Gets the browser-specific adapter for the control.

(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.Gets a reference to a WebPartVerb object that enables end users to apply editing changes to a control in edit mode.

AppRelativeTemplateSourceDirectory

Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Ereditato da Control)
AssociatedDisplayModes

Ottiene l'insieme di oggetti WebPartDisplayMode associati a una particolare zona ToolZone.Gets the collection of WebPartDisplayMode objects that are associated with a particular ToolZone zone.

(Ereditato da ToolZone)
Attributes

Ottiene l'insieme di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Ereditato da WebControl)
BackColor

Ottiene o imposta il colore di sfondo del controllo server Web.Gets or sets the background color of the Web server control.

(Ereditato da WebControl)
BackImageUrl

Ottiene o imposta l'URL di un'immagine di sfondo per una zona.Gets or sets the URL to a background image for a zone.

(Ereditato da WebZone)
BindingContainer

Ottiene il controllo contenente l'associazione dati del controllo corrente.Gets the control that contains this control's data binding.

(Ereditato da Control)
BorderColor

Ottiene o imposta il colore del bordo del controllo Web.Gets or sets the border color of the Web control.

(Ereditato da WebControl)
BorderStyle

Ottiene o imposta lo stile del bordo del controllo server Web.Gets or sets the border style of the Web server control.

(Ereditato da WebControl)
BorderWidth

Ottiene o imposta la larghezza del bordo del controllo server Web.Gets or sets the border width of the Web server control.

(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.Gets a reference to a WebPartVerb object that enables end users to cancel editing changes to a control in edit mode.

ChildControlsCreated

Ottiene un valore che indica se i controlli figli del controllo server sono stati creati.Gets a value that indicates whether the server control's child controls have been created.

(Ereditato da Control)
ClientID

Ottiene l'ID di controllo per il markup HTML generato da ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Ereditato da Control)
ClientIDMode

Ottiene o imposta l'algoritmo utilizzato per generare il valore della proprietà ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Ereditato da Control)
ClientIDSeparator

Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID.Gets a character value representing the separator character used in the ClientID property.

(Ereditato da Control)
Context

Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente.Gets the HttpContext object associated with the server control for the current Web request.

(Ereditato da Control)
Controls

Ottiene un oggetto ControlCollection che rappresenta i controlli figlio di un oggetto CompositeControl.Gets a ControlCollection object that represents the child controls in a CompositeControl.

(Ereditato da CompositeControl)
ControlStyle

Ottiene lo stile del controllo server Web.Gets the style of the Web server control. Questa proprietà viene usata principalmente dagli sviluppatori di controlli.This property is used primarily by control developers.

(Ereditato da WebControl)
ControlStyleCreated

Ottiene un valore che indica se è stato creato un oggetto Style per la proprietà ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli.This property is primarily used by control developers.

(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.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Ereditato da WebControl)
DataItemContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Ereditato da Control)
DataKeysContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Ereditato da Control)
DesignMode

Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione.Gets a value indicating whether a control is being used on a design surface.

(Ereditato da Control)
Display

Ottiene un valore che indica se il controllo ToolZone è o meno visualizzato.Gets a value that indicates whether a ToolZone control is currently displayed.

EditorPartChrome

Ottiene un riferimento all'istanza della classe EditorPartChrome associata alla zona EditorZoneBase.Gets a reference to the instance of the EditorPartChrome class associated with the EditorZoneBase zone.

EditorParts

Ottiene un insieme di tutti i controlli EditorPart contenuti in una zona EditorZoneBase.Gets a collection of all the EditorPart controls contained in an EditorZoneBase zone.

EditUIStyle

Ottiene gli attributi di stile per i controlli modificabili contenuti in un controllo ToolZone.Gets the style attributes for the editable controls contained in a ToolZone control.

(Ereditato da ToolZone)
EmptyZoneText

Ottiene o imposta un messaggio che viene visualizzato quando un'area non contiene controlli.Gets or sets a message that appears when a zone contains no controls.

EmptyZoneTextStyle

Ottiene gli attributi di stile per il testo segnaposto in una zona vuota.Gets the style attributes for the placeholder text in an empty zone.

(Ereditato da WebZone)
Enabled

Ottiene o imposta un valore che indica se il controllo server Web è abilitato.Gets or sets a value indicating whether the Web server control is enabled.

(Ereditato da WebControl)
EnableTheming

Ottiene o imposta un valore che indica se al controllo vengono applicati i temi.Gets or sets a value indicating whether themes apply to this control.

(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.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(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.Gets the style attributes for rendering the error message that is displayed if a WebPart control cannot be loaded or created.

(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.Gets or sets the text of a zone-level error message to display at the top of the editing user interface (UI).

Events

Ottiene un elenco dei delegati del gestore eventi per il controllo.Gets a list of event handler delegates for the control. Questa proprietà è di sola lettura.This property is read-only.

(Ereditato da Control)
Font

Ottiene le proprietà del carattere associate al controllo server Web.Gets the font properties associated with the Web server control.

(Ereditato da WebControl)
FooterStyle

Ottiene gli attributi di stile per il contenuto dell'area di piè di pagina di una zona.Gets the style attributes for the contents of a zone's footer area.

(Ereditato da WebZone)
ForeColor

Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Ereditato da WebControl)
HasAttributes

Ottiene un valore che indica se sono impostati attributi per il controllo.Gets a value indicating whether the control has attributes set.

(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.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Ereditato da Control)
HasFooter

Ottiene un valore che indica se una zona comprende o meno un'area di piè di pagina.Gets a value indicating whether a zone has a footer area.

(Ereditato da WebZone)
HasHeader

Ottiene un valore che indica se una zona comprende un'area di intestazione.Gets a value indicating whether a zone has a header area.

(Ereditato da WebZone)
HeaderCloseVerb

Ottiene un riferimento all'oggetto WebPartVerb nell'intestazione di un controllo ToolZone utilizzato per chiudere il controllo.Gets a reference to the WebPartVerb object in the header of a ToolZone control that is used to close the control.

(Ereditato da ToolZone)
HeaderStyle

Ottiene gli attributi di stile per il contenuto dell'area di intestazione di una zona.Gets the style attributes for the contents of a zone's header area.

(Ereditato da WebZone)
HeaderText

Ottiene o imposta il testo dell'area di intestazione di un'area.Gets or sets the text for the header area of a zone.

HeaderVerbStyle

Ottiene gli attributi di stile per tutti i verbi di intestazione visualizzati in un controllo ToolZone.Gets the style attributes for all header verbs displayed in a ToolZone control.

(Ereditato da ToolZone)
Height

Ottiene o imposta l'altezza del controllo server Web.Gets or sets the height of the Web server control.

(Ereditato da WebControl)
ID

Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server.Gets or sets the programmatic identifier assigned to the server control.

(Ereditato da Control)
IdSeparator

Ottiene il carattere utilizzato per separare gli identificatori di controllo.Gets the character used to separate control identifiers.

(Ereditato da Control)
InstructionText

Ottiene o imposta il testo in un controllo ToolZone che fornisce le indicazioni agli utenti finali.Gets or sets the text in a ToolZone control that provides directions for end users.

InstructionTextStyle

Ottiene gli attributi di stile per il testo di istruzioni che appare nella parte superiore di un controllo ToolZone.Gets the style attributes for the instruction text that appears at the top of a ToolZone control.

(Ereditato da ToolZone)
IsChildControlStateCleared

Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo.Gets a value indicating whether controls contained within this control have control state.

(Ereditato da Control)
IsEnabled

Ottiene un valore che indica se il controllo è abilitato.Gets a value indicating whether the control is enabled.

(Ereditato da WebControl)
IsTrackingViewState

Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione.Gets a value that indicates whether the server control is saving changes to its view state.

(Ereditato da Control)
IsViewStateEnabled

Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente.Gets a value indicating whether view state is enabled for this control.

(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.Gets the style attributes for the contents of the labels that appear alongside the editing controls within a ToolZone control. I controlli ToolZone derivati, ad esempio CatalogZone e EditorZone, applicano gli stili alle etichette.The derived ToolZone controls, such as CatalogZone and EditorZone, apply the styles to the labels.

(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.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(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.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(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.Gets a reference to a WebPartVerb object that applies editing changes to a control in edit mode, and hides the editing user interface (UI).

Padding

Ottiene o imposta gli attributi di spaziatura interna delle celle sulla tabella che contiene i controlli WebPart in una zona.Gets or sets the cell padding attributes on the table that contains the WebPart controls in a zone.

(Ereditato da WebZone)
Page

Ottiene un riferimento all'istanza Page che contiene il controllo server.Gets a reference to the Page instance that contains the server control.

(Ereditato da Control)
Parent

Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina.Gets a reference to the server control's parent control in the page control hierarchy.

(Ereditato da Control)
PartChromePadding

Ottiene o imposta la distanza tra il contenuto di un controllo WebPart e il bordo del controllo.Gets or sets the distance between the contents of a WebPart control and the border of the control.

(Ereditato da WebZone)
PartChromeStyle

Ottiene le caratteristiche di stile applicabili ai bordi dei controlli Web part contenuti in una zona.Gets style characteristics that apply to the borders of Web Parts controls contained by a zone.

(Ereditato da WebZone)
PartChromeType

Ottiene o imposta il tipo di bordo che delimita i controlli Web part contenuti in una zona.Gets or sets the type of border that frames Web Parts controls contained by a zone.

(Ereditato da WebZone)
PartStyle

Ottiene le caratteristiche di stile applicabili al bordo e al contenuto di ogni controllo Web part contenuto in una zona.Gets style characteristics that apply to the border and contents of each Web Parts control contained by a zone.

(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.Gets style attributes for the title bar content for each Web Parts control contained by a zone.

(Ereditato da WebZone)
RenderClientScript

Ottiene un valore che indica se eseguire o meno il rendering dello script client su una pagina Web part.Gets a value that indicates whether to render client script on a Web Parts page.

(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.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Ereditato da Control)
Site

Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione.Gets information about the container that hosts the current control when rendered on a design surface.

(Ereditato da Control)
SkinID

Ottiene o imposta l'interfaccia personalizzata da applicare al controllo.Gets or sets the skin to apply to the control.

(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.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(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.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Ereditato da CompositeControl)
TabIndex

Ottiene o imposta l'indice di tabulazione del controllo server Web.Gets or sets the tab index of the Web server control.

(Ereditato da WebControl)
TagKey

Ottiene il valore HtmlTextWriterTag corrispondente al controllo server Web.Gets the HtmlTextWriterTag value that corresponds to this Web server control. Questa proprietà viene usata principalmente dagli sviluppatori di controlli.This property is used primarily by control developers.

(Ereditato da WebZone)
TagName

Ottiene il nome del tag del controllo.Gets the name of the control tag. Questa proprietà viene usata principalmente dagli sviluppatori di controlli.This property is used primarily by control developers.

(Ereditato da WebControl)
TemplateControl

Ottiene o imposta un riferimento al modello che contiene il controllo.Gets or sets a reference to the template that contains this control.

(Ereditato da Control)
TemplateSourceDirectory

Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Ereditato da Control)
ToolTip

Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Ereditato da WebControl)
UniqueID

Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server.Gets the unique, hierarchically qualified identifier for the server control.

(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.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Ereditato da Control)
VerbButtonType

Ottiene o imposta il tipo di pulsante da utilizzare per rappresentare i verbi in una zona.Gets or sets what kind of button is used to represent verbs in a zone.

(Ereditato da WebZone)
VerbStyle

Ottiene gli attributi di stile per i verbi dell'interfaccia utente associati ai controlli Web part di una zona.Gets the style attributes for the user interface (UI) verbs associated with Web Parts controls in a zone.

(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.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Ereditato da Control)
ViewStateIgnoresCase

Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole.Gets a value that indicates whether the StateBag object is case-insensitive.

(Ereditato da Control)
ViewStateMode

Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo.Gets or sets the view-state mode of this control.

(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.Gets or sets a value that indicates whether a server control is rendered as a user interface (UI) element on the page.

(Ereditato da ToolZone)
WebPartManager

Ottiene un riferimento al controllo WebPartManager associato a un'istanza del controllo WebZone in una pagina Web part.Gets a reference to the WebPartManager control associated with a WebZone control instance on a Web Parts page.

(Ereditato da WebZone)
WebPartToEdit

Ottiene un riferimento al controllo WebPart in corso di modifica.Gets a reference to the WebPart control that is currently being edited.

Width

Ottiene o imposta la larghezza del controllo server Web.Gets or sets the width of the Web server control.

(Ereditato da WebControl)

Metodi

AddAttributesToRender(HtmlTextWriter)

Aggiunge attributi e stili HTML dei quali è necessario eseguire il rendering nell'oggetto HtmlTextWriterTag specificato.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
AddedControl(Control, Int32)

Chiamato dopo che un controllo figlio viene aggiunto alla raccolta Controls dell'oggetto Control.Called after a child control is added to the Controls collection of the Control object.

(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.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Ereditato da Control)
ApplyStyle(Style)

Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, sovrascrivendo eventuali elementi di stile del controllo.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Il metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is primarily used by control developers.

(Ereditato da WebControl)
ApplyStyleSheetSkin(Page)

Applica al controllo le proprietà di stile definite nel foglio di stile della pagina.Applies the style properties defined in the page style sheet to the control.

(Ereditato da Control)
BeginRenderTracing(TextWriter, Object)

Inizia la traccia in fase di progettazione dei dati di rendering.Begins design-time tracing of rendering data.

(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.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Ereditato da Control)
ClearCachedClientID()

Imposta il valore memorizzato nella cache ClientID su null.Sets the cached ClientID value to null.

(Ereditato da Control)
ClearChildControlState()

Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server.Deletes the control-state information for the server control's child controls.

(Ereditato da Control)
ClearChildState()

Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server.Deletes the view-state and control-state information for all the server control's child controls.

(Ereditato da Control)
ClearChildViewState()

Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server.Deletes the view-state information for all the server control's child controls.

(Ereditato da Control)
ClearEffectiveClientIDMode()

Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to 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.Called when a user clicks a close verb in the header of a zone, this method ends the process of editing WebPart controls, and returns a Web Parts page's display mode to browse mode.

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.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
CreateChildControls()

Crea il set dei controlli figlio associati a una zona EditorZoneBase.Creates the set of child controls associated with an EditorZoneBase zone.

CreateControlCollection()

Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Ereditato da Control)
CreateControlStyle()

Crea l'oggetto di stile utilizzato internamente dalla classe WebControl per implementare tutte le proprietà correlate allo stile.Creates the style object that is used internally by the WebControl class to implement all style related properties. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(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.Gets a reference to a new EditorPartChrome object used to render the peripheral user interface (UI) elements around an EditorZoneBase zone.

CreateEditorParts()

Fornisce una dichiarazione del metodo base che può essere sottoposta a override dalle zone derivate per gestire i dettagli della creazione dei controlli EditorPart contenuti in una zona.Provides a base method declaration that derived zones can override to handle the details of creating the EditorPart controls contained in a zone.

DataBind()

Associa un'origine dati al controllo CompositeControl e a tutti i relativi controlli figlio.Binds a data source to the CompositeControl and all its child controls.

(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.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Ereditato da Control)
DataBindChildren()

Associa un'origine dati al controllo server e ai relativi controlli figlio.Binds a data source to the server control's child controls.

(Ereditato da Control)
Dispose()

Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria.Enables a server control to perform final clean up before it is released from memory.

(Ereditato da Control)
EndRenderTracing(TextWriter, Object)

Termina la traccia in fase di progettazione dei dati di rendering.Ends design-time tracing of rendering data.

(Ereditato da Control)
EnsureChildControls()

Determina se il controllo server contiene controlli figlio.Determines whether the server control contains child controls. In caso contrario, li crea.If it does not, it creates child controls.

(Ereditato da Control)
EnsureID()

Crea un identificatore per i controlli a cui non è assegnato alcun identificatore.Creates an identifier for controls that do not have an identifier assigned.

(Ereditato da Control)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
FindControl(String)

Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato.Searches the current naming container for a server control with the specified id parameter.

(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.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Non eseguire l'override di questa versione del metodo FindControl.You should not override this version of the FindControl method.

(Ereditato da Control)
Focus()

Imposta lo stato attivo per l'input su un controllo.Sets input focus to a control.

(Ereditato da Control)
GetDesignModeState()

Ottiene i dati della fase di progettazione per un controllo.Gets design-time data for a control.

(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.Returns the actual or effective current PartChromeType value of a WebPart control, given the PartChromeType property of the zone and the current display mode of the Web Parts page.

(Ereditato da WebZone)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetRouteUrl(Object)

Ottiene l'URL corrispondente a un set di parametri di route.Gets the URL that corresponds to a set of route parameters.

(Ereditato da Control)
GetRouteUrl(RouteValueDictionary)

Ottiene l'URL corrispondente a un set di parametri di route.Gets the URL that corresponds to a set of route parameters.

(Ereditato da Control)
GetRouteUrl(String, Object)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.Gets the URL that corresponds to a set of route parameters and a route name.

(Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.Gets the URL that corresponds to a set of route parameters and a route name.

(Ereditato da Control)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
GetUniqueIDRelativeTo(Control)

Restituisce la parte con prefisso della proprietà UniqueID del controllo specificato.Returns the prefixed portion of the UniqueID property of the specified control.

(Ereditato da Control)
HasControls()

Determina se il controllo server contiene controlli figlio.Determines if the server control contains any child controls.

(Ereditato da Control)
HasEvents()

Restituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio.Returns a value indicating whether events are registered for the control or any child controls.

(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.Sets the collection of EditorPart controls associated with an EditorZoneBase zone to null, which results in the CreateEditorParts() method being called to recreate the collection.

IsLiteralContent()

Determina se il controllo server conserva solo il contenuto literal.Determines if the server control holds only literal content.

(Ereditato da Control)
LoadControlState(Object)

Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Ereditato da Control)
LoadViewState(Object)

Carica le informazioni sullo stato precedentemente salvate per una zona.Loads previously saved state information for a zone.

MapPathSecure(String)

Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Ereditato da Control)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(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.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(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.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Ereditato da Control)
OnDataBinding(EventArgs)

Genera l'evento DataBinding.Raises the DataBinding event.

(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.Raises the DisplayModeChanged event and destroys all EditorPart and child controls in the zone in preparation for a Web page to enter or exit the edit display mode.

OnInit(EventArgs)

Crea gestori di eventi specializzati utilizzati dal controllo WebPartManager in una pagina Web.Creates specialized event handlers used by the WebPartManager control on a Web page.

(Ereditato da ToolZone)
OnLoad(EventArgs)

Genera l'evento Load.Raises the Load event.

(Ereditato da Control)
OnPreRender(EventArgs)

Genera l'evento PreRender e chiama il metodo PerformPreRender() per gli elementi del colore dei controlli EditorPart.Raises the PreRender event, and calls the PerformPreRender() method for the chrome elements of the EditorPart controls.

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.Raises the SelectedWebPartChanged event and sets the EditorParts collection to null in the zone in preparation for a WebPart control to enter or exit edit mode.

OnUnload(EventArgs)

Genera l'evento Unload.Raises the Unload event.

(Ereditato da Control)
OpenFile(String)

Ottiene un oggetto Stream utilizzato per leggere un file.Gets a Stream used to read a file.

(Ereditato da Control)
RaiseBubbleEvent(Object, EventArgs)

Assegna eventuali origini dell'evento e relative informazioni al controllo padre.Assigns any sources of the event and its information to the control's parent.

(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.Carries out the actions associated with one of the zone verbs, or raises an event that posts back to the server.

RecreateChildControls()

Ricrea i controlli figlio in un controllo derivato da CompositeControl.Recreates the child controls in a control derived from CompositeControl.

(Ereditato da CompositeControl)
RemovedControl(Control)

Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control.Called after a child control is removed from the Controls collection of the Control object.

(Ereditato da Control)
Render(HtmlTextWriter)

Esegue il rendering della zona sull'oggetto HtmlTextWriter specificato.Renders the zone to the specified HtmlTextWriter object.

RenderBeginTag(HtmlTextWriter)

Esegue il rendering del tag HTML di apertura del controllo zona nell'oggetto HtmlTextWriter specificato.Renders the opening HTML tag of the zone control to the specified HtmlTextWriter object.

(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.Overrides the base method to render the body area of a zone derived from the EditorZoneBase class.

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.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the 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.Renders the entire contents of a zone control between the beginning and ending tags to the specified HtmlTextWriter object.

(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.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Ereditato da Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Ereditato da Control)
RenderEndTag(HtmlTextWriter)

Esegue il rendering del tag HTML di chiusura del controllo nel writer specificato.Renders the HTML closing tag of the control into the specified writer. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
RenderFooter(HtmlTextWriter)

Esegue l'override del metodo base per il rendering dei verbi nel piè di pagina di un controllo ToolZone.Overrides the base method to render verbs in the footer of a ToolZone control.

(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.Overrides the base method to provide specialized rendering for the header area required by ToolZone controls.

(Ereditato da ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)

Esegue il rendering di un singolo verbo con un controllo ToolZone.Renders an individual verb with a ToolZone control.

(Ereditato da ToolZone)
RenderVerbs(HtmlTextWriter)

Esegue il rendering dei verbi applicabili a livello di zona.Renders the verbs that apply at the zone level.

ResolveAdapter()

Ottiene l'adattatore del controllo responsabile del rendering del controllo specificato.Gets the control adapter responsible for rendering the specified control.

(Ereditato da Control)
ResolveClientUrl(String)

Ottiene un URL che può essere utilizzato dal browser.Gets a URL that can be used by the browser.

(Ereditato da Control)
ResolveUrl(String)

Converte un URL in un formato utilizzabile dal client richiedente.Converts a URL into one that is usable on the requesting client.

(Ereditato da Control)
SaveControlState()

Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Ereditato da Control)
SaveViewState()

Salva tutte le modifiche dello stato di visualizzazione avvenute dopo il reinserimento di una pagina nel server.Saves any view-state changes that have occurred after a page was posted back to the server.

SetDesignModeState(IDictionary)

Imposta i dati della fase di progettazione per un controllo.Sets design-time data for a control.

(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.Assigns an event handler delegate to render the server control and its content into its parent control.

(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.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(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.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Ereditato da Control)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
TrackViewState()

Tiene traccia delle modifiche apportate allo stato di visualizzazione di un controllo zona.Tracks changes to a zone control's view state.

Eventi

DataBinding

Viene generato quando il controllo server viene associato a un'origine dati.Occurs when the server control binds to a data source.

(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.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Ereditato da Control)
Init

Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Ereditato da Control)
Load

Viene generato quando il controllo server è caricato nell'oggetto Page.Occurs when the server control is loaded into the Page object.

(Ereditato da Control)
PreRender

Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering.Occurs after the Control object is loaded but prior to rendering.

(Ereditato da Control)
Unload

Viene generato quando il controllo server viene scaricato dalla memoria.Occurs when the server control is unloaded from memory.

(Ereditato da Control)

Implementazioni dell'interfaccia esplicita

IAttributeAccessor.GetAttribute(String)

Ottiene un attributo del controllo Web con il nome specificato.Gets an attribute of the Web control with the specified name.

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

Imposta un attributo del controllo Web sul nome e il valore specificati.Sets an attribute of the Web control to the specified name and value.

(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.Enables a designer to recreate the composite control's collection of child controls in the design-time environment.

(Ereditato da CompositeControl)
IControlBuilderAccessor.ControlBuilder

Per una descrizione di questo membro, vedere ControlBuilder.For a description of this member, see ControlBuilder.

(Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()

Per una descrizione di questo membro, vedere GetDesignModeState().For a description of this member, see GetDesignModeState().

(Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Per una descrizione di questo membro, vedere SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Ereditato da Control)
IControlDesignerAccessor.UserData

Per una descrizione di questo membro, vedere UserData.For a description of this member, see UserData.

(Ereditato da Control)
IDataBindingsAccessor.DataBindings

Per una descrizione di questo membro, vedere DataBindings.For a description of this member, see DataBindings.

(Ereditato da Control)
IDataBindingsAccessor.HasDataBindings

Per una descrizione di questo membro, vedere HasDataBindings.For a description of this member, see HasDataBindings.

(Ereditato da Control)
IExpressionsAccessor.Expressions

Per una descrizione di questo membro, vedere Expressions.For a description of this member, see Expressions.

(Ereditato da Control)
IExpressionsAccessor.HasExpressions

Per una descrizione di questo membro, vedere HasExpressions.For a description of this member, see HasExpressions.

(Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)

Per una descrizione di questo membro, vedere AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Ereditato da Control)
IPostBackEventHandler.RaisePostBackEvent(String)

Implementa il metodo RaisePostBackEvent(String).Implements the RaisePostBackEvent(String) method.

(Ereditato da ToolZone)

Metodi di estensione

FindDataSourceControl(Control)

Restituisce l'origine dati associata al controllo dati per il controllo specificato.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Restituisce l'oggetto metatabella per il controllo contenitore dei dati.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Ottiene l'insieme di valori predefiniti per il controllo dei dati specificato.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Ottiene i metadati della tabella per il controllo dei dati specificato.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Imposta i metadati della tabella per il controllo dei dati specificato.Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Determina se sono disponibili i metadati della tabella.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Abilita il comportamento dati dinamici per il controllo dei dati specificato.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Abilita il comportamento dati dinamici per il controllo dei dati specificato.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Abilita il comportamento dati dinamici per il controllo dei dati specificato.Enables Dynamic Data behavior for the specified data control.

Si applica a

Vedi anche