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 lo stesso URL di navigazione specificato 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 spostamento, 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 usata 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à .
Annotazioni
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 intestazione e piè di pagina di un HyperLinkField oggetto . Per visualizzare una didascalia nelle sezioni intestazione o piè di pagina, impostare rispettivamente le HeaderText proprietà o FooterText . Per visualizzare un'immagine nella sezione intestazione anziché testo, impostare la HeaderImageUrl proprietà . La sezione intestazione può essere nascosta nell'oggetto HyperLinkField impostando la ShowHeader proprietà su false.
Annotazioni
Alcuni controlli associati a dati,ad esempio il GridView controllo, possono mostrare 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 intestazione dell'oggetto HyperLinkField . |
| ItemStyle | Impostazioni di stile per gli elementi di dati nell'oggetto HyperLinkField . |
Costruttori
| Nome | Descrizione |
|---|---|
| HyperLinkField() |
Inizializza una nuova istanza della classe HyperLinkField. |
Proprietà
| Nome | Descrizione |
|---|---|
| AccessibleHeaderText |
Ottiene o imposta il testo di cui viene eseguito il rendering come valore della |
| Control |
Ottiene un riferimento al controllo dati a cui è associato l'oggetto DataControlField . (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 dell'origine dati utilizzata per costruire gli URL per i collegamenti ipertestuali nell'oggetto HyperLinkField . |
| DataNavigateUrlFormatString |
Ottiene o imposta la stringa che specifica il formato in cui viene eseguito il rendering degli URL per i collegamenti ipertestuali in un HyperLinkField oggetto . |
| DataTextField |
Ottiene o imposta il nome del campo dall'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 in cui vengono visualizzate le didascalie dei collegamenti ipertestuali in un HyperLinkField oggetto . |
| DesignMode |
Ottiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente in fase di progettazione. (Ereditato da DataControlField) |
| FooterStyle |
Ottiene o imposta lo stile del piè di pagina del campo del controllo dati. (Ereditato da DataControlField) |
| FooterText |
Ottiene o imposta il testo visualizzato nell'elemento piè di pagina di un campo del controllo dati. (Ereditato da DataControlField) |
| HeaderImageUrl |
Ottiene o imposta l'URL di un'immagine visualizzata nell'elemento di intestazione di un campo di controllo dati. (Ereditato da DataControlField) |
| HeaderStyle |
Ottiene o imposta lo stile dell'intestazione del campo del controllo dati. (Ereditato da DataControlField) |
| HeaderText |
Ottiene o imposta il testo visualizzato nell'elemento di intestazione di un campo del controllo dati. (Ereditato da DataControlField) |
| InsertVisible |
Ottiene un valore che indica se l'oggetto è visibile quando il DataControlField controllo associato a dati padre è in modalità di inserimento. (Ereditato da DataControlField) |
| IsTrackingViewState |
Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da DataControlField) |
| ItemStyle |
Ottiene lo stile di qualsiasi contenuto basato su testo visualizzato da un campo di controllo dati. (Ereditato da DataControlField) |
| NavigateUrl |
Ottiene o imposta l'URL a cui passare quando si fa clic su un collegamento ipertestuale in un HyperLinkField oggetto . |
| ShowHeader |
Ottiene o imposta un valore che indica se viene eseguito il rendering dell'elemento di intestazione di un campo del controllo dati. (Ereditato da DataControlField) |
| SortExpression |
Ottiene o imposta un'espressione di ordinamento 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 si fa clic su un collegamento ipertestuale in un HyperLinkField oggetto . |
| Text |
Ottiene o imposta il testo da visualizzare per ogni collegamento ipertestuale nell'oggetto HyperLinkField . |
| ValidateRequestMode |
Ottiene o imposta un valore che specifica se il controllo convalida l'input client. (Ereditato da DataControlField) |
| ViewState |
Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un DataControlField oggetto in 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
| Nome | Descrizione |
|---|---|
| CloneField() |
Crea una copia duplicata dell'oggetto derivato da corrente DataControlField. (Ereditato da DataControlField) |
| CopyProperties(DataControlField) |
Copia le proprietà dell'oggetto corrente HyperLinkField nell'oggetto specificato. |
| CreateField() |
Restituisce una nuova istanza della HyperLinkField classe . |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Estrae il valore del campo del controllo dati dalla cella della tabella corrente e aggiunge il valore alla raccolta specificata IDictionary . (Ereditato da DataControlField) |
| FormatDataNavigateUrlValue(Object[]) |
Formatta l'URL di spostamento usando la stringa di formato specificata dalla DataNavigateUrlFormatString proprietà . |
| FormatDataTextValue(Object) |
Formatta il testo della didascalia usando la stringa di formato specificata dalla DataTextFormatString proprietà . |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| Initialize(Boolean, Control) |
Inizializza l'oggetto HyperLinkField. |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Inizializza una cella in un HyperLinkField oggetto . |
| LoadViewState(Object) |
Ripristina lo stato di visualizzazione salvata in precedenza della vista origine dati. (Ereditato da DataControlField) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnFieldChanged() |
Genera l'evento |
| SaveViewState() |
Salva le modifiche apportate allo stato di DataControlField visualizzazione dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da DataControlField) |
| ToString() |
Restituisce una stringa che rappresenta questo DataControlField oggetto. (Ereditato da DataControlField) |
| TrackViewState() |
Fa in modo che l'oggetto DataControlField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da DataControlField) |
| ValidateSupportsCallback() |
Indica che i controlli contenuti nell'oggetto HyperLinkField supportano i callback. |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Ottiene o imposta lo schema associato a questo DataControlField oggetto. (Ereditato da DataControlField) |
| IStateManager.IsTrackingViewState |
Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da DataControlField) |
| IStateManager.LoadViewState(Object) |
Ripristina lo stato di visualizzazione salvato in precedenza del campo del controllo dati. (Ereditato da DataControlField) |
| IStateManager.SaveViewState() |
Salva le modifiche apportate allo stato di DataControlField visualizzazione dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da DataControlField) |
| IStateManager.TrackViewState() |
Fa in modo che l'oggetto DataControlField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da DataControlField) |
