HyperLinkColumn Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

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.

Typ kolumny kontrolki DataGrid zawierającej hiperlink dla każdego elementu w kolumnie.

public ref class HyperLinkColumn : System::Web::UI::WebControls::DataGridColumn

public class HyperLinkColumn : System.Web.UI.WebControls.DataGridColumn

type HyperLinkColumn = class
    inherit DataGridColumn

Public Class HyperLinkColumn
Inherits DataGridColumn

Dziedziczenie: Object

DataGridColumn
HyperLinkColumn

Przykłady

W poniższym przykładzie pokazano, jak utworzyć HyperLinkColumn link do oddzielnej strony.

Uwaga

Poniższy przykładowy kod używa modelu kodu pojedynczego pliku i może nie działać poprawnie, jeśli został skopiowany bezpośrednio do pliku za pomocą kodu. Ten przykładowy kod musi zostać skopiowany do pustego pliku tekstowego z rozszerzeniem .aspx. Aby uzyskać więcej informacji na temat modelu kodu formularzy internetowych, zobacz model kodu strony formularzy internetowych ASP.NET.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!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>
    <title>HyperLinkColumn Example</title>
<script runat="server">

      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("PriceValue", typeof(Double)));
       
         for (int i = 0; i < 3; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = (Double)i * 1.23;

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }

      void Page_Load(Object sender, EventArgs e) 
      {
         MyDataGrid.DataSource = CreateDataSource();
         MyDataGrid.DataBind();
      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>HyperLinkColumn Example</h3>

      <asp:DataGrid id="MyDataGrid" 
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#aaaadd"/>

         <Columns>

            <asp:HyperLinkColumn
                 HeaderText="Select an Item"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 Target="_blank"/>
           
         </Columns>

      </asp:DataGrid>

   </form>

</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!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>
    <title>HyperLinkColumn Example</title>
<script runat="server">

      Function CreateDataSource() As ICollection 
      
         Dim dt As DataTable = New DataTable()
         Dim dr As DataRow
         Dim i As Integer

         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("PriceValue", GetType(Double)))
       
         For i = 0 to 2 
         
            dr = dt.NewRow()

            dr(0) = i
            dr(1) = CDbl(i) * 1.23

            dt.Rows.Add(dr)

         Next i

         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function

      Sub Page_Load(sender As Object, e As EventArgs) 
    
         MyDataGrid.DataSource = CreateDataSource()
         MyDataGrid.DataBind()

      End Sub

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>HyperLinkColumn Example</h3>

      <asp:DataGrid id="MyDataGrid" 
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#aaaadd"/>

         <Columns>

            <asp:HyperLinkColumn
                 HeaderText="Select an Item"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 Target="_blank"/>
           
         </Columns>

      </asp:DataGrid>

   </form>

</body>
</html>

Poniższy odpowiedni przykład przedstawia element wybrany w poprzednim przykładzie.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
    <title>Details page for DataGrid</title>
<script runat="server">
 
      void Page_Load(Object sender, EventArgs e) 
      {
         Label1.Text = "You selected item: " + Request.QueryString["id"];
      }
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
    <title>Details page for DataGrid</title>
<script runat="server">
 
      Sub Page_Load(sender As Object, e As EventArgs) 
      
         Label1.Text = "You selected item: " & Request.QueryString("id")
      
      End Sub
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</body>
</html>

Uwagi

HyperLinkColumn Użyj typu kolumny w kontrolceDataGrid, aby utworzyć hiperlink dla każdego wiersza w obiekcie DataGrid. Text Ustaw właściwość , aby określić tekst podpisu dla hiperłącza. Aby określić adres URL, do który ma zostać wyświetlony po kliknięciu hiperłącza, ustaw NavigateUrl właściwość .

Uwaga

Jeśli ustawisz Text właściwości i NavigateUrl , wszystkie hiperlinki w kolumnie będą współdzielić ten sam podpis i adres URL.

Możesz również powiązać podpis tekstowy i adres URL hiperlinków z polem w HyperLinkColumn źródle danych zamiast ustawiać Text właściwości i NavigateUrl . Dzięki temu można wyświetlić inny podpis i określić inny adres URL dla każdego hiperłącza w kolumnie.

DataTextField Użyj właściwości , aby określić pole w źródle danych w celu powiązania z podpisem tekstowym hiperlinków w kolumnie.

Uwaga

Właściwości DataTextField i Text nie można ustawić jednocześnie. Jeśli obie właściwości są ustawione, DataTextField właściwość ma pierwszeństwo.

Określ pole, które ma być powiązane z adresem URL hiperłącza, ustawiając DataNavigateUrlField właściwość.

Uwaga

Właściwości DataNavigateUrlField i NavigateUrl nie można ustawić jednocześnie. Jeśli obie właściwości są ustawione, DataNavigateUrlField właściwość ma pierwszeństwo.

Właściwość Target umożliwia określenie okna lub ramki, aby wyświetlić zawartość strony internetowej połączoną z kliknięciem hiperłącza.

W przypadku używania powiązania danych można sformatować podpis tekstowy i adres URL hiperlinku, ustawiając DataTextFormatString odpowiednio właściwości i DataNavigateUrlFormatString .

Przestroga

Ta kontrolka może służyć do wyświetlania danych wejściowych użytkownika, które mogą obejmować złośliwy skrypt klienta. Sprawdź wszelkie informacje wysyłane z klienta do skryptu wykonywalnego, instrukcji SQL lub innego kodu przed wyświetleniem go w aplikacji. Kontrolki weryfikacji umożliwiają zweryfikowanie danych wejściowych użytkownika przed wyświetleniem tekstu wejściowego w kontrolce. ASP.NET udostępnia funkcję weryfikacji żądań wejściowych w celu blokowania skryptu i kodu HTML w danych wejściowych użytkownika. Aby uzyskać więcej informacji, zobacz Zabezpieczanie standardowych kontrolek, Jak chronić przed programami wykorzystującymi skrypty w aplikacji internetowej, stosując kodowanie HTML do ciągów i weryfikowanie danych wejściowych użytkownika na stronach internetowych ASP.NET.

Konstruktory

HyperLinkColumn()

Inicjuje nowe wystąpienie klasy HyperLinkColumn.

Właściwości

DataNavigateUrlField	Pobiera lub ustawia pole ze źródła danych w celu powiązania z adresem URL hiperlinków w elemecie HyperLinkColumn.
DataNavigateUrlFormatString	Pobiera lub ustawia format wyświetlania dla adresu URL hiperlinków w HyperLinkColumn momencie, gdy adres URL jest powiązany z polem w źródle danych.
DataTextField	Pobiera lub ustawia pole ze źródła danych w celu powiązania z podpisem tekstowym hiperlinków w obiekcie HyperLinkColumn.
DataTextFormatString	Pobiera lub ustawia format wyświetlania dla podpisu tekstu hiperlinków w kolumnie HyperLinkColumn .
DesignMode	Pobiera wartość wskazującą, czy kolumna jest w trybie projektowania. (Odziedziczone po DataGridColumn)
FooterStyle	Pobiera właściwości stylu dla sekcji stopki kolumny. (Odziedziczone po DataGridColumn)
FooterText	Pobiera lub ustawia tekst wyświetlany w sekcji stopki kolumny. (Odziedziczone po DataGridColumn)
HeaderImageUrl	Pobiera lub ustawia lokalizację obrazu do wyświetlenia w sekcji nagłówka kolumny. (Odziedziczone po DataGridColumn)
HeaderStyle	Pobiera właściwości stylu dla sekcji nagłówka kolumny. (Odziedziczone po DataGridColumn)
HeaderText	Pobiera lub ustawia tekst wyświetlany w sekcji nagłówka kolumny. (Odziedziczone po DataGridColumn)
IsTrackingViewState	Pobiera wartość określającą, czy DataGridColumn obiekt jest oznaczony w celu zapisania stanu. (Odziedziczone po DataGridColumn)
ItemStyle	Pobiera właściwości stylu dla komórek elementów kolumny. (Odziedziczone po DataGridColumn)
NavigateUrl	Pobiera lub ustawia adres URL, aby połączyć się z kliknięciem hiperłącza w kolumnie.
Owner	Pobiera kontrolkę DataGrid , do którego należy kolumna. (Odziedziczone po DataGridColumn)
SortExpression	Pobiera lub ustawia nazwę pola lub wyrażenia, które ma być przekazywane do OnSortCommand(DataGridSortCommandEventArgs) metody po wybraniu kolumny do sortowania. (Odziedziczone po DataGridColumn)
Target	Pobiera lub ustawia okno docelowe lub ramkę, aby wyświetlić zawartość strony sieci Web, która jest połączona po kliknięciu hiperłącza w kolumnie.
Text	Pobiera lub ustawia podpis tekstu, aby wyświetlić hiperlinki w kolumnie.
ViewState	StateBag Pobiera obiekt, który umożliwia kolumnie pochodzącej DataGridColumn z klasy przechowywanie jego właściwości. (Odziedziczone po DataGridColumn)
Visible	Pobiera lub ustawia wartość wskazującą, czy kolumna jest widoczna w kontrolce DataGrid . (Odziedziczone po DataGridColumn)

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FormatDataNavigateUrlValue(Object)	Formatuje adres URL powiązany z danymi przy użyciu formatu określonego DataNavigateUrlFormatString przez właściwość.
FormatDataTextValue(Object)	Formatuje podpis tekstu powiązanego z danymi przy użyciu formatu określonego DataTextFormatString przez właściwość.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
Initialize()	Zapewnia implementację podstawową w celu zresetowania kolumny pochodzącej z klasy do stanu początkowego DataGridColumn .
InitializeCell(TableCell, Int32, ListItemType)	Inicjuje komórkę reprezentującą tę kolumnę za pomocą zawartego hiperłącza.
LoadViewState(Object)	Ładuje stan DataGridColumn obiektu. (Odziedziczone po DataGridColumn)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnColumnChanged()	Wywołuje metodę OnColumnsChanged() . (Odziedziczone po DataGridColumn)
SaveViewState()	Zapisuje bieżący stan DataGridColumn obiektu. (Odziedziczone po DataGridColumn)
ToString()	Zwraca reprezentację ciągu kolumny. (Odziedziczone po DataGridColumn)
TrackViewState()	Powoduje śledzenie zmian stanu widoku w kontrolce serwera, dzięki czemu mogą być przechowywane w obiekcie kontroli StateBag serwera. (Odziedziczone po DataGridColumn)

Jawne implementacje interfejsu

IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy kolumna śledzi zmiany stanu widoku. (Odziedziczone po DataGridColumn)
IStateManager.LoadViewState(Object)	Ładuje wcześniej zapisany stan. (Odziedziczone po DataGridColumn)
IStateManager.SaveViewState()	Zwraca obiekt zawierający zmiany stanu. (Odziedziczone po DataGridColumn)
IStateManager.TrackViewState()	Rozpoczyna śledzenie zmian stanu. (Odziedziczone po DataGridColumn)

Dotyczy

Udostępnij za pośrednictwem

HyperLinkColumn Klasa

Definicja

Przykłady

Uwagi

Konstruktory

Właściwości

Metody

Jawne implementacje interfejsu

Dotyczy

Zobacz też

Dodatkowe zasoby