Controllo server Web LinkButton
Crea un pulsante simile a un collegamento ipertestuale in una pagina Web Form.
<asp:LinkButtonid="LinkButton1" Text="label" Command="Command" CommandArgument="CommandArgument" CausesValidation="true | false" OnClick="OnClickMethod" runat="server"/>
or
<asp:LinkButtonid="LinkButton1" Command="Command" CommandArgument="CommandArgument" CausesValidation="true | false" OnClick="OnClickMethod" runat="server"/> Text</asp:LinkButton>
Osservazioni
Utilizzare il controllo LinkButton per creare un pulsante simile a un collegamento ipertestuale in una pagina Web Form. Per specificare il testo da visualizzare nel controllo LinkButton, impostare la proprietà Text oppure inserire il testo tra i tag di apertura e di chiusura del controllo LinkButton. È possibile creare un pulsante di invio oppure un pulsante di comando.
Nota Il controllo LinkButton ha lo stesso aspetto di un controllo HyperLink, ma la funzionalità è identica a quella del controllo Button. Utilizzare il controllo HyperLink, se si desidera collegarsi a un'altra pagina Web quando si fa clic sul controllo.
Un pulsante submit non ha un nome di comando associato e si limita a restituire la pagina Web al server. Per impostazione predefinita, un controllo LinkButton è un pulsante submit. È possibile mettere a disposizione dell'evento Click un gestore eventi, per controllare a livello di codice le azioni eseguite quando si fa clic sul pulsante submit.
Se si imposta la proprietà CommandName, è possibile associare un nome di comando al pulsante di comando, ad esempio Sort. In tal modo è possibile creare più controlli LinkButton in una pagina Web e determinare a livello di codice su quale controllo LinkButton viene fatto clic. È inoltre possibile utilizzare la proprietà CommandArgument con un pulsante di comando per fornire ulteriori informazioni sul comando da eseguire, ad esempio Ascending. È possibile mettere a disposizione dell'evento Command un gestore eventi, per controllare a livello di codice le azioni eseguite quando si fa clic sul pulsante di comando.
Nota 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 sugli script client, vedere Script client nelle pagine Web Form.
Per impostazione predefinita, la convalida della pagina viene eseguita quando si fa clic su un controllo LinkButton. La convalida della pagina consente di determinare se i controlli di input associati a un controllo di convalida nella pagina passano le regole di convalida specificate dal controllo di convalida stesso. Se è presente un controllo LinkButton che disattiva questa funzionalità, ad esempio un pulsante di reimpostazione, impostare la proprietà CausesValidation su false.
Attenzione Il testo non viene codificato in formato HTML prima di essere visualizzato nel controllo LinkButton. È pertanto possibile incorporare script all'interno dei tag HTML presenti nel testo. Se i valori del controllo provengono dall'input dell'utente, assicurarsi di convalidare tali valori per evitare problemi di protezione.
Per informazioni dettagliate sulle proprietà e sugli eventi del controllo server Web LinkButton vedere la documentazione di Classe LinkButton.
Esempio
Nell'esempio seguente viene mostrato come utilizzare un controllo LinkButton per visualizzare un messaggio quando si fa clic su di esso.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Sub LinkButton_Click(sender As Object, e As EventArgs)
Label1.Text = "You clicked the link button"
End Sub
</script>
</head>
<body>
<form runat="server">
<h3>LinkButton Example</h3>
<asp:LinkButton id="LinkButton1"
Text="Click Me"
Font-Name="Verdana"
Font-Size="14pt"
OnClick="LinkButton_Click"
runat="server"/>
<p>
<asp:Label id=Label1 runat=server />
</form>
</body>
</html>
[C#]
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void LinkButton1_Click(Object sender, EventArgs e)
{
Label1.Text="You clicked the link button";
}
</script>
</head>
<body>
<form runat="server">
<h3>LinkButton Example</h3>
<asp:LinkButton id="LinkButton1"
Text="Click Me!"
Font-Name="Verdana"
Font-Size="14pt"
OnClick="LinkButton1_Click"
runat="server"/>
<asp:Label id=Label1
runat=server />
</form>
</body>
</html>