Sintassi dichiarativa per il controllo server Web LinkButton
Aggiornamento: novembre 2007
Crea un pulsante simile a un collegamento ipertestuale in una pagina Web Form.
<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"
/>
Note
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 un aspetto simile a quello di un controllo HyperLink ma la stessa funzionalità di un controllo Button. Utilizzare il controllo HyperLink per collegarsi a un'altra pagina Web quando si fa clic sul controllo.
I pulsanti submit non hanno un nome di comando associato e si limitano 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. 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. È 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 sullo script client, vedere Script client nelle pagine Web ASP.NET. 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 reset, impostare la proprietà CausesValidation su false.
.gif "Nota di avviso") 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. |
I pulsanti Command (ad esempio i controlli LinkButton) vengono spesso utilizzati nei controlli con modelli per comunicare un'azione al controllo padre. Ad esempio la selezione in un controllo DataList o la modalità di modifica in un controllo FormView.
Per informazioni dettagliate sulle proprietà e sugli eventi del controllo server Web LinkButton, vedere la documentazione relativa alla classe LinkButton.
Esempio
Nell'esempio riportato di seguito viene mostrato come utilizzare un controllo LinkButton per visualizzare un messaggio quando si fa clic su di esso.
<%@ Page Language="VB" 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="VB" runat="server">
Sub LinkButton_Click(sender As Object, e As EventArgs)
Label1.Text = "You clicked the link button"
End Sub
</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>
<%@ 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>
<%@ Page Language="JScript" 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="JSCRIPT" runat="server">
function LinkButton_Click(sender : Object, e : EventArgs){
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>