HyperLinkColumn Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Tipo di colonna per il controllo DataGrid che contiene un collegamento ipertestuale per ogni elemento della colonna.

public ref class HyperLinkColumn : System::Web::UI::WebControls::DataGridColumn

public class HyperLinkColumn : System.Web.UI.WebControls.DataGridColumn

type HyperLinkColumn = class
    inherit DataGridColumn

Public Class HyperLinkColumn
Inherits DataGridColumn

Ereditarietà: Object

DataGridColumn
HyperLinkColumn

Esempio

Nell'esempio seguente viene illustrato come creare un oggetto HyperLinkColumn che collega a una pagina separata.

Nota

L'esempio di codice seguente usa il modello di codice a file singolo e potrebbe non funzionare correttamente se copiato direttamente in un file code-behind. Questo esempio di codice deve essere copiato in un file di testo vuoto con un'estensione .aspx. Per altre informazioni sul modello di codice Web Forms, vedere ASP.NET modello di codice della pagina Web Forms.

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

<%@ Page Language="VB" 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">

      Function CreateDataSource() As ICollection 
      
         Dim dt As DataTable = New DataTable()
         Dim dr As DataRow
         Dim i As Integer

         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("PriceValue", GetType(Double)))
       
         For i = 0 to 2 
         
            dr = dt.NewRow()

            dr(0) = i
            dr(1) = CDbl(i) * 1.23

            dt.Rows.Add(dr)

         Next i

         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function

      Sub Page_Load(sender As Object, e As EventArgs) 
    
         MyDataGrid.DataSource = CreateDataSource()
         MyDataGrid.DataBind()

      End Sub

   </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 seguente viene visualizzato 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>

<%@ 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>Details page for DataGrid</title>
<script runat="server">
 
      Sub Page_Load(sender As Object, e As EventArgs) 
      
         Label1.Text = "You selected item: " & Request.QueryString("id")
      
      End Sub
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</body>
</html>

Commenti

Usare il HyperLinkColumn tipo di colonna in un DataGrid controllo per creare un collegamento ipertestuale per ogni riga in DataGrid. Impostare la proprietà per specificare il Text testo della didascalia per il collegamento ipertestuale. Per specificare l'URL da collegare a quando viene fatto clic sul collegamento ipertestuale, impostare la NavigateUrl proprietà.

Nota

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

È anche possibile associare la didascalia del testo e l'URL dei collegamenti ipertestuali in un campo in un'origine HyperLinkColumn dati anziché impostare le Text proprietà e NavigateUrl . In questo modo è possibile visualizzare una didascalia diversa e specificare un URL diverso per ogni collegamento ipertestuale nella colonna.

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

Nota

Le DataTextField proprietà e Text non possono essere impostate contemporaneamente. Se entrambe le proprietà sono impostate, la proprietà ha la DataTextField precedenza.

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

Nota

Le DataNavigateUrlField proprietà e NavigateUrl non possono essere impostate contemporaneamente. Se entrambe le proprietà sono impostate, la proprietà ha la DataNavigateUrlField precedenza.

La Target proprietà consente di specificare la finestra o il frame per visualizzare il contenuto della pagina Web collegato a quando viene fatto clic sul collegamento ipertestuale.

Quando si usa il data binding, è possibile formattare rispettivamente la didascalia del testo e l'URL del collegamento ipertestuale impostando rispettivamente le DataTextFormatString proprietà e DataNavigateUrlFormatString .

Attenzione

Questo controllo può essere usato per visualizzare l'input utente, che potrebbe includere script client dannosi. Controllare tutte le informazioni inviate da un client per script eseguibili, istruzioni SQL o altro codice prima di visualizzarlo nell'applicazione. È possibile usare i controlli di convalida per verificare l'input utente prima di visualizzare il testo di input in un controllo. ASP.NET fornisce una funzionalità di convalida della richiesta di input per bloccare script e HTML nell'input utente. Per altre informazioni, vedere Protezione dei controlli standard, Procedura: Protezione dagli exploit di script in un'applicazione Web applicando la codifica HTML alle stringhe e convalidando l'input utente nelle pagine Web ASP.NET.

Costruttori

HyperLinkColumn()

Inizializza una nuova istanza della classe HyperLinkColumn.

Proprietà

DataNavigateUrlField	Ottiene o imposta il campo di un'origine dati da associare all'URL dei collegamenti ipertestuali nell'oggetto HyperLinkColumn.
DataNavigateUrlFormatString	Ottiene o imposta il formato di visualizzazione per l'URL dei collegamenti ipertestuali nell'oggetto HyperLinkColumn quando l'URL è collegato ai dati di un campo di un'origine dati.
DataTextField	Ottiene o imposta il campo di un'origine dati da associare alla didascalia dei collegamenti ipertestuali nell'oggetto HyperLinkColumn.
DataTextFormatString	Ottiene o imposta il formato di visualizzazione per la didascalia dei collegamenti ipertestuali nella colonna HyperLinkColumn.
DesignMode	Ottiene un valore che indica se la colonna è in modalità progettazione. (Ereditato da DataGridColumn)
FooterStyle	Ottiene le proprietà di stile per la sezione del piè di pagina della colonna. (Ereditato da DataGridColumn)
FooterText	Ottiene o imposta il testo visualizzato nella sezione del piè di pagina della colonna. (Ereditato da DataGridColumn)
HeaderImageUrl	Ottiene o imposta la posizione di un'immagine da visualizzare nella sezione di intestazione della colonna. (Ereditato da DataGridColumn)
HeaderStyle	Ottiene le proprietà di stile per la sezione di intestazione della colonna. (Ereditato da DataGridColumn)
HeaderText	Ottiene o imposta il testo visualizzato nella sezione di intestazione della colonna. (Ereditato da DataGridColumn)
IsTrackingViewState	Ottiene un valore che determina se l'oggetto DataGridColumn è contrassegnato per il salvataggio dello stato. (Ereditato da DataGridColumn)
ItemStyle	Ottiene le proprietà di stile per le celle degli elementi della colonna. (Ereditato da DataGridColumn)
NavigateUrl	Ottiene o imposta l’URL a cui collegarsi quando viene fatto clic su un collegamento ipertestuale nella colonna.
Owner	Ottiene il controllo DataGrid di cui la colonna è membro. (Ereditato da DataGridColumn)
SortExpression	Ottiene o imposta il nome del campo o l'espressione da passare al metodo OnSortCommand(DataGridSortCommandEventArgs) quando una colonna viene selezionata per l'ordinamento. (Ereditato da DataGridColumn)
Target	Ottiene o imposta la finestra o il frame di destinazione in cui visualizzare il contenuto della pagina Web collegato quando viene fatto clic sul collegamento ipertestuale nella colonna.
Text	Ottiene o imposta la didascalia da visualizzare per i collegamenti ipertestuali nella colonna.
ViewState	Ottiene l'oggetto StateBag che consente a una colonna derivata dalla classe DataGridColumn di memorizzare le relative proprietà. (Ereditato da DataGridColumn)
Visible	Ottiene o imposta un valore che indica se la colonna è visibile nel controllo DataGrid. (Ereditato da DataGridColumn)

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FormatDataNavigateUrlValue(Object)	Formatta un URL collegato ai dati utilizzando il formato specificato tramite la proprietà DataNavigateUrlFormatString.
FormatDataTextValue(Object)	Formatta una didascalia collegata ai dati utilizzando il formato specificato tramite la proprietà DataTextFormatString.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Initialize()	Fornisce l'implementazione di base per ripristinare lo stato iniziale di una colonna derivata dalla classe DataGridColumn.
InitializeCell(TableCell, Int32, ListItemType)	Inizializza la cella che rappresenta questa colonna con il collegamento ipertestuale presente.
LoadViewState(Object)	Carica lo stato dell'oggetto DataGridColumn. (Ereditato da DataGridColumn)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnColumnChanged()	Chiama il metodo OnColumnsChanged(). (Ereditato da DataGridColumn)
SaveViewState()	Salva lo stato corrente dell'oggetto DataGridColumn. (Ereditato da DataGridColumn)
ToString()	Restituisce la rappresentazione in forma di stringa della colonna. (Ereditato da DataGridColumn)
TrackViewState()	Attiva il rilevamento delle modifiche dello stato di visualizzazione nel controllo server per consentirne la memorizzazione nell'oggetto StateBag del controllo server. (Ereditato da DataGridColumn)

Implementazioni dell'interfaccia esplicita

IStateManager.IsTrackingViewState	Ottiene un valore che indica se nella colonna vengono registrate le modifiche dello stato di visualizzazione. (Ereditato da DataGridColumn)
IStateManager.LoadViewState(Object)	Carica lo stato salvato in precedenza. (Ereditato da DataGridColumn)
IStateManager.SaveViewState()	Restituisce un oggetto contenente le modifiche dello stato. (Ereditato da DataGridColumn)
IStateManager.TrackViewState()	Avvia la registrazione delle modifiche dello stato. (Ereditato da DataGridColumn)

Si applica a

Condividi tramite

HyperLinkColumn Classe

Definizione

Esempio

Commenti

Costruttori

Proprietà

Metodi

Implementazioni dell'interfaccia esplicita

Si applica a

Vedi anche

Risorse aggiuntive