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ć obiekt HyperLinkColumn prowadzący do oddzielnej strony.

Uwaga

Poniższy przykładowy kod używa modelu kodu z jednym plikiem 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 Web Forms, zobacz ASP.NET Web Forms Page Code Model (Model kodu strony ASP.NET Web Forms).

<%@ 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 odpowiadający przykład wyświetla 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. Ustaw właściwość , Text aby określić tekst podpisu dla hiperłącza. Aby określić adres URL linku do po kliknięciu hiperlinku NavigateUrl , ustaw 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 do wyświetlania zawartości strony sieci Web połączonej po kliknięciu hiperlinku.

W przypadku korzystania z 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. Przed wyświetleniem w aplikacji sprawdź informacje wysyłane z klienta pod kątem skryptu wykonywalnego, instrukcji SQL lub innego kodu. Kontrolki weryfikacji umożliwiają zweryfikowanie danych wejściowych użytkownika przed wyświetleniem tekstu wejściowego w kontrolce. ASP.NET udostępnia funkcję weryfikacji żądania wejściowego w celu blokowania skryptu i kodu HTML w danych wejściowych użytkownika. Aby uzyskać więcej informacji, zobacz Securing Standard Controls (Zabezpieczanie standardowych kontrolek ), How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings (Zabezpieczanie standardowych kontrolek), How to: Protect Against Script Exploits in a Web Pages (Zabezpieczanie standardowych kontrolek: ochrona przed programami wykorzystującymi luki w zabezpieczeniach skryptów w aplikacji internetowej przez zastosowanie kodowania HTML do ciągów) i Weryfikowanie danych wejściowych użytkownika na stronach sieci Web 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 obiekcie HyperLinkColumn.
DataNavigateUrlFormatString	Pobiera lub ustawia format wyświetlania adresu URL hiperlinków w adresie URL, HyperLinkColumn 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 tekstowego 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 jego 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, z którym ma być link po kliknięciu hiperlinku 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ę w celu wyświetlenia zawartości strony sieci Web połączonej po kliknięciu hiperlinku w kolumnie.
Text	Pobiera lub ustawia podpis tekstowy do wyświetlenia dla hiperlinków w kolumnie.
ViewState	StateBag Pobiera obiekt, który umożliwia kolumnie pochodzącej DataGridColumn z klasy przechowywanie jej 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 tekstowy powiązany 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 wartość bieżącego wystąpienia. (Odziedziczone po Object)
Initialize()	Udostępnia podstawową implementację 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 można je przechowywać w obiekcie kontrolki 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

HyperLinkColumn Klasa

Definicja

Przykłady

Uwagi

Konstruktory

Właściwości

Metody

Jawne implementacje interfejsu

Dotyczy

Zobacz też

Opinia

Dodatkowe zasoby