HyperLinkColumn Classe

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 DataGrid controllo 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.

Annotazioni

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 estensione .aspx. Per altre informazioni sul modello di codice Web Form, vedere ASP.NET modello di codice della pagina Web Form.

<%@ 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 Text proprietà per specificare il testo della didascalia per il collegamento ipertestuale. Per specificare l'URL a cui collegarsi quando si fa clic sul collegamento ipertestuale, impostare la NavigateUrl proprietà .

Annotazioni

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

È anche possibile associare la didascalia del testo e l'URL dei collegamenti ipertestuali in HyperLinkColumn a un campo in un'origine 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 da associare alla didascalia di testo dei collegamenti ipertestuali nella colonna.

Annotazioni

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

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

Annotazioni

Le DataNavigateUrlField proprietà e NavigateUrl non possono essere impostate contemporaneamente. Se vengono impostate entrambe le proprietà, 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 si fa clic sul collegamento ipertestuale.

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

Attenzione

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

Costruttori

Nome	Descrizione
HyperLinkColumn()	Inizializza una nuova istanza della classe HyperLinkColumn.

Proprietà

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

Metodi

Nome	Descrizione
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FormatDataNavigateUrlValue(Object)	Formatta un URL associato a dati usando il formato specificato dalla DataNavigateUrlFormatString proprietà .
FormatDataTextValue(Object)	Formatta una didascalia di testo associata a dati usando il formato specificato dalla DataTextFormatString proprietà .
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Initialize()	Fornisce l'implementazione di base per reimpostare una colonna derivata dalla DataGridColumn classe allo stato iniziale.
InitializeCell(TableCell, Int32, ListItemType)	Inizializza la cella che rappresenta questa colonna con il collegamento ipertestuale contenuto.
LoadViewState(Object)	Carica lo stato dell'oggetto DataGridColumn . (Ereditato da DataGridColumn)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnColumnChanged()	Chiama il OnColumnsChanged() metodo . (Ereditato da DataGridColumn)
SaveViewState()	Salva lo stato corrente dell'oggetto DataGridColumn . (Ereditato da DataGridColumn)
ToString()	Restituisce la rappresentazione di stringa della colonna. (Ereditato da DataGridColumn)
TrackViewState()	Determina il rilevamento delle modifiche dello stato di visualizzazione al controllo server in modo che possano essere archiviate nell'oggetto del StateBag controllo server. (Ereditato da DataGridColumn)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IStateManager.IsTrackingViewState	Ottiene un valore che indica se la colonna sta tenendo traccia delle 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 modifiche dello stato. (Ereditato da DataGridColumn)
IStateManager.TrackViewState()	Avvia il rilevamento delle modifiche dello stato. (Ereditato da DataGridColumn)

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?

Condividi tramite

HyperLinkColumn Classe

Definizione

Esempio

Commenti

Costruttori

Proprietà

Metodi

Implementazioni dell'interfaccia esplicita

Si applica a

Vedi anche

Commenti e suggerimenti