Questa documentazione è stata archiviata e non viene gestita.

Classe HyperLinkColumn

Aggiornamento: novembre 2007

Tipo di colonna per il controllo DataGrid contenente un collegamento ipertestuale per ciascun elemento della colonna.

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

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class HyperLinkColumn : DataGridColumn
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class HyperLinkColumn extends DataGridColumn
public class HyperLinkColumn extends DataGridColumn

Utilizzare il tipo di colonna HyperLinkColumn in un controllo DataGrid per creare un collegamento ipertestuale per ciascuna riga dell'oggetto DataGrid. Impostare la proprietà Text per specificare il testo della didascalia del collegamento ipertestuale. Per specificare l'URL a cui collegarsi quando si fa clic sul collegamento ipertestuale, impostare la proprietà NavigateUrl.

Nota:

Se si impostano le proprietà Text e NavigateUrl, tutti i collegamenti ipertestuali nella colonna condivideranno la stessa didascalia e URL.

È inoltre possibile associare la didascalia e l'URL dei collegamenti ipertestuali dell'oggetto HyperLinkColumn a un campo di un'origine dati anziché impostare le proprietà Text e NavigateUrl. In questo modo, è possibile visualizzare una didascalia diversa e specificare un URL diverso per ciascun collegamento ipertestuale della colonna.

Utilizzare la proprietà DataTextField per specificare un campo in un'origine dati a cui associare la didascalia dei collegamenti ipertestuali nella colonna.

Nota:

Non è possibile impostare contemporaneamente le proprietà DataTextField e Text. Se sono impostate entrambe le proprietà, la proprietà DataTextField ha la precedenza.

Specificare il campo da associare all'URL del collegamento ipertestuale impostando la proprietà DataNavigateUrlField.

Nota:

Non è possibile impostare contemporaneamente le proprietà DataNavigateUrlField e NavigateUrl. Se sono impostate entrambe le proprietà, la proprietà DataNavigateUrlField ha la precedenza.

La proprietà Target consente di specificare la finestra o il frame in cui visualizzare il contenuto della pagina Web collegata quando si fa clic sul collegamento ipertestuale.

Se si utilizza l'associazione dati, è possibile formattare la didascalia e l'URL del collegamento ipertestuale impostando, rispettivamente, le proprietà DataTextFormatString e DataNavigateUrlFormatString.

Attenzione:

Il controllo può essere utilizzato per visualizzare l'input dell'utente, che può includere uno script client dannoso. Verificare tutte le informazioni che vengono inviate da un client per uno script eseguibile, istruzioni SQL o altro codice, prima di visualizzarle nell'applicazione. È possibile utilizzare controlli di convalida per verificare l'input dell'utente prima di visualizzare il testo immesso in un controllo. ASP.NET dispone di una funzionalità di convalida della richiesta di input per bloccare script e codice HTML nell'input dell'utente. Per ulteriori informazioni, vedere Protezione dei controlli standard, Procedura: proteggere da attacchi tramite script in un'applicazione Web applicando alle stringhe la codifica HTML e Convalida dell'input utente nelle pagine Web ASP.NET.

Nell'esempio riportato di seguito viene illustrato come creare un oggetto HyperLinkColumn per eseguire il collegamento a una pagina separata.

Nota:

Nell'esempio di codice riportato di seguito viene utilizzato il modello di codice a file singolo e se viene copiato direttamente in un file di codice sottostante, il codice potrebbe non funzionare. È necessario copiare l'esempio di codice in un file di testo vuoto con estensione ASPX. Per ulteriori informazioni sul modello di codice di Web Form, vedere Modello di codice di pagine Web ASP.NET.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!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>HyperLinkColumn Example</title>
<script runat="server">

      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("PriceValue", typeof(Double)));

         for (int i = 0; i < 3; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = (Double)i * 1.23;

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }

      void Page_Load(Object sender, EventArgs e) 
      {
         MyDataGrid.DataSource = CreateDataSource();
         MyDataGrid.DataBind();
      }

   </script>

</head>

<body>

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

      <h3>HyperLinkColumn Example</h3>

      <asp:DataGrid id="MyDataGrid" 
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#aaaadd"/>

         <Columns>

            <asp:HyperLinkColumn
                 HeaderText="Select an Item"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 Target="_blank"/>

         </Columns>

      </asp:DataGrid>

   </form>

</body>
</html>



Nell'esempio corrispondente riportato di seguito viene mostrato l'elemento selezionato nell'esempio precedente.

<%@ 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>Details page for DataGrid</title>
<script runat="server">

      void Page_Load(Object sender, EventArgs e) 
      {
         Label1.Text = "You selected item: " + Request.QueryString["id"];
      }

   </script>

</head>
<body>

   <h3>Details page for DataGrid</h3>

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

</body>
</html>



System.Object
  System.Web.UI.WebControls.DataGridColumn
    System.Web.UI.WebControls.HyperLinkColumn

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

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

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