GenericWebPart Classe

Definizione

Esegue il wrapping dei controlli server che non sono controlli WebPart in modo che possano essere visualizzati e possano comportarsi come veri controlli WebPart in fase di esecuzione.Wraps server controls that are not WebPart controls so that they can appear and behave as true WebPart controls at run time.

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

Esempi

Nell'esempio di codice seguente viene illustrato GenericWebPart il modo in cui il controllo esegue automaticamente il wrapping di WebPart un controllo server che non è un controllo in fase di esecuzione.The following code example demonstrates how the GenericWebPart control automatically wraps a server control that is not a WebPart control at run time.

La prima parte dell'esempio di codice contiene una pagina di Web part con WebPartZone due controlli.The first part of the code example contains a Web Parts page with two WebPartZone controls. All'interno di ogni zona è presente un controllo server ASP.NET standard.Within each zone is a standard ASP.NET server control. Poiché i controlli si trovano in WebPartZone una zona, verranno automaticamente inclusi in un GenericWebPart controllo quando la pagina viene compilata.Because the controls are in a WebPartZone zone, they will be automatically wrapped with a GenericWebPart control when the page is compiled. Pertanto, è possibile dichiarare WebPart le proprietà della classe su questi controlli.So, you can declare WebPart class properties on these controls. Una volta caricata la pagina in un browser, se si fa clic sul pulsante Visualizza tutti i valori delle proprietà , i dettagli per ogni controllo vengono visualizzati in un'etichetta.After you load the page in a browser, if you click the Display All Property Values button, the details for each control are displayed in a label. Per illustrare il GenericWebPart funzionamento del controllo, Calendar il controllo nella prima GenericWebPart zona presenta alcune delle proprietà impostate nel markup dichiarativo della pagina aspx, mentre il controllo non BulletedList lo è.To show how the GenericWebPart control works, the Calendar control in the first zone has some of the GenericWebPart properties set in the declarative markup of the .aspx page, whereas the BulletedList control does not. Una volta caricata la pagina, si notino le differenze nei valori delle proprietà dei due controlli e che dispongono di un GenericWebPart controllo padre.After you load the page, note the differences in the property values for the two controls, and that both have a parent GenericWebPart control.

<%@ Page Language="C#" 
  Codefile="genericwebpart.cs" 
  Inherits="genericwebpart_sample" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>GenericWebPart Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:WebPartManager ID="WebPartManager1" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server"
            Title="My Calendar"
            Description="A calendar used as a GenericWebPart control."
            CatalogIconImageUrl="MyCatalogIcon.gif"
            TitleIconimageUrl ="MyTitleIcon.gif"
            TitleUrl="MyInfoUrl.htm" 
            Width="250"/>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink">
            <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>        
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Button ID="Button1" width="200"
        runat="server" 
        Text="Display All Property Values" OnClick="Button1_Click" /> 
      <br />
      <asp:Label ID="Label2" runat="server" Text="" />
      <br />   
      <asp:Label ID="Label3" runat="server" Text="" />
    </form>
</body>
</html>
<%@ Page Language="vb" 
  Codefile="genericwebpart.vb" 
  Inherits="genericwebpart_sample" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>GenericWebPart Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:WebPartManager ID="WebPartManager1" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server"
            Title="My Calendar"
            Description="A calendar used as a GenericWebPart control."
            CatalogIconImageUrl="MyCatalogIcon.gif"
            TitleIconimageUrl ="MyTitleIcon.gif"
            TitleUrl="MyInfoUrl.htm" 
            Width="250"/>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink">
            <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>        
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Button ID="Button1" width="200"
        runat="server" 
        Text="Display All Property Values" OnClick="Button1_Click" /> 
      <br />
      <asp:Label ID="Label2" runat="server" Text="" />
      <br />   
      <asp:Label ID="Label3" runat="server" Text="" />
    </form>
</body>
</html>

Nella seconda parte dell'esempio di codice viene illustrata una classe parziale che accede ad alcune proprietà GenericWebPart del controllo a livello di codice.The second part of the code example shows a partial class that accesses some properties of the GenericWebPart control programmatically. Si noti che nel Page_Load metodo, il GetGenericWebPart metodo viene usato per recuperare l'istanza di Run GenericWebPart -Time del controllo che esegue il wrapping di un controllo server.Notice that in the Page_Load method, the GetGenericWebPart method is used to retrieve the run-time instance of the GenericWebPart control that wraps a server control. Questo approccio per ottenere un riferimento al controllo padre GenericWebPart consente di lavorare a livello di codice con un normale server o controllo utente come se fosse un WebPart controllo in fase di esecuzione.This approach of getting a reference to the parent GenericWebPart control enables you to work programmatically with an ordinary server or user control as if it were a WebPart control at run time.

using System;
using System.Data;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

public partial class genericwebpart_sample : System.Web.UI.Page
{
  GenericWebPart calendarPart;
  GenericWebPart listPart;

  protected void Page_Load(Object sender, EventArgs e)
  {
    calendarPart = WebPartManager1.GetGenericWebPart(Calendar1);
    listPart = WebPartManager1.GetGenericWebPart(BulletedList1);

    if (!IsPostBack)
    {
      Label2.Text = String.Empty;
      Label3.Text = String.Empty;
    }
  }

  protected void Button1_Click(object sender, EventArgs e)
  {

    Label2.Text =
      @"<h3>Calendar GenericWebPart Properties</h3>" +
      "<em>Title: </em>" + calendarPart.Title +
      "<br />" +
      "<em>CatalogIconImageUrl:  </em>" + calendarPart.CatalogIconImageUrl +
      "<br />" +
      "<em>TitleUrl: </em>" + calendarPart.TitleUrl +
      "<br />" +
      "<em>Decription: </em>" + calendarPart.Description +
      "<br />" +
      "<em>TitleIconImageUrl: </em>" + calendarPart.TitleIconImageUrl +
      "<br />" +
      "<em>ChildControl ID: </em>" + calendarPart.ChildControl.ID +
      "<br />" +
      "<em>ChildControl Type: </em>" + calendarPart.ChildControl.GetType().Name +
      "<br />" +
      "<em>GenericWebPart ID: </em>" + calendarPart.ID +
      "<br />" +
      "<em>GenericWebPart Type: </em>" + calendarPart.GetType().Name +
      "<br />" +
      "<em>GenericWebPart Parent ID: </em>" + calendarPart.Parent.ID;

    Label3.Text =
      @"<h3>BulletedList GenericWebPart Properties</h3>" +
      "<em>Title: </em>" + listPart.Title +
      "<br />" +
      "<em>CatalogIconImageUrl:  </em>" + listPart.CatalogIconImageUrl +
      "<br />" +
      "<em>TitleUrl: </em>" + listPart.TitleUrl +
      "<br />" +
      "<em>Decription: </em>" + listPart.Description +
      "<br />" +
      "<em>TitleIconImageUrl: </em>" + listPart.TitleIconImageUrl +
      "<br />" +
      "<em>ChildControl ID: </em>" + listPart.ChildControl.ID +
      "<br />" +
      "<em>ChildControl Type: </em>" + listPart.ChildControl.GetType().Name +
      "<br />" +
      "<em>GenericWebPart ID: </em>" + listPart.ID +
      "<br />" +
      "<em>GenericWebPart Type: </em>" + listPart.GetType().Name +
      "<br />" +
      "<em>GenericWebPart Parent ID: </em>" + listPart.Parent.ID;
  }
}
Imports System.Data
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.HtmlControls

Partial Public Class genericwebpart_sample

  Inherits System.Web.UI.Page

  Private calendarPart As GenericWebPart
  Private listPart As GenericWebPart

  Protected Sub Page_Load(ByVal sender As [Object], ByVal e As EventArgs)
    calendarPart = WebPartManager1.GetGenericWebPart(Calendar1)
    listPart = WebPartManager1.GetGenericWebPart(BulletedList1)

    If Not IsPostBack Then
      Label2.Text = String.Empty
      Label3.Text = String.Empty
    End If

  End Sub


  Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)

    Label2.Text = _
      "<h3>Calendar GenericWebPart Properties</h3>" & _
      "<em>Title: </em>" & calendarPart.Title & _
      "<br />" & _
      "<em>CatalogIconImageUrl:  </em>" & calendarPart.CatalogIconImageUrl & _
      "<br />" & _
      "<em>TitleUrl: </em>" & calendarPart.TitleUrl & _
      "<br />" & _
      "<em>Decription: </em>" & calendarPart.Description & _
      "<br />" & _
      "<em>TitleIconImageUrl: </em>" & calendarPart.TitleIconImageUrl & _
      "<br />" & _
      "<em>ChildControl ID: </em>" & calendarPart.ChildControl.ID & _
      "<br />" & _
      "<em>ChildControl Type: </em>" & calendarPart.ChildControl.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart ID: </em>" & calendarPart.ID & _
      "<br />" & _
      "<em>GenericWebPart Type: </em>" & calendarPart.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart Parent ID: </em>" & calendarPart.Parent.ID

    Label3.Text = _
      "<h3>BulletedList GenericWebPart Properties</h3>" & _
      "<em>Title: </em>" & listPart.Title & _
      "<br />" & _
      "<em>CatalogIconImageUrl:  </em>" & listPart.CatalogIconImageUrl & _
      "<br />" & _
      "<em>TitleUrl: </em>" & listPart.TitleUrl & _
      "<br />" & _
      "<em>Decription: </em>" & listPart.Description & _
      "<br />" & _
      "<em>TitleIconImageUrl: </em>" & listPart.TitleIconImageUrl & _
      "<br />" & _
      "<em>ChildControl ID: </em>" & listPart.ChildControl.ID & _
      "<br />" & _
      "<em>ChildControl Type: </em>" & listPart.ChildControl.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart ID: </em>" & listPart.ID & _
      "<br />" & _
      "<em>GenericWebPart Type: </em>" & listPart.GetType().Name & _
      "<br />" & _
      "<em>GenericWebPart Parent ID: </em>" & listPart.Parent.ID
  End Sub

End Class

Commenti

Il GenericWebPart controllo esiste per fornire un wrapper di runtime per i controlli server che non WebPart sono controlli, in modo che tali controlli possano essere utilizzati in Web part pagine e applicazioni.The GenericWebPart control exists to provide a run-time wrapper for server controls that are not WebPart controls, so that such controls can be used in Web Parts pages and applications. Quando gli sviluppatori aggiungono controlli server, ad esempio controlli utente, controlli server ASP.NET o controlli personalizzati esistenti, a un WebPartZoneBase controllo, il GenericWebPart controllo esegue automaticamente il wrapping dei controlli server in fase di esecuzione in modo che possano presentare lo stesso funzionalità come controlli WebPart true.When developers add server controls--such as user controls, ASP.NET server controls, or existing custom controls--to a WebPartZoneBase control, the GenericWebPart control automatically wraps the server controls at run time so they can exhibit the same functionality as true WebPart controls.

Nella tabella seguente vengono confrontati e GenericWebPart contrastati WebPart i controlli e i controlli.The following table compares and contrasts GenericWebPart controls and WebPart controls.

Controllo GenericWebPartGenericWebPart control Controllo WebPartWebPart control
Esiste per dotare i controlli server che WebPart non sono controlli con funzionalità Web part, in modo che qualsiasi ASP.NET, personalizzato o controllo utente possa partecipare alle applicazioni Web part.Exists to equip server controls that are not WebPart controls with Web Parts functionality, so that any ASP.NET, custom, or user control can participate in Web Parts applications. Esiste per creare controlli ASP.NET personalizzati con funzionalità native Web part predefinite.Exists to create custom ASP.NET controls that have native Web Parts functionality built in. Sono incluse funzionalità di personalizzazione, connessione, importazione ed esportazione e trascinamento della selezione.This includes personalization, connections, import and export, and drag-and-drop capabilities.
Non viene mai dichiarato nel markup di una pagina.Is never declared in the markup of a page. Esiste solo per eseguire il wrapping dei controlli server in fase di esecuzione e per assegnare al controllo con wrapping (o controllo figlio) la funzionalità WebPart completa di un controllo.It exists only to wrap server controls at run time, and to give the wrapped control (or child control) the full functionality of a WebPart control. Può essere dichiarato nel markup di una pagina in fase di progettazione, ad esempio un controllo server ASP.NET, ad eccezione del fatto che è WebPartZoneBase dichiarato in una zona.Can be declared in the markup of a page at design time, like an ASP.NET server control, except that it is declared in a WebPartZoneBase zone.
Include e integra il proprio controllo figlio nel processo di personalizzazione Web part, in modo che possa fungere da WebPart controllo reale.Includes and integrates its child control into the Web Parts personalization process so that it can act as a true WebPart control. Questa operazione viene eseguita automaticamente, semplificando l'uso di controlli server e controlli utente nelle applicazioni Web part.This occurs automatically, which makes it simple for developers to use server controls and user controls in Web Parts applications. Viene incluso automaticamente nel processo di personalizzazione Web part.Is automatically included in the Web Parts personalization process.
È possibile accedere a livello di codice in fase di esecuzione ( GetGenericWebPart usando il metodo e passando al controllo server figlio), ad esempio un WebPart controllo true o un controllo ASP.NET standard.Can be accessed programmatically at run time (by using the GetGenericWebPart method and passing to it the child server control), like a true WebPart control or a standard ASP.NET control. È possibile accedere a livello di codice in fase di esecuzione, ad esempio un controllo ASP.NET standard.Can be accessed programmatically at run time, like a standard ASP.NET control.

Gli utenti traggono vantaggio GenericWebPart dal controllo perché offre un'esperienza utente coerente.Users benefit from the GenericWebPart control because it provides a consistent user experience. Qualsiasi controllo server può essere eseguito per funzionare come un WebPart controllo e avrà gli stessi elementi dell'interfaccia utente coerenti, ad esempio verbi, icone, un titolo e un'intestazione.Any server control can be made to function like a WebPart control, and will have the same consistent user interface (UI) elements such as verbs, icons, a title, and a header. Gli sviluppatori traggono vantaggio GenericWebPart dal controllo perché consente loro di riutilizzare i controlli utente e i controlli server esistenti all'interno di Web part applicazioni.Developers benefit from the GenericWebPart control because it enables them to reuse existing user controls and server controls within Web Parts applications.

Nota

Quando si creano web part pagine, non è necessario eseguire alcuna operazione per abilitare il ritorno a capo di un controllo utente o di un controllo personalizzato GenericWebPart esistente con il controllo.When you create Web Parts pages, you do not have to do anything to enable an existing user control or custom control to be wrapped with the GenericWebPart control. È sufficiente aggiungere il controllo utente o server a WebPartZoneBase una zona, a livello di codice o dichiarando il controllo nel markup della pagina, e il set di controlli Web part esegue automaticamente il wrapping GenericWebPart del controllo con un oggetto in fase di esecuzione.Simply add your server or user control to a WebPartZoneBase zone, either programmatically or by declaring it in the page's markup, and the Web Parts control set automatically wraps your control with a GenericWebPart object at run time.

Poiché i controlli server posizionati in WebPartZoneBase zone sono racchiusi in GenericWebPart un controllo in fase di esecuzione, gli sviluppatori possono utilizzare i normali controlli server e utente WebPart esattamente come se fossero controlli.Because server controls that are placed in WebPartZoneBase zones are wrapped with a GenericWebPart control at run time, developers can use ordinary server and user controls exactly as if they were WebPart controls. Si noti che, se si dichiarano controlli personalizzati che ereditano dalla classe WebPartZonedi base Control all'interno di, questi controlli non possono WebPart supportare l'utilizzo delle proprietà intrinseche.Note that, if you declare custom controls that inherit from the base Control class within a WebPartZone, these controls cannot support the use of the intrinsic WebPart properties. Non è pertanto possibile dichiarare le IWebPart proprietà su tali controlli, incluse le proprietà, ad Title esempio la proprietà Description e la proprietà.Thus, you cannot declare the IWebPart properties on such controls, including properties such as the Title property and the Description property. Al contrario, altri tipi di controlli server, ad esempio WebPart controlli, controlli utente e controlli personalizzati che ereditano da WebControl, possono dichiarare queste proprietà, poiché supportano l'utilizzo delle proprietà expando.In contrast, other types of server controls (such as WebPart controls, user controls, and custom controls that inherit from WebControl) can declare these properties, because they support the use of expando properties.

Le proprietà expando sono in realtà stringhe che possono essere aggiunte a una classe in modo dinamico come proprietà, tramite l' IAttributeAccessor interfaccia.Expando properties are actually strings that can be added to a class dynamically as a property, by means of the IAttributeAccessor interface. I controlli che implementano questa interfaccia, WebControl inclusi la classe e i relativi elementi figlio, possono utilizzare le proprietà expando.Controls that implement this interface, including the WebControl class and its children, can use expando properties. Poiché la classe Control di base non supporta le proprietà expando, quando un controllo personalizzato che eredita Control dalla classe viene inserito in un WebPartZone oggetto e incluso in GenericWebPart un controllo in fase di esecuzione, il Web part set di controllo non può aggiungere in modo dinamico le IWebPart proprietà intrinseche al controllo personalizzato.Because the base Control class does not support expando properties, when a custom control that inherits from the Control class is placed in a WebPartZone and wrapped with a GenericWebPart control at run time, the Web Parts control set cannot dynamically add the intrinsic IWebPart properties to the custom control. In questo caso sono disponibili due opzioni.You have two choices in this case. È possibile utilizzare il controllo personalizzato senza le IWebPart proprietà oppure è possibile implementare l' IWebPart interfaccia nel controllo personalizzato, consentendo l'utilizzo delle proprietà.You can use the custom control without the IWebPart properties, or you can implement the IWebPart interface in the custom control, enabling it to use the properties.

Per un esempio di come WebControl i controlli che ereditano da possono usare le IWebPart proprietà, se si dichiara Calendar un controllo ASP.NET nel markup di una pagina (all' WebPartZoneBase interno di una zona) in fase di progettazione, anche se questo controllo non eredita dalla classe e non contiene WebPart membri in modo nativo, è comunque possibile considerarlo esattamente come un WebPart controllo. WebPartAs an example of how controls that inherit from WebControl can use the IWebPart properties, if you declare an ASP.NET Calendar control in the markup of a page (within a WebPartZoneBase zone) at design time, even though this control does not inherit from the WebPart class and does not natively contain WebPart members, you can still treat it exactly like a WebPart control. È possibile dichiarare WebPart proprietà nel controllo Calendar, Titlead esempio, Descriptione altri.You can declare WebPart properties on the calendar control, such as Title, Description, and others. In fase di esecuzione, è possibile utilizzare GetGenericWebPart il metodo, che restituisce GenericWebPart il controllo che esegue il wrapping dinamico del controllo Calendar e utilizzarlo a livello di codice esattamente come si farebbe con WebPart un controllo, con accesso a tutti gli stessi Proprietà, eventi e metodi.At run time, you can use the GetGenericWebPart method, which returns the GenericWebPart control that is dynamically wrapping the calendar control, and work with it programmatically exactly as you would with a WebPart control, with access to all the same properties, events, and methods.

Il GenericWebPart controllo ha una proprietà critica che consente di accedere al controllo server sottostante, ovvero la ChildControl proprietà.The GenericWebPart control has a critical property that allows you to access its underlying server control: the ChildControl property. Questa proprietà consente agli sviluppatori di accedere a livello di codice al controllo server.This property allows developers to programmatically access the server control. La ChildControl proprietà viene utilizzata anche WebPartManager dal controllo per accedere ai dati sulla personalizzazione dal controllo figlio e per eseguire l'autorizzazione, se la AuthorizationFilter proprietà è impostata.The ChildControl property is also used by the WebPartManager control to access personalization data from the child control, and to perform authorization, if the AuthorizationFilter property is set.

Il GenericWebPart controllo dispone di molte altre proprietà, tutte che eseguono l'override delle proprietà ereditate dalla classe base WebPart .The GenericWebPart control has several other properties, all of which override properties inherited from the base WebPart class. Come indicato, è possibile usare queste proprietà con qualsiasi controllo figlio, in modo che possa comportarsi WebPart come un controllo.As noted, you can use these properties with any child control, so that it can behave as a WebPart control. Una proprietà importante è la ExportMode proprietà, che determina se tutte le proprietà esportabili o solo quelle contrassegnate come non sensibili possono essere esportate.One important property is the ExportMode property; it determines whether all the exportable properties, or only those marked as non-sensitive, can be exported. Le proprietà orientate all'interfaccia utente WebPart ereditate dalla classe, CatalogIconImageUrlad esempio, Title Description Height, TitleUrl,, Widthe, possono essere impostate nel markup dichiarativo per qualsiasi controllo server che sia inserito in una WebPartZoneBase zona.The UI-oriented properties inherited from the WebPart class, such as CatalogIconImageUrl, Description, Height, Title, TitleUrl, and Width, can be set in the declarative markup for any server control that is placed in a WebPartZoneBase zone.

I metodi importanti della GenericWebPart classe includono il CreateControlCollection metodo, che crea la raccolta di controlli (inclusi i controlli figlio) associati a GenericWebPart un controllo e il Render metodo, che delega tutto il rendering all'oggetto controlli figlio con wrapper.Important methods in the GenericWebPart class include the CreateControlCollection method, which creates the collection of controls (including child controls) associated with a GenericWebPart control, and the Render method, which delegates all rendering to the wrapped child controls. I costruttori GenericWebPart della classe sono protetti e sono destinati a un uso interno o a scenari di estendibilità.The constructors on the GenericWebPart class are protected and are intended either for internal use or for extensibility scenarios.

Sono disponibili altre informazioni utili per l'uso GenericWebPart dei controlli.There are some additional helpful insights for working with GenericWebPart controls. Se si desidera impostare i valori predefiniti per le proprietà sottoposte a GenericWebPart override nella classe, il controllo utente o il controllo server personalizzato IWebPart può IWebActionable implementare le interfacce e ed eseguire l'override dei relativi membri.If you want to set default values for the overridden properties in the GenericWebPart class, your user control or custom server control can implement the IWebPart and IWebActionable interfaces, and override their members. In fase di esecuzione, GenericWebPart il controllo otterrà i valori per le proprietà implementate dal controllo figlio che implementa le interfacce.At run time, the GenericWebPart control will get its values for the implemented properties from the child control that implements the interfaces. Se il controllo definisce una delle proprietà personalizzabili (usando l' Personalizable attributo dei metadati), il GenericWebPart controllo Abilita automaticamente tali proprietà per la personalizzazione in fase di esecuzione, esattamente come le proprietà personalizzabili in un WebPart controllo.If your control defines any of its properties as personalizable (by using the Personalizable metadata attribute), the GenericWebPart control automatically enables those properties for personalization at run time, just like the personalizable properties on a WebPart control.

Se si desidera fornire Web part funzionalità di modifica per il controllo, è possibile implementare l' IWebEditable interfaccia.If you want to provide Web Parts editing features for your control, you can implement the IWebEditable interface. In fase di esecuzione, quando CreateEditorParts viene chiamato il metodo, GenericWebPart il codice del controllo per WebBrowsableObject la proprietà chiamerà nella stessa proprietà del controllo figlio e utilizzerà l'implementazione del controllo figlio per creare l'oggetto personalizzato EditorPart associato controlli.At run time, when the CreateEditorParts method is called, the GenericWebPart control's code for the WebBrowsableObject property will call into the same property in the child control, and use the child control's implementation to create associated custom EditorPart controls.

Note per gli eredi

Ci sono alcune occasioni in cui è necessario ereditare dalla GenericWebPart classe.There are few occasions where it is necessary to inherit from the GenericWebPart class. Uno di questi casi è se uno sviluppatore desidera implementare un'azione personalizzata nel costruttore quando viene creato un GenericWebPart controllo.One such case would be if a developer wants to implement some custom action in the constructor when a GenericWebPart control is created. Ad esempio, potrebbe essere necessario archiviare il controllo figlio in un punto diverso dalla raccolta di controlli all' GenericWebPart interno della classe.For example, you might want to store the child control somewhere other than the control collection within the GenericWebPart class. Se si eredita dalla GenericWebPart classe, è anche necessario ereditare WebPartManager dalla classe ed eseguire l'override del CreateWebPart(Control) relativo metodo per consentire la creazione del controllo personalizzato.If you inherit from the GenericWebPart class, you also need to inherit from the WebPartManager class and override its CreateWebPart(Control) method to enable it to create your custom control.

Costruttori

GenericWebPart(Control)

Inizializza una nuova istanza di un controllo GenericWebPart passando un riferimento a un controllo che diventa il controllo figlio.Initializes a new instance of a GenericWebPart control by passing in a reference to a control that becomes the child control.

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

Ottiene o imposta un valore che indica se un utente finale può chiudere un controllo WebPart in una pagina Web.Gets or sets a value indicating whether an end user can close a WebPart control on a Web page.

(Ereditato da WebPart)
AllowConnect

Ottiene o imposta un valore che indica se il controllo WebPart consente la creazione di connessioni con altri controlli.Gets or sets a value that indicates whether the WebPart control allows other controls to form connections with it.

(Ereditato da WebPart)
AllowEdit

Ottiene o imposta un valore che indica se un utente finale può modificare un controllo WebPart attraverso l'interfaccia utente fornita da uno o più controlli EditorPart.Gets or sets a value indicating whether an end user can modify a WebPart control through the user interface (UI) provided by one or more EditorPart controls.

(Ereditato da WebPart)
AllowHide

Ottiene o imposta un valore che indica se agli utenti finali è consentito nascondere un controllo WebPart.Gets or sets a value indicating whether end users are allowed to hide a WebPart control.

(Ereditato da WebPart)
AllowMinimize

Ottiene o imposta un valore che indica se gli utenti finali possono ridurre a icona un controllo WebPart.Gets or sets a value indicating whether end users can minimize a WebPart control.

(Ereditato da WebPart)
AllowZoneChange

Ottiene o imposta un valore che indica se un utente può spostare un controllo WebPart tra zone WebPartZoneBase.Gets or sets a value indicating whether a user can move a WebPart control between WebPartZoneBase zones.

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

Ottiene o imposta una stringa arbitraria per determinare se è stata autorizzata l'aggiunta di un controllo WebPart a una pagina.Gets or sets an arbitrary string to determine whether a WebPart control is authorized to be added to a page.

(Ereditato da WebPart)
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 dell'immagine di sfondo per il controllo pannello.Gets or sets the URL of the background image for the panel control.

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

Ottiene o imposta l'URL di un'immagine che rappresenta un controllo GenericWebPart in un catalogo di controlli.Gets or sets the URL to an image that represents a GenericWebPart control in a catalog of controls.

ChildControl

Ottiene un riferimento al controllo figlio di cui è stato eseguito il wrapping in un controllo GenericWebPart in fase di esecuzione.Gets a reference to the child control that is wrapped by a GenericWebPart control at run time.

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

Ottiene o imposta un controllo di parte in stato normale o ridotto a icona.Gets or sets whether a part control is in a minimized or normal state.

(Ereditato da WebPart)
ChromeType

Ottiene o imposta il tipo di bordo che delimita un controllo Web part.Gets or sets the type of border that frames a Web Parts control.

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

Ottiene un messaggio di errore da visualizzare agli utenti se si verifica un errore durante il processo di connessione.Gets an error message to display to users if errors occur during the connection process.

(Ereditato da WebPart)
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 contiene i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente.Gets a ControlCollection object that contains the child controls for a specified server control in the user interface hierarchy.

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

Ottiene o imposta l'identificatore per il pulsante predefinito contenuto nel controllo Panel.Gets or sets the identifier for the default button that is contained in the Panel control.

(Ereditato da Panel)
Description

Ottiene o imposta una breve frase che riepiloga la funzione del controllo da utilizzare nelle descrizioni comando e nei cataloghi dei controlli server.Gets or sets a brief phrase that summarizes what a control does, for use in ToolTips and catalogs of server controls.

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

Ottiene o imposta la direzione orizzontale del flusso del contenuto all'interno del controllo.Gets or sets the horizontal direction that content flows within the control.

(Ereditato da WebPart)
DisplayTitle

Ottiene una stringa che contiene il testo completo del titolo effettivamente visualizzato sulla barra del titolo di un'istanza del controllo WebPart.Gets a string that contains the full title text actually displayed in the title bar of a WebPart control instance.

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

Ottiene o imposta la possibilità di esportare, tutte, alcune o nessuna delle proprietà di un controllo WebPart.Gets or sets whether all, some, or none of a WebPart control's properties can be exported.

(Ereditato da WebPart)
Font

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

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

Ottiene o imposta la didascalia del gruppo di controlli contenuto nel controllo pannello.Gets or sets the caption for the group of controls that is contained in the panel control.

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

Ottiene un valore che indica se a un controllo WebPart sono associati dati sulla personalizzazione condivisi.Gets a value that indicates whether a WebPart control has any shared personalization data associated with it.

(Ereditato da WebPart)
HasUserData

Ottiene un valore che indica se a un controllo WebPart sono associati dati sulla personalizzazione.Gets a value that indicates whether a WebPart control has any user personalization data associated with it.

(Ereditato da WebPart)
Height

Ottiene o imposta l'altezza, in pixel, di un controllo.Gets or sets the height (in pixels) of a control.

HelpMode

Ottiene o imposta il tipo di interfaccia utente utilizzato per visualizzare la Guida relativa a un controllo WebPart.Gets or sets the type of user interface (UI) used to display Help content for a WebPart control.

(Ereditato da WebPart)
HelpUrl

Ottiene o imposta l'URL di una file della Guida relativo a un controllo WebPart.Gets or sets the URL to a Help file for a WebPart control.

(Ereditato da WebPart)
Hidden

Ottiene o imposta un valore che indica se un controllo WebPart viene visualizzato in una pagina Web.Gets or sets a value indicating whether a WebPart control is displayed on a Web page.

(Ereditato da WebPart)
HorizontalAlign

Ottiene o imposta l'allineamento orizzontale del contenuto all'interno del pannello.Gets or sets the horizontal alignment of the contents within the panel.

(Ereditato da Panel)
ID

Ottiene o imposta l'ID di un controllo.Gets or sets the ID of a control. Questo valore non è ereditabile.This value is not inheritable.

IdSeparator

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

(Ereditato da Control)
ImportErrorMessage

Ottiene o imposta un messaggio di errore utilizzato se si verifica un errore durante l'importazione di un controllo WebPart.Gets or sets an error message that is used if errors occur when a WebPart control is imported.

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

Ottiene un valore che indica se un controllo WebPart viene al momento chiuso in una pagina Web part.Gets a value that indicates whether a WebPart control is currently closed on a Web Parts page.

(Ereditato da WebPart)
IsEnabled

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

(Ereditato da WebControl)
IsShared

Ottiene un valore che indica se un controllo WebPart è condiviso, ovvero se è visibile a tutti gli utenti di una pagina Web part.Gets a value that indicates whether a WebPart control is shared, meaning that it is visible to all users of a Web Parts page.

(Ereditato da WebPart)
IsStandalone

Ottiene un valore che indica se un controllo WebPart è autonomo, vale a dire non contenuto in una zona WebPartZoneBase.Gets a value that indicates whether a WebPart control is standalone, meaning that it is not contained within a WebPartZoneBase zone.

(Ereditato da WebPart)
IsStatic

Ottiene un valore che indica se un controllo WebPart è statico, ovvero dichiarato nel markup di una pagina Web part e non aggiunto alla pagina a livello di codice.Gets a value that indicates whether a WebPart control is a static control, which means the control is declared in the markup of a Web Parts page and not added to the page programmatically.

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

Ottiene o imposta la visibilità e la posizione delle barre di scorrimento in un controllo Panel.Gets or sets the visibility and position of scroll bars in a Panel control.

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

Ottiene una stringa concatenata al valore della proprietà Title per creare un titolo completo per un controllo.Gets a string that is concatenated with the Title property value to form a complete title for a control.

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 Panel)
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 WebControl)
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)
Title

Ottiene o imposta il titolo di un controllo GenericWebPart.Gets or sets the title of a GenericWebPart control.

TitleIconImageUrl

Ottiene o imposta l'URL di un'immagine utilizzata per rappresentare un controllo GenericWebPart nella relativa barra del titolo.Gets or sets the URL to an image used to represent a GenericWebPart control in the control's own title bar.

TitleUrl

Ottiene o imposta un URL di informazioni supplementari relative a un controllo GenericWebPart.Gets or sets a URL to supplemental information about a GenericWebPart 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)
Verbs

Ottiene un insieme di verbi personalizzati associati a un controllo GenericWebPart.Gets a collection of custom verbs associated with a GenericWebPart control.

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

Ottiene un riferimento al controllo figlio, per consentire la modifica del controllo tramite controlli EditorPart personalizzati.Gets a reference to the child control, to enable the control to be edited by custom EditorPart controls.

WebPartManager

Ottiene un riferimento al controllo WebPartManager associato all'istanza di un controllo WebPart.Gets a reference to the WebPartManager control associated with a WebPart control instance.

(Ereditato da WebPart)
Width

Ottiene o imposta la larghezza, in pixel, del controllo.Gets or sets the width (in pixels) of the control.

Wrap

Ottiene o imposta un valore che indica se il contenuto va a capo nel pannello.Gets or sets a value indicating whether the content wraps within the panel.

(Ereditato da Panel)
Zone

Ottiene la zona WebPartZoneBase che al momento contiene un controllo WebPart.Gets the WebPartZoneBase zone that currently contains a WebPart control.

(Ereditato da WebPart)
ZoneIndex

Ottiene la posizione dell'indice di un controllo WebPart all'interno della zona di appartenenza.Gets the index position of a WebPart control within its zone.

(Ereditato da WebPart)

Metodi

AddAttributesToRender(HtmlTextWriter)

Aggiunge all'elenco degli attributi di cui eseguire il rendering informazioni sull'immagine di sfondo, l'allineamento, il ritorno a capo e la direzione.Adds information about the background image, alignment, wrap, and direction to the list of attributes to render.

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

CreateControlCollection()

Esegue l'override del metodo base per creare un insieme di sola lettura costituito dal controllo figlio di cui è stato eseguito il wrapping in un controllo GenericWebPart.Overrides the base method to create a read-only collection that consists of the child control wrapped by a GenericWebPart control.

CreateControlStyle()

Crea un oggetto stile usato internamente dal controllo Panel per implementare tutte le proprietà correlate allo stile.Creates a style object that is used internally by the Panel control to implement all style related properties.

(Ereditato da Panel)
CreateEditorParts()

Restituisce un insieme di controlli EditorPart personalizzati che è possibile utilizzare per modificare il controllo figlio di un controllo GenericWebPart quando è in modalità di modifica.Returns a collection of custom EditorPart controls that can be used to edit the child control of a GenericWebPart control when it is in edit mode.

DataBind()

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

(Ereditato da Part)
DataBind(Boolean)

Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding.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)
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)

Ripristina le informazioni sullo stato di visualizzazione da una richiesta precedente salvata con il metodo SaveViewState().Restores view-state information from a previous request that was saved with the SaveViewState() method.

(Ereditato da WebControl)
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)
OnClosing(EventArgs)

Consente alle classi derivate di fornire una gestione personalizzata quando un controllo WebPart viene chiuso in una pagina Web part.Enables derived classes to provide custom handling when a WebPart control is closed on a Web Parts page.

(Ereditato da WebPart)
OnConnectModeChanged(EventArgs)

Consente alle classi derivate di fornire una gestione personalizzata quando un controllo WebPart inizia o termina il processo di connessione ad altri controlli.Enables derived classes to provide custom handling when a WebPart control is beginning or ending the process of connecting to other controls.

(Ereditato da WebPart)
OnDataBinding(EventArgs)

Genera l'evento DataBinding.Raises the DataBinding event.

(Ereditato da Control)
OnDeleting(EventArgs)

Consente alle classi derivate di fornire una gestione personalizzata quando un controllo WebPart viene rimosso definitivamente da una pagina Web part.Enables derived classes to provide custom handling when a WebPart control is permanently removed from a Web Parts page.

(Ereditato da WebPart)
OnEditModeChanged(EventArgs)

Consente alle classe derivate di fornire una gestione personalizzata quando un controllo WebPart entra o esce dalla modalità di modifica.Enables derived classes to provide custom handling when a WebPart control is entering or leaving edit mode.

(Ereditato da WebPart)
OnInit(EventArgs)

Genera l'evento Init.Raises the Init event.

(Ereditato da Control)
OnLoad(EventArgs)

Genera l'evento Load.Raises the Load event.

(Ereditato da Control)
OnPreRender(EventArgs)

Genera l'evento PreRender.Raises the PreRender event.

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

Delega il rendering del contenuto del controllo al controllo figlio.Delegates rendering the contents of the control to the child control.

RenderBeginTag(HtmlTextWriter)

Esegue il rendering del tag HTML di apertura del controllo Panel nel writer specificato.Renders the HTML opening tag of the Panel control to the specified writer.

(Ereditato da Panel)
RenderChildren(HtmlTextWriter)

Invia il contenuto di un controllo figlio del controllo server a un oggetto HtmlTextWriter fornito, che scrive il contenuto di cui verrà effettuato il rendering sul 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 del contenuto del controllo nel writer specificato.Renders the contents of the control to the specified writer. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
RenderControl(HtmlTextWriter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata.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 Panel nel writer specificato.Renders the HTML closing tag of the Panel control into the specified writer.

(Ereditato da Panel)
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 qualsiasi stato modificato dopo la chiamata del metodo TrackViewState().Saves any state that was modified after the TrackViewState() method was invoked.

(Ereditato da WebControl)
SetDesignModeState(IDictionary)

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

(Ereditato da Control)
SetPersonalizationDirty()

Imposta un flag che indica che i dati di personalizzazione dell'istanza del controllo WebPart corrente sono stati modificati.Sets a flag indicating that personalization data has changed for the current WebPart control instance.

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

Indica al controllo di tenere traccia delle modifiche apportate allo proprio stato di visualizzazione in modo che tali modifiche possano essere archiviate nella proprietà ViewState dell'oggetto.Causes the control to track changes to its view state so they can be stored in the object's ViewState property.

(Ereditato da WebPart)

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 allo sviluppatore di una finestra di progettazione per un controllo di parte composito di creare nuovamente i controlli figlio sull'area di progettazione.Allows the developer of a designer for a composite part control to recreate the control's child controls on the design surface.

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