Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Classe UserControl

Rappresenta un file ASCX, anche noto come controllo utente, richiesto da un server su cui viene ospitata un'applicazione Web ASP.NET. È necessario che il file sia chiamato da una pagina Web Form altrimenti si verificherà un errore del parser.

Spazio dei nomi:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public class UserControl : TemplateControl, 
	IAttributeAccessor, INamingContainer, IUserControlDesignerAccessor

Il tipo UserControl espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoUserControlInizializza una nuova istanza della classe UserControl.
In alto

  NomeDescrizione
Proprietà protetta.AdapterOttiene l'adattatore specifico del browser per il controllo. (Ereditato da Control)
Proprietà pubblicaApplicationOttiene l'oggetto Application per la richiesta Web corrente.
Proprietà pubblicaAppRelativeTemplateSourceDirectoryOttiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo. (Ereditato da Control)
Proprietà pubblicaAppRelativeVirtualPathOttiene o imposta il percorso relativo all'applicazione della directory virtuale per il file da cui il controllo viene analizzato e compilato. (Ereditato da TemplateControl)
Proprietà pubblicaAttributesOttiene un insieme di tutte le coppie di nomi e valori degli attributi dichiarate nel tag del controllo utente all'interno del file ASPX.
Proprietà protetta.AutoHandlersInfrastruttura. Obsoleta. La proprietà AutoHandlers è divenuta deprecata in ASP.NET 2.0. Viene utilizzata da classi generate e non è destinata all'utilizzo nel codice creato dall'utente. (Ereditato da TemplateControl)
Proprietà pubblicaBindingContainerInfrastruttura. Ottiene il controllo contenente l'associazione dati del controllo corrente. (Ereditato da Control)
Proprietà pubblicaCacheOttiene l'oggetto Cache associato all'applicazione contenente il controllo utente.
Proprietà pubblicaCachePolicyOttiene un riferimento a un insieme di parametri di cache per questo controllo utente.
Proprietà protetta.ChildControlsCreatedOttiene un valore che indica se i controlli figli del controllo server sono stati creati. (Ereditato da Control)
Proprietà pubblicaClientIDOttiene l'ID controllo per il markup HTML generato da ASP.NET. (Ereditato da Control)
Proprietà pubblicaClientIDModeOttiene o imposta l'algoritmo utilizzato per generare il valore della proprietà ClientID. (Ereditato da Control)
Proprietà protetta.ClientIDSeparatorOttiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID. (Ereditato da Control)
Proprietà protetta.ContextOttiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
Proprietà pubblicaControlsOttiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da Control)
Proprietà pubblicaDataItemContainerOttiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
Proprietà pubblicaDataKeysContainerOttiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
Proprietà protetta.DesignModeOttiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control)
Proprietà pubblicaEnableThemingOttiene o imposta un valore Boolean che indica se vengono applicati temi al controllo derivato dalla classe TemplateControl. (Ereditato da TemplateControl)
Proprietà pubblicaEnableViewStateOttiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente. (Ereditato da Control)
Proprietà protetta.EventsOttiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è in sola lettura. (Ereditato da Control)
Proprietà protetta.HasChildViewStateOttiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate. (Ereditato da Control)
Proprietà pubblicaIDOttiene o imposta l'identificatore a livello di codice assegnato al controllo server. (Ereditato da Control)
Proprietà protetta.IdSeparatorInfrastruttura. Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control)
Proprietà protetta.IsChildControlStateClearedOttiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo. (Ereditato da Control)
Proprietà pubblicaIsPostBackOttiene 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.
Proprietà protetta.IsTrackingViewStateOttiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione. (Ereditato da Control)
Proprietà protetta.IsViewStateEnabledOttiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente. (Ereditato da Control)
Proprietà protetta.LoadViewStateByIDOttiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice. (Ereditato da Control)
Proprietà pubblicaNamingContainerOttiene 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à Control.ID. (Ereditato da Control)
Proprietà pubblicaPageOttiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control)
Proprietà pubblicaParentOttiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina. (Ereditato da Control)
Proprietà pubblicaRenderingCompatibilityOttiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering. (Ereditato da Control)
Proprietà pubblicaRequestOttiene l'oggetto HttpRequest per la richiesta Web corrente.
Proprietà pubblicaResponseOttiene l'oggetto HttpResponse per la richiesta Web corrente.
Proprietà pubblicaServerOttiene l'oggetto HttpServerUtility per la richiesta Web corrente.
Proprietà pubblicaSessionOttiene l'oggetto HttpSessionState per la richiesta Web corrente.
Proprietà pubblicaSiteOttiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. (Ereditato da Control)
Proprietà pubblicaSkinIDOttiene o imposta l'interfaccia da applicare al controllo. (Ereditato da Control)
Proprietà protetta.SupportAutoEventsInfrastruttura. Ottiene un valore che indica se il controllo TemplateControl supporta gli eventi automatici. (Ereditato da TemplateControl)
Proprietà pubblicaTemplateControlOttiene o imposta un riferimento al modello che contiene il controllo. (Ereditato da Control)
Proprietà pubblicaTemplateSourceDirectoryOttiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente. (Ereditato da Control)
Proprietà pubblicaTraceOttiene l'oggetto TraceContext per la richiesta Web corrente.
Proprietà pubblicaUniqueIDOttiene l'identificatore univoco qualificato gerarchicamente per il controllo server. (Ereditato da Control)
Proprietà pubblicaValidateRequestModeOttiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser. (Ereditato da Control)
Proprietà protetta.ViewStateOttiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina. (Ereditato da Control)
Proprietà protetta.ViewStateIgnoresCaseOttiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole. (Ereditato da Control)
Proprietà pubblicaViewStateModeOttiene o imposta la modalità dello stato, visualizzazione di questo controllo. (Ereditato da Control)
Proprietà pubblicaVisibleOttiene o imposta un valore che indica se un controllo server viene visualizzato come interfaccia utente sulla pagina. (Ereditato da Control)
In alto

  NomeDescrizione
Metodo protettoAddedControlViene chiamato dopo che un controllo è stato aggiunto all'insieme Controls dell'oggetto Control. (Ereditato da Control)
Metodo protettoAddParsedSubObjectNotifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server. (Ereditato da Control)
Metodo pubblicoApplyStyleSheetSkinApplica al controllo le proprietà di stile definite nel foglio di stile della pagina. (Ereditato da Control)
Metodo protettoBeginRenderTracingInizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
Metodo protettoBuildProfileTreeInfrastruttura. Raccoglie informazioni sul controllo server e le recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina. (Ereditato da Control)
Metodo protettoClearCachedClientIDInfrastruttura. Imposta il valore memorizzato nella cache ClientID su null. (Ereditato da Control)
Metodo protettoClearChildControlStateElimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control)
Metodo protettoClearChildStateElimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control)
Metodo protettoClearChildViewStateElimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control)
Metodo protettoClearEffectiveClientIDModeInfrastruttura. Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control)
Metodo protettoConstructEsegue la logica in fase di progettazione. (Ereditato da TemplateControl)
Metodo protettoCreateChildControlsViene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che utilizzano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti per la preparazione al postback o al rendering. (Ereditato da Control)
Metodo protettoCreateControlCollectionCrea un nuovo oggetto ControlCollection per contenere i controlli figlio (letterali e server) del controllo server. (Ereditato da Control)
Metodo protettoCreateResourceBasedLiteralControlInfrastruttura. Accede a stringhe letterali archiviate in una risorsa. Il metodo CreateResourceBasedLiteralControl non è destinato all'utilizzo all'interno del codice creato dall'utente. (Ereditato da TemplateControl)
Metodo pubblicoDataBind()Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. (Ereditato da Control)
Metodo protettoDataBind(Boolean)Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding. (Ereditato da Control)
Metodo protettoDataBindChildrenAssocia un'origine dati al controllo server e ai relativi controlli figlio. (Ereditato da Control)
Metodo pubblicoDesignerInitializeEsegue tutte le operazioni di inizializzazione nel controllo utente richieste dalle progettazioni RAD.
Metodo pubblicoDisposeAbilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria. (Ereditato da Control)
Metodo protettoEndRenderTracingTermina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
Metodo protettoEnsureChildControlsDetermina se il controllo server contiene controlli figlio. In caso contrario, li crea. (Ereditato da Control)
Metodo protettoEnsureIDCrea un identificatore per i controlli a cui non è assegnato alcun identificatore. (Ereditato da Control)
Metodo pubblicoEquals(Object) Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Metodo protettoEval(String)Valuta un'espressione di associazione dati. (Ereditato da TemplateControl)
Metodo protettoEval(String, String)Valuta un'espressione di associazione dati utilizzando la stringa di formato specificata per visualizzare il risultato. (Ereditato da TemplateControl)
Metodo protettoFinalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblicoFindControl(String)Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato. (Ereditato da Control)
Metodo protettoFindControl(String, Int32)Infrastruttura. Cerca nel contenitore di denominazione corrente un controllo server con il parametro id indicato e un intero, specificato nel parametro pathOffset, che agevola la ricerca. Non eseguire l'override di questa versione del metodo FindControl. (Ereditato da Control)
Metodo pubblicoFocusImposta lo stato attivo per l'input su un controllo. (Ereditato da Control)
Metodo protettoFrameworkInitializeInfrastruttura. Inizializza il controllo derivato dalla classe TemplateControl. (Ereditato da TemplateControl)
Metodo protettoGetDesignModeStateInfrastruttura. Ottiene i dati della fase di progettazione per un controllo. (Ereditato da Control)
Metodo protettoGetGlobalResourceObject(String, String)Ottiene un oggetto risorsa a livello di applicazione basato sulle proprietà ClassKey e ResourceKey specificate. (Ereditato da TemplateControl)
Metodo protettoGetGlobalResourceObject(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. (Ereditato da TemplateControl)
Metodo pubblicoGetHashCode Funge da funzione hash per un particolare tipo. (Ereditato da Object)
Metodo protettoGetLocalResourceObject(String)Ottiene un oggetto risorsa a livello di pagina basato sulla proprietà ResourceKey specificata. (Ereditato da TemplateControl)
Metodo protettoGetLocalResourceObject(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. (Ereditato da TemplateControl)
Metodo pubblicoGetRouteUrl(Object)Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
Metodo pubblicoGetRouteUrl(RouteValueDictionary)Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
Metodo pubblicoGetRouteUrl(String, Object)Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
Metodo pubblicoGetRouteUrl(String, RouteValueDictionary)Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
Metodo pubblicoGetType Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblicoGetUniqueIDRelativeToRestituisce la parte con prefisso della proprietà UniqueID del controllo specificato. (Ereditato da Control)
Metodo pubblicoHasControlsDetermina se il controllo server contiene controlli figlio. (Ereditato da Control)
Metodo protettoHasEventsRestituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio. (Ereditato da Control)
Metodo pubblicoInitializeAsUserControlInizializza l'oggetto UserControl creato in modo dichiarativo. Poiché esistono alcune differenze tra le pagine ed i controlli utente, questo metodo garantisce che il controllo utente sia inizializzato in modo corretto.
Metodo protettoIsLiteralContentInfrastruttura. Determina se il controllo server conserva solo il contenuto literal. (Ereditato da Control)
Metodo pubblicoLoadControl(String)Carica un controllo Control da un file in base al percorso virtuale specificato. (Ereditato da TemplateControl)
Metodo pubblicoLoadControl(Type, Object[])Carica un oggetto Control in base al tipo e ai parametri del costruttore specificati. (Ereditato da TemplateControl)
Metodo protettoLoadControlStateRipristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState. (Ereditato da Control)
Metodo pubblicoLoadTemplateRecupera un'istanza dell'interfaccia ITemplate da un file esterno. (Ereditato da TemplateControl)
Metodo protettoLoadViewStateRipristina le informazioni sullo stato di visualizzazione da una richiesta precedente del controllo utente salvata utilizzando il metodo SaveViewState. (Esegue l'override di Control.LoadViewState(Object)).
Metodo pubblicoMapPathAssegna un percorso di file virtuale, assoluto o relativo, a un percorso fisico.
Metodo protettoMapPathSecureRecupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
Metodo protettoMemberwiseClone Crea una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo protettoOnAbortTransactionGenera l'evento AbortTransaction. (Ereditato da TemplateControl)
Metodo protettoOnBubbleEventDetermina se l'evento per il controllo server è passato alla gerarchia del controllo server dell'interfaccia utente della pagina. (Ereditato da Control)
Metodo protettoOnCommitTransactionGenera l'evento CommitTransaction. (Ereditato da TemplateControl)
Metodo protettoOnDataBindingGenera l'evento DataBinding. (Ereditato da Control)
Metodo protettoOnErrorGenera l'evento Error. (Ereditato da TemplateControl)
Metodo protettoOnInitGenera l'evento Init. (Esegue l'override di Control.OnInit(EventArgs)).
Metodo protettoOnLoadGenera l'evento Load. (Ereditato da Control)
Metodo protettoOnPreRenderGenera l'evento PreRender. (Ereditato da Control)
Metodo protettoOnUnloadGenera l'evento Unload. (Ereditato da Control)
Metodo protettoOpenFileOttiene un oggetto Stream utilizzato per leggere un file. (Ereditato da Control)
Metodo pubblicoParseControl(String)Analizza una stringa di input in un oggetto Control presente nel controllo utente o nella pagina Web Form. (Ereditato da TemplateControl)
Metodo pubblicoParseControl(String, Boolean)Analizza una stringa di input in un oggetto Control presente nel controllo utente o nella pagina Web ASP.NET. (Ereditato da TemplateControl)
Metodo protettoRaiseBubbleEventAssegna eventuali origini dell'evento e relative informazioni al controllo padre. (Ereditato da Control)
Metodo pubblicoReadStringResource()Infrastruttura. Legge una risorsa di tipo stringa. Il metodo ReadStringResource non è destinato all'utilizzo all'interno del codice creato dall'utente. (Ereditato da TemplateControl)
Metodo protettoRemovedControlViene chiamato dopo la rimozione di un controllo figlio dall'insieme Controls dell'oggetto Control. (Ereditato da Control)
Metodo protettoRenderInvia il contenuto del controllo server a un oggetto HtmlTextWriter fornito, che scrive il contenuto di cui si effettuerà il rendering sul client. (Ereditato da Control)
Metodo protettoRenderChildrenInvia 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. (Ereditato da Control)
Metodo pubblicoRenderControl(HtmlTextWriter)Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter fornito e memorizza le informazioni di tracciatura relative al controllo se questa funzionalità è attivata. (Ereditato da Control)
Metodo protettoRenderControl(HtmlTextWriter, ControlAdapter)Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato. (Ereditato da Control)
Metodo protettoResolveAdapterOttiene l'adattatore del controllo responsabile del rendering del controllo specificato. (Ereditato da Control)
Metodo pubblicoResolveClientUrlOttiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
Metodo pubblicoResolveUrlConverte un URL in un formato utilizzabile dal client richiedente. (Ereditato da Control)
Metodo protettoSaveControlStateSalva le modifiche allo stato di un controllo server apportate dal momento in cui è stato eseguito il postback della pagina al server. (Ereditato da Control)
Metodo protettoSaveViewStateSalva le modifiche allo stato di visualizzazione del controllo utente apportate dall'ultima esecuzione del postback della pagina. (Esegue l'override di Control.SaveViewState()).
Metodo protettoSetDesignModeStateImposta i dati della fase di progettazione per un controllo. (Ereditato da Control)
Metodo pubblicoSetRenderMethodDelegateInfrastruttura. Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control)
Metodo protettoSetStringResourcePointerInfrastruttura. Imposta un puntatore a una risorsa di tipo stringa. Il metodo SetStringResourcePointer viene utilizzato da classi generate e non è destinato all'utilizzo all'interno del codice creato dall'utente. (Ereditato da TemplateControl)
Metodo pubblicoSetTraceData(Object, Object)Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
Metodo pubblicoSetTraceData(Object, Object, Object)Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
Metodo pubblicoTestDeviceFilterRestituisce un valore Boolean che indica se un filtro di periferica viene applicato alla richiesta HTTP. (Ereditato da TemplateControl)
Metodo pubblicoToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Metodo protettoTrackViewStateAttiva il rilevamento delle modifiche dello stato di visualizzazione nel controllo server per consentirne la memorizzazione nell'oggetto StateBag del controllo server. È possibile accedere a questo oggetto tramite la proprietà Control.ViewState. (Ereditato da Control)
Metodo pubblicoTryUpdateModel<TModel>(TModel)Tenta di aggiornare l'istanza del modello tramite i valori dal controllo associato ai dati.
Metodo pubblicoTryUpdateModel<TModel>(TModel, IValueProvider)Tenta di aggiornare l'istanza del modello specificato tramite valori del provider di valori.
Metodo pubblicoUpdateModel<TModel>(TModel)Aggiorna l'istanza del modello tramite valori dal controllo associato ai dati.
Metodo pubblicoUpdateModel<TModel>(TModel, IValueProvider)Aggiorna l'istanza del modello specificato tramite valori del provider di valori del controllo utente.
Metodo protettoWriteUTF8ResourceStringInfrastruttura. Scrive una stringa di risorsa in un controllo HtmlTextWriter. Il metodo WriteUTF8ResourceString viene utilizzato da classi generate e non è destinato all'utilizzo all'interno del codice creato dall'utente. (Ereditato da TemplateControl)
Metodo protettoXPath(String)Valuta un'espressione di associazione dati XPath. (Ereditato da TemplateControl)
Metodo protettoXPath(String, String)Valuta un'espressione di associazione dati XPath utilizzando la stringa di formato specificata per visualizzare il risultato. (Ereditato da TemplateControl)
Metodo protettoXPath(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. (Ereditato da TemplateControl)
Metodo protettoXPath(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. (Ereditato da TemplateControl)
Metodo protettoXPathSelect(String)Valuta un'espressione di associazione dati XPath e restituisce un insieme di nodi che implementa l'interfaccia IEnumerable. (Ereditato da TemplateControl)
Metodo protettoXPathSelect(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. (Ereditato da TemplateControl)
In alto

  NomeDescrizione
Evento pubblicoAbortTransactionSi verifica quando un utente completa una transazione. (Ereditato da TemplateControl)
Evento pubblicoCommitTransactionViene generato al termine di una transazione. (Ereditato da TemplateControl)
Evento pubblicoDataBindingViene generato quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
Evento pubblicoDisposedSi verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control)
Evento pubblicoErrorViene generato quando viene generata un'eccezione non gestita. (Ereditato da TemplateControl)
Evento pubblicoInitViene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata. (Ereditato da Control)
Evento pubblicoLoadViene generato quando il controllo server è caricato nell'oggetto Page. (Ereditato da Control)
Evento pubblicoPreRenderSi verifica dopo il caricamento dell'oggetto Control ma prima del rendering. (Ereditato da Control)
Evento pubblicoUnloadViene generato quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)
In alto

  NomeDescrizione
Metodo di estensione pubblicoEnableDynamicData(Type)Sottoposto a overload. Abilita il comportamento dati dinamici per il controllo dei dati specificato. (Definito da DataControlExtensions).
Metodo di estensione pubblicoEnableDynamicData(Type, Object)Sottoposto a overload. Abilita il comportamento dati dinamici per il controllo dei dati specificato. (Definito da DataControlExtensions).
Metodo di estensione pubblicoEnableDynamicData(Type, IDictionary<String, Object>)Sottoposto a overload. Abilita il comportamento dati dinamici per il controllo dei dati specificato. (Definito da DataControlExtensions).
Metodo di estensione pubblicoFindDataSourceControlRestituisce l'origine dati associata al controllo dati per il controllo specificato. (Definito da DynamicDataExtensions).
Metodo di estensione pubblicoFindFieldTemplateRestituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato. (Definito da DynamicDataExtensions).
Metodo di estensione pubblicoFindMetaTableRestituisce l'oggetto metatabella per il controllo contenitore dei dati. (Definito da DynamicDataExtensions).
Metodo di estensione pubblicoGetDefaultValuesOttiene l'insieme di valori predefiniti per il controllo dei dati specificato. (Definito da DynamicDataExtensions).
Metodo di estensione pubblicoGetMetaTableOttiene i metadati della tabella per il controllo dei dati specificato. (Definito da DynamicDataExtensions).
Metodo di estensione pubblicoSetMetaTable(MetaTable)Sottoposto a overload. Imposta i metadati della tabella per il controllo dei dati specificato. (Definito da DynamicDataExtensions).
Metodo di estensione pubblicoSetMetaTable(MetaTable, IDictionary<String, Object>)Sottoposto a overload. Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato. (Definito da DynamicDataExtensions).
Metodo di estensione pubblicoSetMetaTable(MetaTable, Object)Sottoposto a overload. Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato. (Definito da DynamicDataExtensions).
Metodo di estensione pubblicoTryGetMetaTableDetermina se sono disponibili i metadati della tabella. (Definito da DynamicDataExtensions).
In alto

  NomeDescrizione
Implementazione esplicita dell'interfacciaMetodo privatoIAttributeAccessor.GetAttributeInfrastruttura. Restituisce il valore dell'attributo specificato del controllo utente.
Implementazione esplicita dell'interfacciaMetodo privatoIAttributeAccessor.SetAttributeInfrastruttura. Imposta il valore dell'attributo specificato del controllo utente.
Implementazione esplicita dell'interfacciaProprietà privataIControlBuilderAccessor.ControlBuilderPer una descrizione di questo membro, vedere IControlBuilderAccessor.ControlBuilder. (Ereditato da Control)
Implementazione esplicita dell'interfacciaMetodo privatoIControlDesignerAccessor.GetDesignModeStatePer una descrizione di questo membro, vedere IControlDesignerAccessor.GetDesignModeState. (Ereditato da Control)
Implementazione esplicita dell'interfacciaMetodo privatoIControlDesignerAccessor.SetDesignModeStatePer una descrizione di questo membro, vedere IControlDesignerAccessor.SetDesignModeState. (Ereditato da Control)
Implementazione esplicita dell'interfacciaMetodo privatoIControlDesignerAccessor.SetOwnerControlInfrastruttura. Per una descrizione di questo membro, vedere IControlDesignerAccessor.SetOwnerControl. (Ereditato da Control)
Implementazione esplicita dell'interfacciaProprietà privataIControlDesignerAccessor.UserDataPer una descrizione di questo membro, vedere IControlDesignerAccessor.UserData. (Ereditato da Control)
Implementazione esplicita dell'interfacciaProprietà privataIDataBindingsAccessor.DataBindingsPer una descrizione di questo membro, vedere IDataBindingsAccessor.DataBindings. (Ereditato da Control)
Implementazione esplicita dell'interfacciaProprietà privataIDataBindingsAccessor.HasDataBindingsPer una descrizione di questo membro, vedere IDataBindingsAccessor.HasDataBindings. (Ereditato da Control)
Implementazione esplicita dell'interfacciaProprietà privataIExpressionsAccessor.ExpressionsPer una descrizione di questo membro, vedere IExpressionsAccessor.Expressions. (Ereditato da Control)
Implementazione esplicita dell'interfacciaProprietà privataIExpressionsAccessor.HasExpressionsPer una descrizione di questo membro, vedere IExpressionsAccessor.HasExpressions. (Ereditato da Control)
Implementazione esplicita dell'interfacciaMetodo privatoIFilterResolutionService.CompareFiltersInfrastruttura. Restituisce un valore che indica se tra i due filtri di periferica specificati esiste una relazione padre/figlio. (Ereditato da TemplateControl)
Implementazione esplicita dell'interfacciaMetodo privatoIFilterResolutionService.EvaluateFilterInfrastruttura. Restituisce un valore che indica se il filtro specificato è un tipo dell'oggetto filtro corrente. (Ereditato da TemplateControl)
Implementazione esplicita dell'interfacciaMetodo privatoIParserAccessor.AddParsedSubObjectPer una descrizione di questo membro, vedere IParserAccessor.AddParsedSubObject. (Ereditato da Control)
Implementazione esplicita dell'interfacciaProprietà privataIUserControlDesignerAccessor.InnerTextInfrastruttura. Ottiene o imposta il testo compreso tra i tag di apertura e chiusura di un controllo utente.
Implementazione esplicita dell'interfacciaProprietà privataIUserControlDesignerAccessor.TagNameOttiene o imposta il nome completo dei tag del controllo utente.
In alto

La classe UserControl è associata a file con estensioni ASCX. Questi file vengono compilati in fase di esecuzione come oggetti UserControl e memorizzati nella cache del server.

È possibile annidare i controlli utente dichiarando un file ASCX all'interno di un altro file di questo tipo incluso l'ultimo in una pagina Web Form.

I controlli utente si trovano all'interno delle pagine Web Form di ASP.NET e rappresentano un metodo semplice ed efficace utilizzato dagli sviluppatori Web per l'acquisizione delle interfacce utente Web più diffuse. Per ciascun controllo utente è prevista la creazione di un'istanza e la successiva memorizzazione nella cache seguendo la stessa procedura utilizzata per gli oggetti Page. A differenza delle pagine, tuttavia, i controlli utente non possono essere chiamati separatamente, ma soltanto dalla pagina o dal controllo utente in cui sono contenuti.

Derivare da questa classe se si desidera creare un controllo utente utilizzando la tecnica code-behind. È consigliabile se si sviluppano pagine Web Form tramite questa tecnica.

Per ulteriori informazioni sulla creazione in modo dichiarativo dei controlli utente, vedere Web Forms User Controls.

TopicLocation
Procedura: includere controlli utente ASP.NET nelle pagine Web (Visual Studio)Generazione di applicazioni Web ASP.NET in Visual Studio
Procedura: creare controlli utente ASP.NET (Visual Studio)Generazione di applicazioni Web ASP.NET in Visual Studio
Procedura: memorizzare nella cache più versioni di un controllo utente in base ai parametriCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: creare controlli utente ASP.NETCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: convertire le pagine Web Form in controlli utente ASP.NETCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: considerare un controllo utente come controllo Web partCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: includere controlli utente ASP.NET nelle pagine WebCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: memorizzare nella cache più versioni di un controllo utente in base ai parametriGenerazione di applicazioni Web ASP.NET
Procedura: convertire le pagine Web Form in controlli utente ASP.NETGenerazione di applicazioni Web ASP.NET
Procedura: considerare un controllo utente come controllo Web partGenerazione di applicazioni Web ASP.NET
Procedura: memorizzare nella cache più versioni di un controllo utente in base ai parametriCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: creare controlli utente ASP.NETCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: convertire le pagine Web Form in controlli utente ASP.NETCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: considerare un controllo utente come controllo Web partCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: includere controlli utente ASP.NET nelle pagine WebCompilazione di applicazioni Web ASP.NET in Visual Studio

La classe definita nell'esempio riportato di seguito, denominata SimpleControl, eredita la classe UserControl e può essere utilizzata come classe code-behind ASP.NET. Tale classe utilizza i controlli server Web TextBox, Label e Button e definisce un metodo myButton_Click che assegna il valore della proprietà TextBox.Text, insieme a due stringhe, alla proprietà Label.Text.

Nota sulla sicurezzaNota sulla sicurezza

L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per ulteriori informazioni, vedere 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 + ".";

  }

}


Nell'esempio riportato di seguito viene illustrato il markup contenuto in un file ASCX. È possibile utilizzare la classe SimpleControl definita nell'esempio precedente come classe code-behind per i markup contenuti nel file ASCX.


<%@ 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>


.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft