Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese
Questa documentazione è stata archiviata e non viene gestita.

Classe LinkButton

Visualizza un controllo pulsante con lo stile di un collegamento ipertestuale su una pagina Web.

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

public class LinkButton : WebControl, IButtonControl, 
	IPostBackEventHandler
<asp:LinkButton />

Il tipo LinkButton espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoLinkButtonInizializza una nuova istanza della classe LinkButton.
In alto

  NomeDescrizione
Proprietà pubblicaAccessKeyOttiene o imposta il tasto di scelta che consente di accedere rapidamente al controllo server Web. (Ereditato da WebControl)
Proprietà protetta.AdapterOttiene l'adattatore specifico del browser per il controllo. (Ereditato da Control)
Proprietà pubblicaAppRelativeTemplateSourceDirectoryOttiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo. (Ereditato da Control)
Proprietà pubblicaAttributesOttiene l'insieme di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo. (Ereditato da WebControl)
Proprietà pubblicaBackColorOttiene o imposta il colore di sfondo del controllo server Web. (Ereditato da WebControl)
Proprietà pubblicaBindingContainerInfrastruttura. Ottiene il controllo contenente l'associazione dati del controllo corrente. (Ereditato da Control)
Proprietà pubblicaBorderColorOttiene o imposta il colore del bordo del controllo Web. (Ereditato da WebControl)
Proprietà pubblicaBorderStyleOttiene o imposta lo stile del bordo del controllo server Web. (Ereditato da WebControl)
Proprietà pubblicaBorderWidthOttiene o imposta la larghezza del bordo del controllo server Web. (Ereditato da WebControl)
Proprietà pubblicaCausesValidationOttiene o imposta un valore che indica se viene eseguita la convalida quando si fa clic sul controllo LinkButton.
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à pubblicaCommandArgumentOttiene o imposta un argomento facoltativo passato al gestore eventi Command insieme alla proprietà CommandName associata.
Proprietà pubblicaCommandNameOttiene o imposta il nome di comando associato al controllo LinkButton. Il valore viene passato al gestore eventi Command insieme alla proprietà CommandArgument.
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à pubblicaControlStyleOttiene lo stile del controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Proprietà pubblicaControlStyleCreatedOttiene un valore che indica se è stato creato un oggetto Style per la proprietà ControlStyle. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Proprietà pubblicaCssClassOttiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. (Ereditato da WebControl)
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à pubblicaEnabledOttiene o imposta un valore che indica se il controllo server Web è abilitato. (Ereditato da WebControl)
Proprietà pubblicaEnableThemingOttiene o imposta un valore che indica se al controllo vengono applicati i temi. (Ereditato da WebControl)
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à pubblicaFontOttiene le proprietà del carattere associate al controllo server Web. (Ereditato da WebControl)
Proprietà pubblicaForeColorOttiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. (Ereditato da WebControl)
Proprietà pubblicaHasAttributesOttiene un valore che indica se sono impostati attributi per il controllo. (Ereditato da WebControl)
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à pubblicaHeightOttiene o imposta l'altezza del controllo server Web. (Ereditato da WebControl)
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à protetta.IsEnabledOttiene un valore che indica se il controllo è abilitato. (Ereditato da WebControl)
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à pubblicaOnClientClickOttiene o imposta lo script del lato client che viene eseguito quando viene generato l'evento Click di un controllo LinkButton.
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à pubblicaPostBackUrlOttiene o imposta l'URL della pagina a cui effettuare l'invio dalla pagina corrente quando viene fatto clic sul controllo LinkButton.
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à 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 WebControl)
Proprietà pubblicaStyleOttiene 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. (Ereditato da WebControl)
Proprietà pubblicaSupportsDisabledAttributeOttiene 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. (Esegue l'override di WebControl.SupportsDisabledAttribute).
Proprietà pubblicaTabIndexOttiene o imposta l'indice di tabulazione del controllo server Web. (Ereditato da WebControl)
Proprietà protetta.TagKeyOttiene il valore HtmlTextWriterTag corrispondente a questo controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Proprietà protetta.TagNameOttiene il nome del tag del controllo. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
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à pubblicaTextOttiene o imposta la didascalia visualizzata sul controllo LinkButton.
Proprietà pubblicaToolTipOttiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. (Ereditato da WebControl)
Proprietà pubblicaUniqueIDOttiene l'identificatore univoco qualificato gerarchicamente per il controllo server. (Ereditato da Control)
Proprietà pubblicaValidationGroupOttiene o imposta il gruppo di controlli per il quale il controllo LinkButton causa la convalida in occasione del postback al server.
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)
Proprietà pubblicaWidthOttiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl)
In alto

  NomeDescrizione
Metodo protettoAddAttributesToRenderInfrastruttura. Aggiunge gli attributi del controllo LinkButton al flusso di output per il rendering sul client. (Esegue l'override di WebControl.AddAttributesToRender(HtmlTextWriter)).
Metodo protettoAddedControlViene chiamato dopo che un controllo è stato aggiunto all'insieme Controls dell'oggetto Control. (Ereditato da Control)
Metodo protettoAddParsedSubObjectNotifica al controllo che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo. (Esegue l'override di Control.AddParsedSubObject(Object)).
Metodo pubblicoApplyStyleCopia tutti gli elementi non vuoti dello stile specificato nel controllo Web, sovrascrivendo eventuali elementi di stile del controllo. Il metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Metodo pubblicoApplyStyleSheetSkinApplica al controllo le proprietà di stile definite nel foglio di stile della pagina. (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 pubblicoCopyBaseAttributesCopia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web dal quale è stato chiamato il metodo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
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 protettoCreateControlStyleCrea l'oggetto di stile utilizzato internamente dalla classe WebControl per implementare tutte le proprietà correlate allo stile. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
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 pubblicoDisposeAbilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria. (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 Object specificato è uguale all'oggetto Object corrente. (Ereditato da Object)
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 protettoGetDesignModeStateInfrastruttura. Ottiene i dati della fase di progettazione per un controllo. (Ereditato da Control)
Metodo pubblicoGetHashCodeFunge da funzione hash per un determinato tipo. (Ereditato da Object)
Metodo protettoGetPostBackOptionsCrea un oggetto PostBackOptions che rappresenta il comportamento di postback del controllo LinkButton.
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 protettoIsLiteralContentInfrastruttura. Determina se il controllo server conserva solo il contenuto literal. (Ereditato da Control)
Metodo protettoLoadControlStateRipristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState. (Ereditato da Control)
Metodo protettoLoadViewStateRipristina le informazioni sullo stato di visualizzazione da una richiesta precedente salvata con il metodo SaveViewState. (Esegue l'override di WebControl.LoadViewState(Object)).
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 pubblicoMergeStyleCopia tutti gli elementi non vuoti dello stile specificato nel controllo Web, ma non sovrascrive eventuali elementi di stile del controllo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Metodo protettoOnBubbleEventDetermina se l'evento per il controllo server è passato alla gerarchia del controllo server dell'interfaccia utente della pagina. (Ereditato da Control)
Metodo protettoOnClickGenera l'evento Click del controllo LinkButton.
Metodo protettoOnCommandGenera l'evento Command del controllo LinkButton.
Metodo protettoOnDataBindingGenera l'evento DataBinding. (Ereditato da Control)
Metodo protettoOnInitGenera l'evento Init. (Ereditato da Control)
Metodo protettoOnLoadGenera l'evento Load. (Ereditato da Control)
Metodo protettoOnPreRenderGenera l'evento PreRender. (Esegue l'override di Control.OnPreRender(EventArgs)).
Metodo protettoOnUnloadGenera l'evento Unload. (Ereditato da Control)
Metodo protettoOpenFileOttiene un oggetto Stream utilizzato per leggere un file. (Ereditato da Control)
Metodo protettoRaiseBubbleEventAssegna eventuali origini dell'evento e relative informazioni al controllo padre. (Ereditato da Control)
Metodo protettoRaisePostBackEventGenera eventi per il controllo LinkButton durante il postback al server.
Metodo protettoRemovedControlViene chiamato dopo la rimozione di un controllo figlio dall'insieme Controls dell'oggetto Control. (Ereditato da Control)
Metodo protettoRenderEsegue il rendering del controllo nel writer HTML specificato. (Ereditato da WebControl)
Metodo pubblicoRenderBeginTagEsegue il rendering del tag HTML di apertura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
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 protettoRenderContentsEsegue il rendering del contenuto del controllo nel writer specificato. (Esegue l'override di WebControl.RenderContents(HtmlTextWriter)).
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 pubblicoRenderEndTagEsegue il rendering del tag HTML di chiusura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
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 tutti gli stati che sono stati modificati dopo che è stato richiamato il metodo TrackViewState. (Ereditato da WebControl)
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 pubblicoToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Metodo protettoTrackViewStateForza il controllo a tenere traccia dello modifiche apportate allo stato di visualizzazione in modo che vengano archiviate nella proprietà ViewState dell'oggetto. (Ereditato da WebControl)
In alto

  NomeDescrizione
Evento pubblicoClickViene generato quando si fa clic sul controllo LinkButton.
Evento pubblicoCommandViene generato quando si fa clic sul controllo LinkButton.
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 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 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).
In alto

  NomeDescrizione
Implementazione esplicita dell'interfacciaMetodo privatoIAttributeAccessor.GetAttributeInfrastruttura. Ottiene un attributo del controllo Web con il nome specificato. (Ereditato da WebControl)
Implementazione esplicita dell'interfacciaMetodo privatoIAttributeAccessor.SetAttributeImposta un attributo del controllo Web sul nome e il valore specificati. (Ereditato da WebControl)
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 privatoIParserAccessor.AddParsedSubObjectPer una descrizione di questo membro, vedere IParserAccessor.AddParsedSubObject. (Ereditato da Control)
Implementazione esplicita dell'interfacciaMetodo privatoIPostBackEventHandler.RaisePostBackEventPer una descrizione di questo membro, vedere il metodo IPostBackEventHandler.RaisePostBackEvent.
In alto

In questo argomento:

Introduzione

Utilizzare il controllo LinkButton per creare un pulsante con lo stile di un collegamento ipertestuale nella pagina Web. Il controllo LinkButton ha un aspetto simile a quello di un controllo HyperLink ma la stessa funzionalità di un controllo Button. Se si desidera eseguire un collegamento a un'altra pagina Web quando il controllo viene selezionato, provare a utilizzare il controllo HyperLink.

NotaNota

Il controllo LinkButton consente di eseguire il rendering di JavaScript nel browser client. In tale browser deve essere abilitato JavaScript per garantire il corretto funzionamento del controllo. Per ulteriori informazioni sullo script client, vedere Script client nelle pagine Web ASP.NET.

È possibile creare un pulsante di invio oppure un pulsante di comando. Ai pulsanti di invio non è associato un nome di comando, consentono soltanto di inviare di nuovo la pagina Web al server. Per impostazione predefinita, un controllo LinkButton rappresenta un pulsante di invio. È possibile fornire un gestore per l'evento Click allo scopo di controllare a livello di codice le azioni eseguite quando viene fatto clic sul pulsante di invio. A un pulsante di comando è invece associato un nome di comando, quale ad esempio Sort. Impostare la proprietà CommandName per specificare il nome di comando. Questo consente di creare più controlli LinkButton in una pagina Web e di determinare a livello di codice su quale controllo LinkButton viene fatto clic. È anche possibile utilizzare la proprietà CommandArgument con un pulsante di comando per fornire informazioni aggiuntive sul comando da eseguire, come la specifica dell'ordine crescente. È inoltre possibile fornire un gestore per l'evento Command allo scopo di controllare a livello di codice l'azione eseguita quando viene fatto clic sul pulsante di comando.

Nota di avvisoAttenzione

Il controllo può essere utilizzato per visualizzare l'input dell'utente, che potrebbe includere un client script non autorizzato. Il testo non viene codificato in formato HTML prima di essere visualizzato nel controllo LinkButton. Controllare tutte le informazioni inviate da un client per script eseguibile, istruzioni SQL o altro codice prima di visualizzarle nell'applicazione. In ASP.NET viene fornita una funzionalità di convalida delle richieste di input per bloccare script e codice HTML nell'input dell'utente. Vengono inoltre forniti i controlli server di convalida per valutare l'input dell'utente. Per ulteriori informazioni, vedere Sintassi per il controllo server di convalida.

Convalida e controlli LinkButton

Per impostazione predefinita, la convalida della pagina viene eseguita quando si fa clic su un controllo LinkButton. La convalida della pagina determina se i controlli di input associati a un controllo di convalida sulla pagina superano tutti le regole specificate dal controllo di convalida. Per impedire l'esecuzione della convalida della pagina, impostare la proprietà CausesValidation su false.

Sintassi dichiarativa

<asp:LinkButton
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CommandArgument="string"
    CommandName="string"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnClick="Click event handler"
    OnClientClick="string"
    OnCommand="Command event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PostBackUrl="uri"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>
TopicLocation
Procedura: aggiungere controlli server Web pulsante a una pagina Web Form (Visual Studio)Generazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: creazione e utilizzo di pagine master ASP.NET in Visual Web DeveloperGenerazione di applicazioni Web ASP.NET in Visual Studio
Procedura: rispondere ai clic dell'utente nei controlli server Web BulletedList (Visual Studio)Generazione di applicazioni Web ASP.NET in Visual Studio
Procedura dettagliata: creazione e utilizzo di pagine master ASP.NET in Visual Web DeveloperCompilazione di applicazioni con Visual Web Developer
Procedura: rispondere a eventi del controllo server Web Button in script clientCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: rispondere ai clic dell'utente nei controlli server Web BulletedList (Visual Studio)Compilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: impostare lo stato attivo sui controlli server Web ASP.NETCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: rispondere a eventi del controllo server Web ButtonCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: rispondere a eventi Button in controlli con associazione a datiCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: rispondere a eventi del controllo server Web Button in script clientGenerazione di applicazioni Web ASP.NET
Procedura: rispondere a eventi Button in controlli con associazione a datiGenerazione di applicazioni Web ASP.NET
Procedura: rispondere a eventi del controllo server Web ButtonGenerazione di applicazioni Web ASP.NET
Procedura: impostare lo stato attivo sui controlli server Web ASP.NETGenerazione di applicazioni Web ASP.NET
Procedura: rispondere a eventi del controllo server Web Button in script clientCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: rispondere ai clic dell'utente nei controlli server Web BulletedList (Visual Studio)Compilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: impostare lo stato attivo sui controlli server Web ASP.NETCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: aggiungere controlli server Web pulsante a una pagina Web Form (Visual Studio)Compilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: rispondere a eventi del controllo server Web ButtonCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: rispondere a eventi Button in controlli con associazione a datiCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: aggiungere controlli server Web pulsante a una pagina Web Form (Visual Studio)Compilazione di applicazioni Web ASP.NET in Visual Studio

A complemento di questo argomento è disponibile un progetto di sito Web di Visual Studio con codice sorgente che è possibile scaricare.

Nell'esempio riportato di seguito viene illustrato come creare un controllo LinkButton per la visualizzazione del testo in un controllo Label quando si fa clic sul collegamento.


<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
    <title>LinkButton Example</title>
<script language="C#" runat="server">

      void LinkButton_Click(Object sender, EventArgs e) 
      {
         Label1.Text="You clicked the link button";
      }

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>



.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.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.
Mostra: