HyperLinkField Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje pole, które jest wyświetlane jako hiperlink w kontrolce powiązanej z danymi.
public ref class HyperLinkField : System::Web::UI::WebControls::DataControlFieldpublic class HyperLinkField : System.Web.UI.WebControls.DataControlFieldtype HyperLinkField = class
inherit DataControlFieldPublic Class HyperLinkField
Inherits DataControlField- Dziedziczenie
Przykłady
W poniższym przykładzie kodu pokazano, jak używać HyperLinkField obiektu do wyświetlania kolumny statycznych hiperlinków w kontrolce GridView . Każde hiperłącze w HyperLinkField obiekcie ma ten sam podpis i adres URL nawigacji określony odpowiednio przez Text właściwości i 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>
W poniższym przykładzie kodu pokazano, jak powiązać HyperLinkField obiekt z polami w źródle danych. Właściwości DataTextField i DataNavigateUrlFields służą do określania pól, które mają być powiązane z podpisem, oraz adresu URL nawigacji, odpowiednio, każdego hiperłącza wyświetlanego HyperLinkField w obiekcie.
<%@ 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>
Uwagi
Klasa HyperLinkField jest używana przez kontrolki powiązane z danymi (takie jak GridView i DetailsView), aby wyświetlić hiperlink dla każdego wyświetlanego rekordu. Gdy użytkownik kliknie hiperlink, zostanie przekierowany do strony sieci Web skojarzonej z hiperlinkiem. Obiekt HyperLinkField jest wyświetlany inaczej w zależności od kontrolki powiązanej z danymi, w której jest używany. Na przykład kontrolka GridView wyświetla HyperLinkField obiekt jako kolumnę, a kontrolka DetailsView wyświetla go jako wiersz.
Aby określić podpis do wyświetlenia dla hiperlinków, użyj Text właściwości . NavigateUrl Użyj właściwości , aby określić adres URL, aby przejść do momentu kliknięcia hiperlinku. Jeśli chcesz wyświetlić połączoną zawartość w określonym oknie lub ramce, ustaw Target właściwość .
Uwaga
Po ustawieniu Text właściwości i NavigateUrl wszystkie hiperlinki w HyperLinkField obiekcie mają ten sam podpis i adres URL nawigacji. Podobnie Target właściwość ma również zastosowanie do wszystkich hiperlinków.
Alternatywnie można powiązać HyperLinkField obiekt z polami w źródle danych. Dzięki temu można wyświetlić inny podpis dla każdego hiperłącza w HyperLinkField obiekcie i mieć każde hiperłącze przechodzi do innej lokalizacji. Aby powiązać pole z podpisem, ustaw DataTextField właściwość . Aby utworzyć adres URL nawigacji, ustaw DataNavigateUrlFields właściwość na rozdzielaną przecinkami listę pól, która będzie używana do utworzenia adresu URL.
Możesz określić niestandardowy format dla podpisów i adresów URL nawigacji, ustawiając DataTextFormatString odpowiednio właściwości i DataNavigateUrlFormatString .
Obiekt można ukryć HyperLinkField w kontrolce powiązanej z danymi, ustawiając Visible właściwość na false.
Sekcje nagłówka HyperLinkField i stopki obiektu można dostosować. Aby wyświetlić podpis w sekcjach nagłówka lub stopki, ustaw HeaderText odpowiednio właściwości lub FooterText . Aby wyświetlić obraz w sekcji nagłówka zamiast tekstu, ustaw HeaderImageUrl właściwość . Sekcja nagłówka HyperLinkField może być ukryta w obiekcie, ustawiając ShowHeader właściwość na false.
Uwaga
Niektóre kontrolki powiązane z danymi (takie jak kontrolka GridView ) mogą pokazywać lub ukrywać tylko całą sekcję nagłówka kontrolki. Te kontrolki powiązane z danymi nie obsługują ShowHeader właściwości dla pojedynczego pola powiązanego. Aby wyświetlić lub ukryć całą sekcję nagłówka kontrolki powiązanej z danymi, użyj właściwości kontrolki ShowHeader (jeśli jest dostępna).
Możesz również dostosować wygląd HyperLinkField obiektu (kolor czcionki, kolor tła itd.), ustawiając właściwości stylu dla różnych części pola. W poniższej tabeli wymieniono różne właściwości stylu.
| Właściwość Stylu | Opis |
|---|---|
| ControlStyle | Ustawienia stylu podrzędnego serwera sieci Web steruje obiektem HyperLinkField . |
| FooterStyle | Ustawienia stylu sekcji HyperLinkField stopki obiektu. |
| HeaderStyle | Ustawienia stylu sekcji nagłówka HyperLinkField obiektu. |
| ItemStyle | Ustawienia stylu elementów danych w HyperLinkField obiekcie. |
Konstruktory
| HyperLinkField() |
Inicjuje nowe wystąpienie klasy HyperLinkField. |
Właściwości
| AccessibleHeaderText |
Pobiera lub ustawia tekst renderowany jako |
| Control |
Pobiera odwołanie do kontrolki danych skojarzonej DataControlField z obiektem. (Odziedziczone po DataControlField) |
| ControlStyle |
Pobiera styl wszystkich kontrolek serwera sieci Web zawartych w DataControlField obiekcie. (Odziedziczone po DataControlField) |
| DataNavigateUrlFields |
Pobiera lub ustawia nazwy pól ze źródła danych używanego do konstruowania adresów URL hiperlinków w HyperLinkField obiekcie . |
| DataNavigateUrlFormatString |
Pobiera lub ustawia ciąg określający format renderowania adresów URL hiperłączy w HyperLinkField obiekcie. |
| DataTextField |
Pobiera lub ustawia nazwę pola ze źródła danych zawierającego tekst, który ma być wyświetlany dla podpisów hiperlinków w HyperLinkField obiekcie. |
| DataTextFormatString |
Pobierz lub ustawia ciąg określający format wyświetlania podpisów hiperlinków w HyperLinkField obiekcie. |
| DesignMode |
Pobiera wartość wskazującą, czy pole kontrolki danych jest obecnie wyświetlane w środowisku czasu projektowania. (Odziedziczone po DataControlField) |
| FooterStyle |
Pobiera lub ustawia styl stopki pola kontrolki danych. (Odziedziczone po DataControlField) |
| FooterText |
Pobiera lub ustawia tekst wyświetlany w elemencie stopki pola kontrolki danych. (Odziedziczone po DataControlField) |
| HeaderImageUrl |
Pobiera lub ustawia adres URL obrazu wyświetlanego w elemencie nagłówka pola kontrolki danych. (Odziedziczone po DataControlField) |
| HeaderStyle |
Pobiera lub ustawia styl nagłówka pola kontrolki danych. (Odziedziczone po DataControlField) |
| HeaderText |
Pobiera lub ustawia tekst wyświetlany w elemencie nagłówka pola kontrolki danych. (Odziedziczone po DataControlField) |
| InsertVisible |
Pobiera wartość wskazującą, czy DataControlField obiekt jest widoczny, gdy jego nadrzędna kontrolka związana z danymi jest w trybie wstawiania. (Odziedziczone po DataControlField) |
| IsTrackingViewState |
Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po DataControlField) |
| ItemStyle |
Pobiera styl dowolnej zawartości tekstowej wyświetlanej przez pole kontrolki danych. (Odziedziczone po DataControlField) |
| NavigateUrl |
Pobiera lub ustawia adres URL, aby przejść do momentu kliknięcia hiperłącza w HyperLinkField obiekcie. |
| ShowHeader |
Pobiera lub ustawia wartość wskazującą, czy element nagłówka pola kontrolki danych jest renderowany. (Odziedziczone po DataControlField) |
| SortExpression |
Pobiera lub ustawia wyrażenie sortowania używane przez kontrolkę źródła danych do sortowania danych. (Odziedziczone po DataControlField) |
| Target |
Pobiera lub ustawia okno docelowe lub ramkę, w której ma być wyświetlana strona sieci Web połączona po kliknięciu hiperłącza w HyperLinkField obiekcie. |
| Text |
Pobiera lub ustawia tekst wyświetlany dla każdego hiperłącza HyperLinkField w obiekcie. |
| ValidateRequestMode |
Pobiera lub ustawia wartość określającą, czy kontrolka weryfikuje dane wejściowe klienta. (Odziedziczone po DataControlField) |
| ViewState |
Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu DataControlField widoku obiektu na wielu żądaniach dla tej samej strony. (Odziedziczone po DataControlField) |
| Visible |
Pobiera lub ustawia wartość wskazującą, czy pole kontrolki danych jest renderowane. (Odziedziczone po DataControlField) |
Metody
| CloneField() |
Tworzy zduplikowaną kopię bieżącego DataControlFieldobiektu pochodnego. (Odziedziczone po DataControlField) |
| CopyProperties(DataControlField) |
Kopiuje właściwości bieżącego HyperLinkField obiektu do określonego obiektu. |
| CreateField() |
Zwraca nowe wystąpienie HyperLinkField klasy . |
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Wyodrębnia wartość pola kontrolki danych z bieżącej komórki tabeli i dodaje wartość do określonej IDictionary kolekcji. (Odziedziczone po DataControlField) |
| FormatDataNavigateUrlValue(Object[]) |
Formatuje adres URL nawigacji przy użyciu ciągu formatu określonego DataNavigateUrlFormatString przez właściwość. |
| FormatDataTextValue(Object) |
Formatuje tekst podpisu przy użyciu ciągu formatu określonego DataTextFormatString przez właściwość. |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
| Initialize(Boolean, Control) |
Inicjuje HyperLinkField obiekt. |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Inicjuje komórkę HyperLinkField w obiekcie. |
| LoadViewState(Object) |
Przywraca wcześniej zapisany stan widoku źródła danych. (Odziedziczone po DataControlField) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| OnFieldChanged() |
|
| SaveViewState() |
Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po DataControlField) |
| ToString() |
Zwraca ciąg reprezentujący ten DataControlField obiekt. (Odziedziczone po DataControlField) |
| TrackViewState() |
DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Odziedziczone po DataControlField) |
| ValidateSupportsCallback() |
Wskazuje, że kontrolki zawarte przez HyperLinkField obiekt obsługują wywołania zwrotne. |
Jawne implementacje interfejsu
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Pobiera lub ustawia schemat skojarzony z tym DataControlField obiektem. (Odziedziczone po DataControlField) |
| IStateManager.IsTrackingViewState |
Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po DataControlField) |
| IStateManager.LoadViewState(Object) |
Przywraca wcześniej zapisany stan widoku pola kontroli danych. (Odziedziczone po DataControlField) |
| IStateManager.SaveViewState() |
Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po DataControlField) |
| IStateManager.TrackViewState() |
DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Odziedziczone po DataControlField) |