HyperLinkField Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje pole, které se zobrazuje jako hypertextový odkaz v ovládacím prvku vázaném na data.
public ref class HyperLinkField : System::Web::UI::WebControls::DataControlFieldpublic class HyperLinkField : System.Web.UI.WebControls.DataControlFieldtype HyperLinkField = class
inherit DataControlFieldPublic Class HyperLinkField
Inherits DataControlField- Dědičnost
Příklady
Následující příklad kódu ukazuje, jak použít HyperLinkField objekt k zobrazení sloupce statických hypertextových odkazů v ovládacím GridView prvku. Každý hypertextový odkaz v objektu HyperLinkField sdílí stejný titulek a navigační adresu URL určenou vlastnostmi a NavigateUrl vlastnostmiText.
<%@ 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>
Následující příklad kódu ukazuje, jak vytvořit vazbu objektu HyperLinkField na pole ve zdroji dat. Vlastnosti DataTextField se používají k určení polí, která se mají svázat s titulkem, a navigační adresou URL každého hypertextového odkazu zobrazeného v objektuHyperLinkField.DataNavigateUrlFields
<%@ 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>
Poznámky
Třídu HyperLinkField používají ovládací prvky vázané na data (například GridView a DetailsView) k zobrazení hypertextového odkazu pro každý zobrazený záznam. Když uživatel klikne na hypertextový odkaz, bude přesměrován na webovou stránku přidruženou k hypertextovému odkazu. Objekt HyperLinkField se zobrazuje odlišně v závislosti na ovládacím prvku vázaném na data, ve kterém se používá. Například GridView ovládací prvek zobrazí HyperLinkField objekt jako sloupec, zatímco ovládací DetailsView prvek ho zobrazí jako řádek.
Chcete-li zadat titulek, který se má zobrazit pro hypertextové odkazy, použijte Text vlastnost. NavigateUrl Pomocí vlastnosti zadejte adresu URL, na které se má přejít při kliknutí na hypertextový odkaz. Pokud chcete odkazovaný obsah zobrazit v určitém okně nebo rámečku, nastavte Target vlastnost.
Poznámka
Text Když jsou nastaveny a NavigateUrl vlastnosti, všechny hypertextové odkazy v objektu HyperLinkField sdílejí stejný titulek a navigační adresu URL. Podobně platí i pro Target všechny hypertextové odkazy.
Alternativně můžete vytvořit vazbu objektu HyperLinkField na pole ve zdroji dat. To umožňuje zobrazit jiný titulek pro každý hypertextový odkaz v objektu HyperLinkField a mít každý hypertextový odkaz přecházet do jiného umístění. Pokud chcete svázat pole s titulkem, nastavte DataTextField vlastnost. Pokud chcete vytvořit adresu URL pro navigaci, nastavte DataNavigateUrlFields vlastnost na seznam polí oddělených čárkami, která chcete použít k vytvoření adresy URL.
Vlastní formát titulků a navigačních adres URL můžete zadat nastavením DataTextFormatString a DataNavigateUrlFormatString vlastností.
Objekt v ovládacím prvku vázaném na data můžete skrýt HyperLinkField nastavením Visible vlastnosti na false.
Oddíly záhlaví a zápatí objektu HyperLinkField můžete přizpůsobit. Pokud chcete zobrazit titulek v oddílech záhlaví nebo zápatí, nastavte hodnoty HeaderText nebo FooterText vlastnosti. Pokud chcete místo textu zobrazit obrázek v oddílu záhlaví, nastavte HeaderImageUrl vlastnost. Oddíl záhlaví může být v objektu HyperLinkField skryt nastavením ShowHeader vlastnosti na false.
Poznámka
Některé ovládací prvky vázané na data (například GridView ovládací prvek) můžou zobrazit nebo skrýt jenom celý oddíl záhlaví ovládacího prvku. Tyto ovládací prvky vázané na data nepodporují ShowHeader vlastnost pro jednotlivé vázané pole. Pokud chcete zobrazit nebo skrýt celý oddíl záhlaví ovládacího prvku vázaného na data, použijte vlastnost ovládacího prvku ShowHeader (pokud je k dispozici).
Vzhled objektu HyperLinkField (barva písma, barva pozadí atd.) můžete také přizpůsobit nastavením vlastností stylu pro různé části pole. Následující tabulka uvádí různé vlastnosti stylu.
| Vlastnost stylu | Description |
|---|---|
| ControlStyle | Nastavení stylu podřízených ovládacích prvků webového serveru objektu HyperLinkField . |
| FooterStyle | Nastavení stylu pro oddíl zápatí objektu HyperLinkField . |
| HeaderStyle | Nastavení stylu pro oddíl záhlaví objektu HyperLinkField . |
| ItemStyle | Nastavení stylu datových položek v objektu HyperLinkField . |
Konstruktory
| HyperLinkField() |
Inicializuje novou instanci HyperLinkField třídy. |
Vlastnosti
| AccessibleHeaderText |
Získá nebo nastaví text, který je vykreslen jako |
| Control |
Získá odkaz na ovládací prvek dat, ke kterému DataControlField je objekt přidružen. (Zděděno od DataControlField) |
| ControlStyle |
Získá styl všech webových server ovládacích prvků obsažených objektem DataControlField . (Zděděno od DataControlField) |
| DataNavigateUrlFields |
Získá nebo nastaví názvy polí ze zdroje dat použité k vytvoření adres URL pro hypertextové odkazy v objektu HyperLinkField . |
| DataNavigateUrlFormatString |
Získá nebo nastaví řetězec, který určuje formát, ve kterém jsou vykresleny adresy URL hypertextových odkazů v objektu HyperLinkField . |
| DataTextField |
Získá nebo nastaví název pole ze zdroje dat obsahujícího text, který se má zobrazit pro titulky hypertextových odkazů v objektu HyperLinkField . |
| DataTextFormatString |
Získejte nebo nastaví řetězec, který určuje formát, ve kterém se zobrazují titulky hypertextového odkazu v objektu HyperLinkField . |
| DesignMode |
Získá hodnotu označující, zda je pole ovládacího prvku dat aktuálně zobrazeno v návrhovém prostředí. (Zděděno od DataControlField) |
| FooterStyle |
Získá nebo nastaví styl zápatí pole ovládacího prvku dat. (Zděděno od DataControlField) |
| FooterText |
Získá nebo nastaví text, který je zobrazen v zápatí položky pole ovládacího prvku dat. (Zděděno od DataControlField) |
| HeaderImageUrl |
Získá nebo nastaví adresu URL obrázku, který se zobrazí v položce záhlaví pole ovládacího prvku dat. (Zděděno od DataControlField) |
| HeaderStyle |
Získá nebo nastaví styl záhlaví pole ovládacího prvku dat. (Zděděno od DataControlField) |
| HeaderText |
Získá nebo nastaví text zobrazený v položce záhlaví pole ovládacího prvku dat. (Zděděno od DataControlField) |
| InsertVisible |
Získá hodnotu označující, zda DataControlField je objekt viditelný, když je nadřazený ovládací prvek vázané na data v režimu vložení. (Zděděno od DataControlField) |
| IsTrackingViewState |
Získá hodnotu určující, zda DataControlField objekt ukládá změny do stavu zobrazení. (Zděděno od DataControlField) |
| ItemStyle |
Získá styl libovolného textového obsahu zobrazeného polem ovládacího prvku dat. (Zděděno od DataControlField) |
| NavigateUrl |
Získá nebo nastaví adresu URL pro přechod na odkaz při kliknutí na hypertextový odkaz v objektu HyperLinkField . |
| ShowHeader |
Získá nebo nastaví hodnotu určující, zda je položka záhlaví pole ovládacího prvku dat vykreslena. (Zděděno od DataControlField) |
| SortExpression |
Získá nebo nastaví výraz řazení, který používá ovládací prvek zdroje dat k řazení dat. (Zděděno od DataControlField) |
| Target |
Získá nebo nastaví cílové okno nebo rámec, ve kterém se má zobrazit webová stránka propojená s hypertextovým odkazem v objektu HyperLinkField . |
| Text |
Získá nebo nastaví text, který se má zobrazit pro každý hypertextový odkaz v objektu HyperLinkField . |
| ValidateRequestMode |
Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek ověřuje vstup klienta. (Zděděno od DataControlField) |
| ViewState |
Získá slovník informací o stavu, který umožňuje uložit a obnovit stav DataControlField zobrazení objektu napříč více požadavky na stejnou stránku. (Zděděno od DataControlField) |
| Visible |
Získá nebo nastaví hodnotu označující, zda je pole ovládacího prvku dat vykresleno. (Zděděno od DataControlField) |
Metody
| CloneField() |
Vytvoří duplicitní kopii aktuálního DataControlFieldodvozeného objektu. (Zděděno od DataControlField) |
| CopyProperties(DataControlField) |
Zkopíruje vlastnosti aktuálního HyperLinkField objektu do zadaného objektu. |
| CreateField() |
Vrátí novou instanci HyperLinkField třídy. |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Extrahuje hodnotu pole ovládacího prvku dat z aktuální buňky tabulky a přidá hodnotu do zadané IDictionary kolekce. (Zděděno od DataControlField) |
| FormatDataNavigateUrlValue(Object[]) |
Naformátuje navigační adresu URL pomocí řetězce formátu určeného DataNavigateUrlFormatString vlastností. |
| FormatDataTextValue(Object) |
Formátuje text titulku pomocí řetězce formátu určeného DataTextFormatString vlastností. |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetType() |
Type Získá aktuální instanci. (Zděděno od Object) |
| Initialize(Boolean, Control) |
Inicializuje HyperLinkField objekt. |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Inicializuje buňku v objektu HyperLinkField . |
| LoadViewState(Object) |
Obnoví dříve uložený stav zobrazení zdroje dat. (Zděděno od DataControlField) |
| MemberwiseClone() |
Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object) |
| OnFieldChanged() |
Vyvolá |
| SaveViewState() |
Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka publikována zpět na server. (Zděděno od DataControlField) |
| ToString() |
Vrátí řetězec, který představuje tento DataControlField objekt. (Zděděno od DataControlField) |
| TrackViewState() |
Způsobí, DataControlField že objekt bude sledovat změny ve stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat napříč požadavky na stejnou stránku. (Zděděno od DataControlField) |
| ValidateSupportsCallback() |
Označuje, že ovládací prvky obsažené objektem HyperLinkField podporují zpětné volání. |
Explicitní implementace rozhraní
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Získá nebo nastaví schéma přidružené k tomuto DataControlField objektu. (Zděděno od DataControlField) |
| IStateManager.IsTrackingViewState |
Získá hodnotu označující, zda DataControlField objekt ukládá změny do stavu zobrazení. (Zděděno od DataControlField) |
| IStateManager.LoadViewState(Object) |
Obnoví dříve uložený stav zobrazení pole ovládacího prvku dat. (Zděděno od DataControlField) |
| IStateManager.SaveViewState() |
Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka publikována zpět na server. (Zděděno od DataControlField) |
| IStateManager.TrackViewState() |
Způsobí, DataControlField že objekt bude sledovat změny ve stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat napříč požadavky na stejnou stránku. (Zděděno od DataControlField) |