Udostępnij za pośrednictwem


HyperLinkField Klasa

Definicja

Reprezentuje pole, które jest wyświetlane jako hiperlink w kontrolce powiązanej z danymi.

public ref class HyperLinkField : System::Web::UI::WebControls::DataControlField
public class HyperLinkField : System.Web.UI.WebControls.DataControlField
type HyperLinkField = class
    inherit DataControlField
Public Class HyperLinkField
Inherits DataControlField
Dziedziczenie
HyperLinkField

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 AbbreviatedText wartość właściwości w niektórych kontrolkach.

(Odziedziczone po DataControlField)
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()

FieldChanged Zgłasza zdarzenie.

(Odziedziczone po DataControlField)
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)

Dotyczy

Zobacz też