UserControl Classe

Definizione

Rappresenta un file ASCX, anche noto come controllo utente, richiesto da un server su cui viene ospitata un'applicazione Web ASP.NET.Represents an .ascx file, also known as a user control, requested from a server that hosts an ASP.NET Web application. È necessario che il file sia chiamato da una pagina Web Form altrimenti si verificherà un errore del parser.The file must be called from a Web Forms page or a parser error will occur.

public ref class UserControl : System::Web::UI::TemplateControl, System::Web::UI::IAttributeAccessor, System::Web::UI::IUserControlDesignerAccessor
public class UserControl : System.Web.UI.TemplateControl, System.Web.UI.IAttributeAccessor, System.Web.UI.IUserControlDesignerAccessor
type UserControl = class
    inherit TemplateControl
    interface IAttributeAccessor
    interface INamingContainer
    interface IUserControlDesignerAccessor
Public Class UserControl
Inherits TemplateControl
Implements IAttributeAccessor, IUserControlDesignerAccessor
Ereditarietà
Derivato
Implementazioni

Esempi

La classe definita nell'esempio seguente, SimpleControl, eredita la UserControl classe e può essere usata come classe code-behind ASP.NET.The class defined in the following example, SimpleControl, inherits the UserControl class and can be used as an ASP.NET code-behind class. USA TextBoxi controlli server LabelWeb, Button e e definisce un myButton_Click metodo che assegna Label.Text il valore della TextBox.Text proprietà, insieme a due stringhe, alla proprietà.It uses the TextBox, Label, and Button Web server controls and defines a myButton_Click method that assigns the TextBox.Text property value, along with two strings, to the Label.Text property.

Importante

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza.This example has a text box that accepts user input, which is a potential security threat. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite script.For more information, see Script Exploits Overview.

using System;
using System.Web.UI;
using System.Web.UI.WebControls;

public class SimpleControl:UserControl
{

  public TextBox name;
  public Label output;
  public Button myButton;

  public void myButton_Click(object sender, EventArgs e)
  { 
    output.Text = "Hello, " + name.Text + ".";

  }
 
}
Imports System.Web.UI
Imports System.Web.UI.WebControls


Public Class SimpleControl
   Inherits UserControl
   Public name As TextBox
   Public output As Label
   Public myButton As Button
   
   
   Public Sub myButton_Click(sender As Object, e As EventArgs)

      output.Text = "Hello, " + name.Text + "."

   End Sub  

End Class

Nell'esempio seguente viene riportato il markup contenuto in un file con estensione ascx.The following example is markup contained in an .ascx file. È possibile usare la SimpleControl classe definita nell'esempio precedente come classe code-behind per il markup in questo file con estensione ascx.You can use the SimpleControl class defined in the previous example as a code-behind class for the markup in this .ascx file.

<%@ control inherits = "SimpleControl" src = "SimpleControl.cs" %>

<table style="background-color:yellow;font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Enter your name here: </b></td>
<td><ASP:TextBox id="name" runat="server"/></td>
</tr>
<tr>
<td><b><ASP:Label id="output" runat="server"/></b></td>
</tr>
<tr>
<td></td>
<td><asp:button id="myButton" text="Submit" OnClick="myButton_Click" runat="server" /></td>
</tr>
</table>
<%@ control inherits = "SimpleControl" src = "SimpleControl.vb" %>

<table style="background-color: yellow; font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Enter your name here: </b></td>
<td><ASP:TextBox id="name" runat="server"/></td>
</tr>
<tr>
<td><b><ASP:Label id="output" runat="server"/></b></td>
</tr>
<tr>
<td></td>
<td><asp:button text="Submit" OnClick="myButton_Click" runat="server" /></td>
</tr>
</table>

Commenti

La UserControl classe è associata a file con estensione ascx.The UserControl class is associated with files that have .ascx extensions. Questi file vengono compilati in fase UserControl di esecuzione come oggetti e memorizzati nella cache del server.These files are compiled at run time as UserControl objects and cached in server memory.

È possibile annidare i controlli utente dichiarando un file con estensione ascx in un altro, incluso il secondo in una pagina Web Form.You can nest user controls by declaring one .ascx file in another including the latter in a Web Forms page.

I controlli utente sono contenuti nelle pagine Web Form ASP.NET e offrono agli sviluppatori Web un modo semplice per acquisire l'interfaccia utente Web di uso comune.User controls are contained in ASP.NET Web Forms pages, and offer Web developers an easy way to capture commonly used Web UI. Ne viene creata un'istanza e memorizzati nella cache in Page modo simile agli oggetti.They are instantiated and cached in ways similar to Page objects. Diversamente dalle pagine, tuttavia, i controlli utente non possono essere chiamati in modo indipendente.Unlike pages, however, user controls cannot be called independently. Possono essere chiamati solo dalla pagina o da un altro controllo utente che li contiene.They can only be called from the page or other user control that contains them.

Derivare da questa classe se si desidera creare un controllo utente utilizzando la tecnica code-behind.Derive from this class if you want to create a user control using the code-behind technique. Questa operazione è consigliata se si sviluppano pagine Web Form utilizzando questa tecnica.This is recommended if you are developing Web Forms pages using this technique.

Per informazioni sulla creazione di controlli utente in modo dichiarativo, vedere ASP.NET User Controls.For information about creating user controls declaratively, see ASP.NET User Controls.

Costruttori

UserControl()

Inizializza una nuova istanza della classe UserControl.Initializes a new instance of the UserControl class.

Proprietà

Adapter

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

(Ereditato da Control)
Application

Ottiene l'oggetto Application relativo alla richiesta Web corrente.Gets the Application object for the current Web request.

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

Ottiene o imposta il percorso relativo all'applicazione della directory virtuale per il file da cui il controllo viene analizzato e compilato.Gets or sets the application-relative, virtual directory path to the file from which the control is parsed and compiled.

(Ereditato da TemplateControl)
Attributes

Ottiene un insieme di tutte le coppie di nomi e valori degli attributi dichiarate nel tag del controllo utente all'interno del file ASPX.Gets a collection of all attribute name and value pairs declared in the user control tag within the .aspx file.

AutoHandlers

La proprietà AutoHandlers è stata deprecata in ASP.NET 2.0.The AutoHandlers property has been deprecated in ASP.NET NET 2.0. Viene utilizzata da classi generate e non è destinata all'utilizzo nel codice creato dall'utente.It is used by generated classes and is not intended for use within your code.

(Ereditato da TemplateControl)
BindingContainer

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

(Ereditato da Control)
Cache

Ottiene l'oggetto Cache associato all'applicazione contenente il controllo utente.Gets the Cache object that is associated with the application that contains the user control.

CachePolicy

Ottiene un riferimento a un insieme di parametri di cache per questo controllo utente.Gets a reference to a collection of caching parameters for this user control.

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 per un controllo server specificato nella gerarchia dell'interfaccia utente.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

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

Ottiene o imposta un valore Boolean che indica se vengono applicati temi al controllo derivato dalla classe TemplateControl.Gets or sets a Boolean value indicating whether themes apply to the control that is derived from the TemplateControl class.

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

Ottiene un valore che indica se il controllo utente viene caricato in risposta a un'operazione di postback del client o se viene caricato ed eseguito per la prima volta.Gets a value indicating whether the user control is being loaded in response to a client postback, or if it is being loaded and accessed for the first time.

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

Ottiene l'oggetto HttpRequest relativo alla richiesta Web corrente.Gets the HttpRequest object for the current Web request.

Response

Ottiene l'oggetto HttpResponse relativo alla richiesta Web corrente.Gets the HttpResponse object for the current Web request.

Server

Ottiene l'oggetto HttpServerUtility relativo alla richiesta Web corrente.Gets the HttpServerUtility object for the current Web request.

Session

Ottiene l'oggetto HttpSessionState relativo alla richiesta Web corrente.Gets the HttpSessionState object for the current Web request.

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

Ottiene un valore che indica se il controllo TemplateControl supporta gli eventi automatici.Gets a value indicating whether the TemplateControl control supports automatic events.

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

Ottiene l'oggetto TraceContext relativo alla richiesta Web corrente.Gets the TraceContext object for the current Web request.

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

Metodi

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

Esegue la logica in fase di progettazione.Performs design-time logic.

(Ereditato da TemplateControl)
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)
CreateResourceBasedLiteralControl(Int32, Int32, Boolean)

Accede a stringhe letterali archiviate in una risorsa.Accesses literal strings stored in a resource. Il metodo CreateResourceBasedLiteralControl(Int32, Int32, Boolean) non è destinato all'utilizzo all'interno del codice creato dall'utente.The CreateResourceBasedLiteralControl(Int32, Int32, Boolean) method is not intended for use from within your code.

(Ereditato da TemplateControl)
DataBind()

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

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

Esegue tutte le operazioni di inizializzazione nel controllo utente richieste dalle progettazioni RAD.Performs any initialization steps on the user control that are required by RAD designers.

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

Valuta un'espressione di associazione dati.Evaluates a data-binding expression.

(Ereditato da TemplateControl)
Eval(String, String)

Valuta un'espressione di associazione dati utilizzando la stringa di formato specificata per visualizzare il risultato.Evaluates a data-binding expression using the specified format string to display the result.

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

Inizializza il controllo derivato dalla classe TemplateControl.Initializes the control that is derived from the TemplateControl class.

(Ereditato da TemplateControl)
GetDesignModeState()

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

(Ereditato da Control)
GetGlobalResourceObject(String, String)

Ottiene un oggetto risorsa a livello di applicazione basato sulle proprietà ClassKey e ResourceKey specificate.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties.

(Ereditato da TemplateControl)
GetGlobalResourceObject(String, String, Type, String)

Ottiene un oggetto risorsa a livello di applicazione basato sulle proprietà ClassKey e ResourceKey, sul tipo di oggetto e sul nome di proprietà della risorsa specificati.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties, object type, and property name of the resource.

(Ereditato da TemplateControl)
GetHashCode()

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

(Ereditato da Object)
GetLocalResourceObject(String)

Ottiene un oggetto risorsa a livello di pagina basato sulla proprietà ResourceKey specificata.Gets a page-level resource object based on the specified ResourceKey property.

(Ereditato da TemplateControl)
GetLocalResourceObject(String, Type, String)

Ottiene un oggetto risorsa a livello di pagina basato sulla proprietà ResourceKey, sul tipo di oggetto e sul nome di proprietà specificati.Gets a page-level resource object based on the specified ResourceKey property, object type, and property name.

(Ereditato da TemplateControl)
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)
InitializeAsUserControl(Page)

Inizializza l'oggetto UserControl creato in modo dichiarativo.Initializes the UserControl object that has been created declaratively. Poiché esistono alcune differenze tra le pagine ed i controlli utente, questo metodo garantisce che il controllo utente sia inizializzato in modo corretto.Since there are some differences between pages and user controls, this method makes sure that the user control is initialized properly.

IsLiteralContent()

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

(Ereditato da Control)
LoadControl(String)

Carica un controllo Control da un file in base al percorso virtuale specificato.Loads a Control object from a file based on a specified virtual path.

(Ereditato da TemplateControl)
LoadControl(Type, Object[])

Carica un oggetto Control in base al tipo e ai parametri del costruttore specificati.Loads a Control object based on a specified type and constructor parameters.

(Ereditato da TemplateControl)
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)
LoadTemplate(String)

Recupera un'istanza dell'interfaccia ITemplate da un file esterno.Obtains an instance of the ITemplate interface from an external file.

(Ereditato da TemplateControl)
LoadViewState(Object)

Ripristina le informazioni sullo stato di visualizzazione da una precedente richiesta di controllo utente salvata dal metodo SaveViewState().Restores the view-state information from a previous user control request that was saved by the SaveViewState() method.

MapPath(String)

Assegna un percorso di file virtuale, assoluto o relativo, a un percorso fisico.Assigns a virtual file path, either absolute or relative, to a physical file path.

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

Genera l'evento AbortTransaction.Raises the AbortTransaction event.

(Ereditato da TemplateControl)
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)
OnCommitTransaction(EventArgs)

Genera l'evento CommitTransaction.Raises the CommitTransaction event.

(Ereditato da TemplateControl)
OnDataBinding(EventArgs)

Genera l'evento DataBinding.Raises the DataBinding event.

(Ereditato da Control)
OnError(EventArgs)

Genera l'evento Error.Raises the Error event.

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

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

Analizza una stringa di input in un oggetto Control presente nel controllo utente o nella pagina Web Form.Parses an input string into a Control object on the Web Forms page or user control.

(Ereditato da TemplateControl)
ParseControl(String, Boolean)

Analizza una stringa di input in un oggetto Control presente nel controllo utente o nella pagina Web ASP.NET.Parses an input string into a Control object on the ASP.NET Web page or user control.

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

Legge una risorsa di tipo stringa.Reads a string resource. Il metodo ReadStringResource() non è destinato all'utilizzo all'interno del codice creato dall'utente.The ReadStringResource() method is not intended for use from within your code.

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

Invia il contenuto del controllo server a un oggetto HtmlTextWriter specificato che scrive il contenuto di cui eseguire il rendering nel client.Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Ereditato da Control)
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)
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)
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 le modifiche allo stato di visualizzazione del controllo utente apportate dall'ultima esecuzione del postback della pagina.Saves any user control view-state changes that have occurred since the last page postback.

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)
SetStringResourcePointer(Object, Int32)

Imposta un puntatore a una risorsa di tipo stringa.Sets a pointer to a string resource. Il metodo SetStringResourcePointer(Object, Int32) viene utilizzato da classi generate e non è destinato all'utilizzo all'interno del codice creato dall'utente.The SetStringResourcePointer(Object, Int32) method is used by generated classes and is not intended for use from within your code.

(Ereditato da TemplateControl)
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)
TestDeviceFilter(String)

Restituisce un valore Boolean che indica se un filtro di periferica viene applicato alla richiesta HTTP.Returns a Boolean value indicating whether a device filter applies to the HTTP request.

(Ereditato da TemplateControl)
ToString()

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

(Ereditato da Object)
TrackViewState()

Attiva il rilevamento delle modifiche dello stato di visualizzazione nel controllo server per consentirne la memorizzazione nell'oggetto StateBag del controllo server.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. È possibile accedere a questo oggetto tramite la proprietà ViewState.This object is accessible through the ViewState property.

(Ereditato da Control)
TryUpdateModel<TModel>(TModel)

Tenta di aggiornare l'istanza del modello tramite i valori dal controllo associato ai dati.Attempts to update the model instance by using the values from the data-bound control.

TryUpdateModel<TModel>(TModel, IValueProvider)

Tenta di aggiornare l'istanza del modello specificato tramite valori del provider di valori.Attempts to update the model instance using values from the value provider.

UpdateModel<TModel>(TModel)

Aggiorna l'istanza del modello usando valori ottenuti dal controllo con associazione a dati.Updates the model instance by using values from the data-bound control.

UpdateModel<TModel>(TModel, IValueProvider)

Aggiorna l'istanza del modello specificata con i valori forniti dal provider di valori del controllo utente.Updates the specified model instance using values from the value provider of the user control.

WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean)

Scrive una stringa di risorsa in un controllo HtmlTextWriter.Writes a resource string to an HtmlTextWriter control. Il metodo WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) viene utilizzato da classi generate e non è destinato all'utilizzo all'interno del codice creato dall'utente.The WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) method is used by generated classes and is not intended for use from within your code.

(Ereditato da TemplateControl)
XPath(String)

Valuta un'espressione di associazione dati XPath.Evaluates an XPath data-binding expression.

(Ereditato da TemplateControl)
XPath(String, IXmlNamespaceResolver)

Valuta un'espressione di associazione dati XPath utilizzando i mapping di prefissi e spazi dei nomi specificati per la risoluzione degli spazi dei nomi.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution.

(Ereditato da TemplateControl)
XPath(String, String)

Valuta un'espressione di associazione dati XPath utilizzando la stringa di formato specificata per visualizzare il risultato.Evaluates an XPath data-binding expression using the specified format string to display the result.

(Ereditato da TemplateControl)
XPath(String, String, IXmlNamespaceResolver)

Valuta un'espressione di associazione dati XPath utilizzando i mapping di prefissi e spazi dei nomi specificati per la risoluzione degli spazi dei nomi e la stringa di formato specificata per visualizzare il risultato.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and the specified format string to display the result.

(Ereditato da TemplateControl)
XPathSelect(String)

Valuta un'espressione di associazione dati XPath e restituisce un insieme di nodi che implementa l'interfaccia IEnumerable.Evaluates an XPath data-binding expression and returns a node collection that implements the IEnumerable interface.

(Ereditato da TemplateControl)
XPathSelect(String, IXmlNamespaceResolver)

Valuta un'espressione di associazione dati XPath utilizzando i mapping di prefissi e spazi dei nomi specificati per la risoluzione degli spazi dei nomi e restituisce un insieme di nodi che implementa l'interfaccia IEnumerable.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and returns a node collection that implements the IEnumerable interface.

(Ereditato da TemplateControl)

Eventi

AbortTransaction

Si verifica quando un utente completa una transazione.Occurs when a user ends a transaction.

(Ereditato da TemplateControl)
CommitTransaction

Viene generato al termine di una transazione.Occurs when a transaction completes.

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

Viene generato quando viene generata un'eccezione non gestita.Occurs when an unhandled exception is thrown.

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

Restituisce il valore dell'attributo del controllo utente specificato.Returns the value of the specified user control attribute.

IAttributeAccessor.SetAttribute(String, String)

Imposta il valore dell'attributo del controllo utente specificato.Sets the value of the specified user control attribute.

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)
IFilterResolutionService.CompareFilters(String, String)

Restituisce un valore che indica se tra i due filtri di periferica specificati esiste una relazione padre/figlio.Returns a value that indicates whether a parent/child relationship exists between two specified device filters.

(Ereditato da TemplateControl)
IFilterResolutionService.EvaluateFilter(String)

Restituisce un valore che indica se il filtro specificato è un tipo dell'oggetto filtro corrente.Returns a value that indicates whether the specified filter is a type of the current filter object.

(Ereditato da TemplateControl)
IParserAccessor.AddParsedSubObject(Object)

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

(Ereditato da Control)
IUserControlDesignerAccessor.InnerText

Ottiene o imposta il testo compreso tra i tag di apertura e chiusura di un controllo utente.Gets or sets the text that appears between the opening and closing tags of a user control.

IUserControlDesignerAccessor.TagName

Ottiene o imposta il nome completo dei tag del controllo utente.Gets or sets the full tag name of the user 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