HyperLinkField Classe
Definizione
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.
Rappresenta un campo visualizzato come collegamento ipertestuale in un controllo associato a dati.
public ref class HyperLinkField : System::Web::UI::WebControls::DataControlFieldpublic class HyperLinkField : System.Web.UI.WebControls.DataControlFieldtype HyperLinkField = class
inherit DataControlFieldPublic Class HyperLinkField
Inherits DataControlField- Ereditarietà
Esempio
Nell'esempio di codice seguente viene illustrato come utilizzare un HyperLinkField oggetto per visualizzare una colonna di collegamenti ipertestuali statici in un GridView controllo . Ogni collegamento ipertestuale nell'oggetto HyperLinkField condivide la stessa didascalia e l'URL di navigazione specificati rispettivamente dalle Text proprietà e NavigateUrl .
<%@ Page language="C#" %>
<!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 runat="server">
<title>HyperLinkField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- Set the HyperLinkField field column to a static -->
<!-- caption and URL. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="OrderID"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID"/>
<asp:boundfield datafield="OrderDate"
headertext="Order Date"
dataformatstring="{0:d}" />
<asp:hyperlinkfield text="Details..."
navigateurl="~\details.aspx"
headertext="Order Details"
target="_blank" />
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!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 runat="server">
<title>HyperLinkField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- Set the HyperLinkField field column to a static -->
<!-- caption and URL. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="OrderID"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID"/>
<asp:boundfield datafield="OrderDate"
headertext="Order Date"
dataformatstring="{0:d}" />
<asp:hyperlinkfield text="Details..."
navigateurl="~\details.aspx"
headertext="Order Details"
target="_blank" />
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Nell'esempio di codice seguente viene illustrato come associare un HyperLinkField oggetto ai campi di un'origine dati. Le DataTextField proprietà e DataNavigateUrlFields vengono utilizzate per specificare i campi da associare alla didascalia e all'URL di navigazione, rispettivamente, di ogni collegamento ipertestuale visualizzato nell'oggetto HyperLinkField .
<%@ Page language="C#" %>
<!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 runat="server">
<title>HyperLinkField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- The UnitPrice field values are bound to the -->
<!-- captions of the hyperlinks in the HyperLinkField -->
<!-- field column, formatted as currency. The ProductID -->
<!-- field values are bound to the navigate URLs of the -->
<!-- hyperlinks. However, instead of being the actual -->
<!-- URL values, the product ID is passed to the linked -->
<!-- page as a parameter in the URL specified by the -->
<!-- DataNavigateUrlFormatString property. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="Order ID"/>
<asp:boundfield datafield="ProductID"
headertext="Product ID"/>
<asp:hyperlinkfield datatextfield="UnitPrice"
datatextformatstring="{0:c}"
datanavigateurlfields="ProductID"
datanavigateurlformatstring="~\details.aspx?ProductID={0}"
headertext="Price"
target="_blank" />
<asp:boundfield datafield="Quantity"
headertext="Quantity"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!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 runat="server">
<title>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- The UnitPrice field values are bound to the -->
<!-- captions of the hyperlinks in the HyperLinkField -->
<!-- field column, formatted as currency. The ProductID -->
<!-- field values are bound to the navigate URLs of the -->
<!-- hyperlinks. However, instead of being the actual -->
<!-- URL values, the product ID is passed to the linked -->
<!-- page as a parameter in the URL specified by the -->
<!-- DataNavigateUrlFormatString property. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="Order ID"/>
<asp:boundfield datafield="ProductID"
headertext="Product ID"/>
<asp:hyperlinkfield datatextfield="UnitPrice"
datatextformatstring="{0:c}"
datanavigateurlfields="ProductID"
datanavigateurlformatstring="~\details.aspx?ProductID={0}"
headertext="Price"
target="_blank" />
<asp:boundfield datafield="Quantity"
headertext="Quantity"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Commenti
La HyperLinkField classe viene utilizzata dai controlli associati a dati (ad esempio GridView e DetailsView) per visualizzare un collegamento ipertestuale per ogni record visualizzato. Quando l'utente fa clic su un collegamento ipertestuale, viene indirizzato alla pagina Web associata al collegamento ipertestuale. L'oggetto HyperLinkField viene visualizzato in modo diverso a seconda del controllo associato a dati in cui viene utilizzato. Ad esempio, il GridView controllo visualizza un HyperLinkField oggetto come colonna, mentre il DetailsView controllo lo visualizza come riga.
Per specificare la didascalia da visualizzare per i collegamenti ipertestuali, utilizzare la Text proprietà . Utilizzare la NavigateUrl proprietà per specificare l'URL a cui passare quando si fa clic su un collegamento ipertestuale. Se si desidera visualizzare il contenuto collegato in una finestra o in un frame specifico, impostare la Target proprietà .
Nota
Quando vengono impostate le Text proprietà e NavigateUrl , tutti i collegamenti ipertestuali nell'oggetto HyperLinkField condividono la stessa didascalia e lo stesso URL di navigazione. Analogamente, la Target proprietà si applica anche a tutti i collegamenti ipertestuali.
In alternativa, è possibile associare l'oggetto ai campi di un'origine HyperLinkField dati. In questo modo è possibile visualizzare una didascalia diversa per ogni collegamento ipertestuale nell'oggetto HyperLinkField e fare in modo che ogni collegamento ipertestuale passi a una posizione diversa. Per associare un campo a una didascalia, impostare la DataTextField proprietà . Per creare un URL per la navigazione, impostare la DataNavigateUrlFields proprietà su un elenco delimitato da virgole di campi da usare per creare l'URL.
È possibile specificare un formato personalizzato per le didascalie e gli URL di navigazione impostando rispettivamente le DataTextFormatString proprietà e DataNavigateUrlFormatString .
È possibile nascondere un HyperLinkField oggetto in un controllo associato a dati impostando la Visible proprietà su false.
È possibile personalizzare le sezioni di intestazione e piè di pagina di un HyperLinkField oggetto . Per visualizzare una didascalia nelle sezioni di intestazione o piè di pagina, impostare rispettivamente le HeaderText proprietà o FooterText . Per visualizzare un'immagine nella sezione di intestazione anziché testo, impostare la HeaderImageUrl proprietà . La sezione dell'intestazione può essere nascosta nell'oggetto HyperLinkField impostando la ShowHeader proprietà su false.
Nota
Alcuni controlli associati a dati , ad esempio il GridView controllo , possono visualizzare o nascondere solo l'intera sezione di intestazione del controllo. Questi controlli associati a dati non supportano la ShowHeader proprietà per un singolo campo associato. Per visualizzare o nascondere l'intera sezione dell'intestazione di un controllo associato a dati, utilizzare la proprietà del ShowHeader controllo , se disponibile.
È anche possibile personalizzare l'aspetto dell'oggetto HyperLinkField (colore del carattere, colore di sfondo e così via) impostando le proprietà di stile per le diverse parti del campo. Nella tabella seguente sono elencate le diverse proprietà di stile.
| Proprietà Style | Descrizione |
|---|---|
| ControlStyle | Impostazioni di stile per i controlli server Web figlio dell'oggetto HyperLinkField . |
| FooterStyle | Impostazioni di stile per la sezione piè di pagina dell'oggetto HyperLinkField . |
| HeaderStyle | Impostazioni di stile per la sezione di intestazione dell'oggetto HyperLinkField . |
| ItemStyle | Impostazioni di stile per gli elementi di dati nell'oggetto HyperLinkField . |
Costruttori
| HyperLinkField() |
Inizializza una nuova istanza della classe HyperLinkField. |
Proprietà
| AccessibleHeaderText |
Ottiene o imposta il testo che viene sottoposto a rendering come valore della proprietà |
| Control |
Ottiene un riferimento al controllo dati a cui l'oggetto DataControlField è associato. (Ereditato da DataControlField) |
| ControlStyle |
Ottiene lo stile di tutti i controlli server Web contenuti nell'oggetto DataControlField. (Ereditato da DataControlField) |
| DataNavigateUrlFields |
Ottiene o imposta i nomi dei campi dall'origine dati utilizzata per costruire gli URL dei collegamenti ipertestuali dell'oggetto HyperLinkField. |
| DataNavigateUrlFormatString |
Ottiene o imposta la stringa che specifica il formato per il rendering degli URL dei collegamenti ipertestuali di un oggetto HyperLinkField. |
| DataTextField |
Ottiene o imposta il nome del campo dell'origine dati contenente il testo da visualizzare per le didascalie dei collegamenti ipertestuali nell'oggetto HyperLinkField. |
| DataTextFormatString |
Ottiene o imposta la stringa che specifica il formato con cui vengono visualizzate le didascalie dei collegamenti ipertestuali in un oggetto HyperLinkField. |
| DesignMode |
Ottiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente di progettazione. (Ereditato da DataControlField) |
| FooterStyle |
Ottiene o imposta lo stile del piè di pagina del campo di controllo dati. (Ereditato da DataControlField) |
| FooterText |
Ottiene o imposta il testo visualizzato nell'elemento del piè di pagina del campo di controllo dati. (Ereditato da DataControlField) |
| HeaderImageUrl |
Ottiene o imposta l'URL di un'immagine che viene visualizzata nell'elemento di intestazione di un campo di controlli dati. (Ereditato da DataControlField) |
| HeaderStyle |
Ottiene o imposta lo stile dell'intestazione del campo di controllo dati. (Ereditato da DataControlField) |
| HeaderText |
Ottiene o imposta il testo visualizzato nell'elemento dell'intestazione di un campo di controllo dati. (Ereditato da DataControlField) |
| InsertVisible |
Ottiene un valore che indica se l'oggetto DataControlField è visibile quando il controllo con associazione a dati padre si trova in modalità di inserimento. (Ereditato da DataControlField) |
| IsTrackingViewState |
Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione. (Ereditato da DataControlField) |
| ItemStyle |
Ottiene lo stile di tutti i contenuti basati sul testo visualizzati da un campo di controllo dati. (Ereditato da DataControlField) |
| NavigateUrl |
Ottiene o imposta l'URL a cui passare quando viene fatto clic su un collegamento ipertestuale in un oggetto HyperLinkField. |
| ShowHeader |
Ottiene o imposta un valore che indica se viene eseguito il rendering dell'elemento di intestazione di un campo di controllo dati. (Ereditato da DataControlField) |
| SortExpression |
Ottiene o imposta l'espressione di ordinamento che viene utilizzata da un controllo origine dati per ordinare i dati. (Ereditato da DataControlField) |
| Target |
Ottiene o imposta la finestra o il frame di destinazione in cui visualizzare la pagina Web collegata quando viene fatto clic su un collegamento ipertestuale in un oggetto HyperLinkField. |
| Text |
Ottiene o imposta il testo da visualizzare per ciascun collegamento ipertestuale nell'oggetto HyperLinkField. |
| ValidateRequestMode |
Ottiene o imposta un valore che specifica se il controllo convalida l'input del client. (Ereditato da DataControlField) |
| ViewState |
Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un oggetto DataControlField tra più richieste per la stessa pagina. (Ereditato da DataControlField) |
| Visible |
Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo di controllo dati. (Ereditato da DataControlField) |
Metodi
| CloneField() |
Crea una copia duplicata dell'oggetto corrente derivato da DataControlField. (Ereditato da DataControlField) |
| CopyProperties(DataControlField) |
Copia le proprietà dell'oggetto corrente HyperLinkField nell'oggetto specificato. |
| CreateField() |
Restituisce una nuova istanza della classe HyperLinkField. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Estrae il valore del campo di controllo dati dalla cella corrente della tabella e aggiunge il valore all'insieme IDictionary specificato. (Ereditato da DataControlField) |
| FormatDataNavigateUrlValue(Object[]) |
Formatta l'URL di navigazione utilizzando la stringa di formato specificata tramite la proprietà DataNavigateUrlFormatString. |
| FormatDataTextValue(Object) |
Formatta il testo della didascalia utilizzando la stringa di formato specificata 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(Boolean, Control) |
Inizializza l'oggetto HyperLinkField. |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Inizializza una cella in un oggetto HyperLinkField. |
| LoadViewState(Object) |
Ripristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati. (Ereditato da DataControlField) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| OnFieldChanged() |
Genera l'evento |
| SaveViewState() |
Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server. (Ereditato da DataControlField) |
| ToString() |
Restituisce una stringa che rappresenta questo oggetto DataControlField. (Ereditato da DataControlField) |
| TrackViewState() |
Mediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina. (Ereditato da DataControlField) |
| ValidateSupportsCallback() |
Indica che i controlli contenuti nell'oggetto HyperLinkField supportano i callback. |
Implementazioni dell'interfaccia esplicita
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Ottiene o imposta lo schema associato all'oggetto DataControlField. (Ereditato da DataControlField) |
| IStateManager.IsTrackingViewState |
Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione. (Ereditato da DataControlField) |
| IStateManager.LoadViewState(Object) |
Ripristina lo stato di visualizzazione del campo del controllo dati salvato in precedenza. (Ereditato da DataControlField) |
| IStateManager.SaveViewState() |
Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server. (Ereditato da DataControlField) |
| IStateManager.TrackViewState() |
Mediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina. (Ereditato da DataControlField) |