WebZone Classe

Definizione

Funge da classe base per tutti i controli che agiscono da contenitore per i controlli server (tra cui i controlli Part, i controlli server e i controlli utente Web part) nelle applicazioni Web part.Serves as the base class for all controls that act as containers for server controls (including Web Parts Part controls, server controls, and user controls) in Web Parts applications.

public ref class WebZone abstract : System::Web::UI::WebControls::CompositeControl
[System.ComponentModel.Bindable(false)]
public abstract class WebZone : System.Web.UI.WebControls.CompositeControl
type WebZone = class
    inherit CompositeControl
Public MustInherit Class WebZone
Inherits CompositeControl
Ereditarietà
Derivato
Attributi

Esempio

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo della classe WebZone.The following code example demonstrates the use of the WebZone class.

Nella prima parte dell'esempio di codice vengono illustrati due controlli personalizzati che derivano dalla classe WebPart.The first part of the code example shows two custom controls that derive from the WebPart class. 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. 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.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class CalendarWebPart : WebPart
  {
    Calendar _calendar;

    public CalendarWebPart()
    {
      this.AllowClose = false;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      _calendar = new Calendar();
      _calendar.Caption = "My Calendar";
      this.Controls.Add(_calendar);
      ChildControlsCreated = true;
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class LinksWebPart : WebPart
  {
    Literal _literal;
    const string _literalText = @"
      <table>
      <tr>
        <td><a href='http://msdn.microsoft.com'>MSDN</a></td>
      </tr>
      <tr>
        <td><a href='http://msn.microsoft.com'>MSN</a></td>
      </tr>
      <tr>
        <td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>
      </tr>
      </table>";

    public LinksWebPart()
    {
      this.AllowClose = false;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();

      _literal = new Literal();
      _literal.Text = _literalText;
      this.Controls.Add(_literal);

      ChildControlsCreated = true;
    }
  }
}
Imports System.Security.Permissions 
Imports System.Web
Imports System.Web.UI.WebControls 
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

<AspNetHostingPermission(SecurityAction.Demand, _ 
  Level := AspNetHostingPermissionLevel.Minimal)> _ 
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _ 
Public Class CalendarWebPart
  Inherits WebPart
  Private _calendar As Calendar

  Public Sub New()
    Me.AllowClose = False

  End Sub

  Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      _calendar = New Calendar()
      _calendar.Caption = "My Calendar"
      Me.Controls.Add(_calendar)
      ChildControlsCreated = True
  
  End Sub 
  
End Class 

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class LinksWebPart
    Inherits WebPart
    Private _literal As Literal
    Private Const _literalText As String = _
      "<table>" & _
      "<tr>" & _
      "<td><a href='http://msdn.microsoft.com'>MSDN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://msn.microsoft.com'>MSN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>" & _
      "</tr>" & _
      "</table>"

    Public Sub New()
      Me.AllowClose = False

    End Sub


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()

      _literal = New Literal()
      _literal.Text = _literalText
      Me.Controls.Add(_literal)

      ChildControlsCreated = True

    End Sub
  End Class

End Namespace 

Nella seconda parte dell'esempio di codice viene illustrata una pagina Web che ospita i controlli WebPart.The second part of the code example shows a Web page that hosts the WebPart controls. Si noti che il markup dichiarativo contiene due controlli WebPartZone, un controllo CatalogZone e un controllo EditorZone.Notice that the declarative markup contains two WebPartZone controls, a CatalogZone control and an EditorZone control.

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ZoneWebPartsCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <ZoneTemplate>
          <aspSample:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>
<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="ZoneWebPartsVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <ZoneTemplate>
          <aspSample:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>

È possibile caricare la pagina in un browser e passare tra le varie modalità di visualizzazione della pagina per verificare il comportamento delle diverse zone.You can load the page in a browser and switch among the various page display modes to see how the different zones behave. Per ulteriori informazioni sulle modalità di visualizzazione e consentire agli utenti di spostarsi tra di essi, vedere procedura dettagliata: modifica delle modalità di visualizzazione in una pagina Web part.For more information on display modes and enabling users to switch among them, see Walkthrough: Changing Display Modes on a Web Parts Page.

Commenti

Una zona Web part è un'area definita che contiene controlli server in una pagina Web e fornisce un'interfaccia utente coerente (UI), il layout e il rendering per i controlli contenuti.A Web Parts zone is a defined region that contains server controls on a Web page, and provides a consistent user interface (UI), layout, and rendering for the contained controls. Il rendering delle zone viene eseguito in un browser come tabelle HTML.Zones are rendered in a browser as HTML tables.

La classe WebZone è la classe di base per tutte le zone di Web part.The WebZone class is the base class for all Web Parts zones. Un controllo zona è un controllo composito progettato per contenere altri controlli, di conseguenza la classe WebZone eredita dalla classe CompositeControl.A zone control is a composite control designed to contain other controls, hence the WebZone class inherits from the CompositeControl class. Insieme al controllo WebPartManager e ai controlli Part (o ad altri controlli utente o server che possono essere posizionati in zone), i controlli zona derivati dalla classe di base WebZone costituiscono i blocchi predefiniti essenziali di un'applicazione Web part.Together with the WebPartManager control and Part controls (or other user or server controls that can be placed in zones), zone controls derived from the WebZone base class form the essential building blocks of a Web Parts application.

Un ruolo cruciale delle zone Web part consiste nell'abilitare la funzionalità Web part completa per i controlli in essi contenuti.A critical role of Web Parts zones is to enable full Web Parts functionality for the controls they contain. Ogni pagina di Web part contiene almeno una zona e una zona può contenere zero o più controlli parte.Every Web Parts page contains at least one zone, and a zone can contain zero or more part controls. Le zone sono necessarie per Web part funzionalità.Zones are required for Web Parts functionality. Senza le zone, anche i controlli che derivano dalla classe WebPart possono avere una funzionalità Web part molto limitata.Without zones, even controls that derive from the WebPart class can have very little Web Parts functionality. Viceversa, a causa della progettazione del set di controlli di Web part, è possibile inserire controlli ASP.NET, controlli server o controlli utente comuni in un'area WebPartZoneBase (che deriva da WebZone) e, in base all'area geografica, questi controlli server comuni sono abilitati a fungere da controlli di WebPart in fase di esecuzione.Conversely, because of the design of the Web Parts control set, you can place ordinary ASP.NET controls, server controls, or user controls into a WebPartZoneBase zone (which derives from WebZone), and by virtue of being in the zone, these ordinary server controls are enable to act as WebPart controls at run time. Per informazioni dettagliate, vedere la documentazione relativa alla classe GenericWebPart.For details, see the documentation for the GenericWebPart class.

Nota

È possibile aggiungere controlli Part o WebPart a una pagina esterna a una zona, ma in questo caso funzionano semplicemente come controlli server normali.It is possible to add Part or WebPart controls to a page outside of a zone, but in that case they simply function as ordinary server controls.

Nel set di controllo Web part sono presenti due diverse categorie di zone che ereditano dalla classe WebZone di base.There are two broad categories of zones in the Web Parts control set, all of which inherit from the base WebZone class.

  • WebPartZoneBase zone.WebPartZoneBase zones. Questi contengono WebPart (e altri controlli server e utente) e formano l'interfaccia utente principale di Web part pagine con cui gli utenti interagiscono con la maggior parte del tempo.These contain WebPart (and other server and user) controls, and form the primary UI of Web Parts pages that users interact with most of the time.

  • ToolZone zone.ToolZone zones. Queste zone offrono visualizzazioni speciali di una pagina Web part che consentono agli utenti di modificare (personalizzare) il contenuto, il layout, l'aspetto, il comportamento e le proprietà dei controlli contenuti nelle zone WebPartZoneBase in una pagina Web part.These zones provide special views of a Web Parts page that enable users to modify (personalize) the content, layout, appearance, behavior, and properties of controls contained in WebPartZoneBase zones on a Web Parts page. Ad esempio, una zona CatalogZoneBase è un ToolZone che fornisce una vista del catalogo di una pagina, consentendo agli utenti di aggiungere e rimuovere i controlli server.For example, a CatalogZoneBase zone is a ToolZone that provides a catalog view of a page, enabling users to add and remove server controls. Una zona EditorZoneBase è un altro tipo di ToolZone che fornisce una visualizzazione di modifica di una pagina, consentendo agli utenti di modificare e modificare il layout della pagina, insieme alle proprietà, all'aspetto e al comportamento dei controlli.An EditorZoneBase zone is another type of ToolZone that provides an editing view of a page, enabling users to modify and edit the layout of the page, along with the properties, appearance, and behavior of the controls.

Ogni zona nel set di controllo Web part è progettata per contenere un tipo corrispondente di controllo derivato dalla classe Part, con i controlli della parte che fungono da contenuto principale e interfaccia utente primaria della zona.Each zone in the Web Parts control set is designed to contain a corresponding type of control derived from the Part class, with the part controls serving as the main content and primary UI of the zone. I tipi di zona nel set di controlli di Web part, insieme ai tipi corrispondenti di controlli di parte che contengono, sono riportati nella tabella seguente.Zone types in the Web Parts control set, along with the corresponding types of part controls they contain, are shown in the following table.

Tipo di controllo partPart control type Tipo di zonaZone type
WebPart (e controlli utente e server, incapsulati con una GenericWebPart in fase di esecuzione)WebPart (and server and user controls, which are wrapped with a GenericWebPart at run time) WebPartZone (la classe base è WebPartZoneBase)WebPartZone (the base class is WebPartZoneBase )
EditorPart (diversi controlli derivati vengono forniti con il set di controlli Web part e i controlli EditorPart personalizzati possono essere sviluppati)EditorPart (several derived controls are provided with the Web Parts control set, and custom EditorPart controls can be developed) EditorZone (la classe base è EditorZoneBase)EditorZone (the base class is EditorZoneBase )
CatalogPart (diversi controlli derivati vengono forniti con il set di controlli Web part e i controlli CatalogPart personalizzati possono essere sviluppati)CatalogPart (several derived controls are provided with the Web Parts control set, and custom CatalogPart controls can be developed) CatalogZone (la classe base è CatalogZoneBase)CatalogZone (the base class is CatalogZoneBase )
WebPartConnection (i controlli di connessione sono univoci in quanto non sono controlli parte che ereditano dalla classe base)WebPartConnection (connection controls are unique in that they are not part controls that inherit from the base class) ConnectionsZone (eredita direttamente da ToolZone)ConnectionsZone (inherits directly from ToolZone )

Tutte le zone nel controllo Web part dispongono di elementi di interfaccia utente comuni di base che ereditano dalla classe WebZone di base.All zones in the Web Parts control have basic, common user interface elements that they inherit from the base WebZone class. Non tutti questi elementi sono visibili in ogni zona, ma ogni tipo di zona è in grado di disporre di questi elementi comuni dell'interfaccia utente correlati alla zona, come descritto nella tabella seguente.Not all these elements are visible on every zone, but each zone type is capable of having these common, zone-related UI elements, as described in the following table.

Sezione zoneZone section DescrizioneDescription
HeaderHeader Sezione superiore di una zona.The top section of a zone. Include il testo dell'intestazione, che può includere un titolo per la zona. attributi di stile, ad esempio un bordo o un colore di sfondo, che distinguono l'intestazione; e verbi a livello di zona, rappresentati da pulsanti, collegamenti ipertestuali o immagini, su cui gli utenti possono fare clic per eseguire azioni dell'interfaccia utente che si applicano all'intera zona, ad esempio la chiusura di una zona.It includes header text, which can include a title for the zone; style attributes (such as a border or background color) that distinguish the header; and zone-level verbs (represented by buttons, hyperlinks, or images) that users can click to perform UI actions that apply to the entire zone, such as closing a zone. Diverse WebZone proprietà, ad esempio HasHeader, HeaderStylee HeaderText, si riferiscono all'area di intestazione di una zona.Several WebZone properties, such as HasHeader, HeaderStyle, and HeaderText, relate to the header area of a zone. Se nella zona sono presenti verbi a livello di zona, vengono applicate le proprietà VerbButtonType e VerbStyle.If there are zone-level verbs in the zone, the VerbButtonType and VerbStyle properties apply to them. Si noti che queste due proprietà dei verbi si applicano solo ai verbi a livello di zona, non ai verbi nei singoli controlli della parte contenuti nella zona.Note that these two verb properties apply to zone-level verbs only, not to verbs in the individual part controls contained in the zone. Le intestazioni non sono presenti in ogni tipo di zona; vengono in genere visualizzate in ToolZone zone in cui è necessario disporre di un'area di intestazione comune con testo e un verbo, ad esempio un verbo di chiusura.Headers are not present in every type of zone; typically they appear in ToolZone zones where there is a need to have a common header area with text and a verb, such as a close verb.
BodyBody Sezione principale del contenuto di una zona.The main contents section of a zone. Ogni zona che deriva da WebZone dispone di una sezione del corpo.Every zone that derives from WebZone has a body section. Per tutti i tipi di zone nel set di controllo Web part, il corpo della zona contiene il tipo designato di controlli Part (o altri controlli server) che corrispondono a un tipo di zona, come indicato nella tabella precedente.For all types of zones in the Web Parts control set, the body of the zone contains the designated type of Part controls (or other server controls) that correspond to a zone type, as indicated in the previous table. Diversi membri della classe WebZone influiscono sul contenuto della sezione body, ad esempio le proprietà BackImageUrl, PartChromeStyle, PartChromeTypee PartStyle.Various members of the WebZone class affect the contents of the body section, such as the BackImageUrl, PartChromeStyle, PartChromeType, and PartStyle properties. Se la sezione body è vuota, il messaggio EmptyZoneText può essere visualizzato in determinate situazioni.If the body section is empty, the EmptyZoneText message can be displayed in certain situations.
ChromeChrome Elementi dell'interfaccia utente comuni di cui è stato eseguito il rendering per ogni controllo parte di una zona.The common UI elements rendered for each part control in a zone. Questo è diverso da una discussione sugli attributi di stile che si applicano alla zona stessa; Chrome si applica in modo specifico ai controlli parte contenuti.This is distinct from a discussion of style attributes that apply to the zone itself; chrome applies specifically to the contained part controls. Chrome include i verbi, i bordi e altri attributi di stile, ad esempio il colore di sfondo o lo stile del carattere del testo del titolo, per i controlli di parte di una zona.Chrome includes verbs, borders, and other style attributes such as background color, or font style of the title text, for a zone's part controls. Una zona determina i dettagli di Chrome usando un singolo oggetto Chrome appropriato per il tipo di controlli parte che contiene, ad esempio un oggetto CatalogPartChrome per un CatalogZone che contiene CatalogPart controlli.A zone determines the chrome details by using a single chrome object appropriate to the type of part controls it contains (for example, a CatalogPartChrome object for a CatalogZone that contains CatalogPart controls). Questo singolo oggetto Chrome gestisce i dettagli di Chrome e il rendering per tutti i controlli parte della zona.This single chrome object handles the chrome details and the rendering for all the part controls in the zone. Ciò consente agli sviluppatori di creare zone in cui è possibile specificare un aspetto coerente e comune per tutti i controlli parte.This enables developers to create zones in which they can specify a consistent, common look and feel for all the part controls. Alcune proprietà correlate al Chrome per i controlli della parte della zona includono le proprietà PartChromeStyle, PartChromeType, PartStylee PartTitleStyle.Some properties that relate to the chrome for a zone's part controls include the PartChromeStyle, PartChromeType, PartStyle, and PartTitleStyle properties. Si noti che la maggior parte delle proprietà correlate a Chrome, inclusa una proprietà specifica per fare riferimento all'oggetto Chrome per un particolare tipo di zona, non sono implementate nella classe WebZone di base.Note that most chrome-related properties, including a specific property to reference the chrome object for a particular type of zone, are not implemented in the base WebZone class. Al contrario, la maggior parte delle funzionalità specifiche di Chrome delle zone è implementata su tipi di zona specifici in base alle esigenze univoche dei controlli di parte.Instead, most chrome-specific features of zones are implemented on specific zone types as appropriate to the unique needs of their part controls. Vedere gli argomenti per ogni tipo di zona elencato nella tabella precedente di questo argomento.See the topics for each zone type listed in the previous table of this topic.
Controlli partePart Controls Controlli che si trovano nella sezione del corpo di una zona.The controls that reside in the body section of a zone. Ogni zona che eredita dalla classe WebZone contiene nella relativa sezione del corpo uno o più controlli parte di un tipo corrispondente, come illustrato nella tabella precedente di questo argomento.Every zone that inherits from the WebZone class contains in its body section one or more part controls of a corresponding type, as shown in the previous table in this topic. Questi controlli della parte formano l'interfaccia utente principale di Web part applicazioni.These part controls form the main UI of Web Parts applications. La maggior parte dei tipi di zona che derivano da WebZone dispone di una proprietà di raccolta che consente loro di fare riferimento a tutti i controlli parte contenuti, ad esempio la proprietà WebParts della classe WebPartZoneBase e la proprietà EditorParts nella classe EditorZoneBase.Most zone types that derive from WebZone have a collection property that enables them to reference all their contained part controls, such as the WebParts property on the WebPartZoneBase class, and the EditorParts property on the EditorZoneBase class.
Piè di paginaFooter Sezione inferiore di una zona.The bottom section of a zone. Analogamente alla sezione header, non è presente in ogni tipo di zona, ma in genere si verifica nelle zone ToolZone.Like the header section, it is not present in every type of zone, but usually occurs in ToolZone zones. Il contenuto tipico di una sezione del piè di pagina è costituito da verbi, ad esempio un verbo OK o un verbo di applicazione, che vengono visualizzati nel piè di pagina delle EditorZoneBase zone.Typical contents of a footer section are verbs such as an ok verb or an apply verb, which appear in the footer of EditorZoneBase zones. Alcune proprietà correlate alla sezione piè di pagina includono le proprietà HasFooter, FooterStyle, VerbButtonTypee VerbStyle.Some properties that relate to the footer section include the HasFooter, FooterStyle, VerbButtonType, and VerbStyle properties.

La maggior parte delle proprietà della classe WebZone viene illustrata nella tabella precedente, in cui vengono descritti gli elementi comuni dell'interfaccia utente delle zone.Most of the WebZone class's properties are discussed in the preceding table that describes the common UI elements of zones. La classe WebZone dispone inoltre di diversi metodi correlati al proprio ruolo di rendering del contenuto.The WebZone class also has several methods relating to its role of rendering content. È possibile eseguire l'override dei metodi RenderBody, RenderContents, RenderFootere RenderHeader per fornire il controllo a livello di codice sul rendering di ogni sezione specifica di una zona.The RenderBody, RenderContents, RenderFooter, and RenderHeader methods can all be overridden to provide programmatic control over the rendering of each specific section of a zone. Se, ad esempio, si desidera personalizzare il rendering di tutte le sezioni di piè di pagina delle zone del catalogo nell'applicazione, è possibile ereditare dalla classe CatalogZoneBase, eseguire l'override del metodo RenderFooter ereditato da WebZonee modificare il rendering della sezione del piè di pagina.For example, if you want to customize the rendering of all the footer sections of catalog zones in your application, you could inherit from the CatalogZoneBase class, override the RenderFooter method inherited from WebZone, and change the rendering of the footer section.

Note per gli implementatori

Raramente è necessario ereditare direttamente dalla classe WebZone per sviluppare zone di Web part personalizzate.You rarely need to inherit directly from the WebZone class to develop custom Web Parts zones. Il set di controllo Web part contiene le zone specializzate sopra elencate nella sezione osservazioni ed è in genere possibile derivare da uno di essi per aggiungere un comportamento personalizzato a una zona.The Web Parts control set contains the specialized zones listed above in the Remarks section, and usually you can derive from one of them to add custom behavior to a zone. Se si decide di ereditare direttamente dalla classe WebZone, è necessario eseguire l'override di un numero di proprietà e metodi (vedere la documentazione per i membri della classe WebZone).If you do decide to inherit directly from the WebZone class, you must override a number of properties and methods (see the documentation for the members of the WebZone class). È anche necessario creare un controllo WebPartManager personalizzato, facoltativamente un controllo WebPartDisplayMode personalizzato per creare una modalità di visualizzazione univoca in cui visualizzare la zona e altre personalizzazioni per far funzionare la zona all'interno del set di controlli di Web part.You must also create a custom WebPartManager control, optionally a custom WebPartDisplayMode control to create a unique display mode in which to view your zone, and other customizations to make your zone work within the Web Parts control set.

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

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

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.

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.

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.

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.

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.

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.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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 viene eseguito il rendering di un controllo server come interfaccia utente nella pagina.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

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

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

Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che usano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti in preparazione per il postback o il rendering.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

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

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)
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)
OnInit(EventArgs)

Genera l'evento Init.Raises the Init event.

OnLoad(EventArgs)

Genera l'evento Load.Raises the Load event.

(Ereditato da Control)
OnPreRender(EventArgs)

Genera l'evento PreRender.Raises the PreRender event.

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

Scrive il contenuto di CompositeControl nell'oggetto HtmlTextWriter specificato, per la visualizzazione sul client.Writes the CompositeControl content to the specified HtmlTextWriter object, for display on the client.

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

RenderBody(HtmlTextWriter)

Esegue l'override del rendering per il corpo di un controllo zona.Overrides rendering for the body of a zone control.

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.

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 rendering per il piè di pagina di un controllo zona.Overrides rendering for the footer of a zone control.

RenderHeader(HtmlTextWriter)

Esegue l'override del rendering per l'intestazione di un controllo zona.Overrides rendering for the header of a zone control.

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)

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