HyperLinkColumn Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Tipe kolom untuk DataGrid kontrol yang berisi hyperlink untuk setiap item dalam kolom.

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

Warisan: Object

DataGridColumn
HyperLinkColumn

Contoh

Contoh berikut menunjukkan cara membuat HyperLinkColumn tautan tersebut ke halaman terpisah.

Catatan

Sampel kode berikut menggunakan model kode file tunggal dan mungkin tidak berfungsi dengan benar jika disalin langsung ke file code-behind. Sampel kode ini harus disalin ke dalam file teks kosong yang memiliki ekstensi .aspx. Untuk informasi selengkapnya tentang model kode Formulir Web, lihat ASP.NET Model Kode Halaman Formulir Web.

<%@ 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>

Contoh terkait berikut menampilkan item yang dipilih dalam contoh sebelumnya.

<%@ 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>

Keterangan

HyperLinkColumn Gunakan tipe kolom dalam DataGrid kontrol untuk membuat hyperlink untuk setiap baris di DataGrid. Atur Text properti untuk menentukan teks keterangan untuk hyperlink. Untuk menentukan URL yang akan ditautkan saat hyperlink diklik, atur NavigateUrl properti .

Catatan

Jika Anda mengatur Text properti dan NavigateUrl , semua hyperlink dalam kolom akan berbagi keterangan dan URL yang sama.

Anda juga bisa mengikat keterangan teks dan URL hyperlink di HyperLinkColumn ke bidang di sumber data alih-alih mengatur Text properti dan NavigateUrl . Ini memungkinkan Anda menampilkan keterangan yang berbeda dan menentukan URL yang berbeda untuk setiap hyperlink di kolom.

DataTextField Gunakan properti untuk menentukan bidang dalam sumber data untuk mengikat ke keterangan teks hyperlink dalam kolom.

Catatan

Properti DataTextField dan Text tidak dapat diatur secara bersamaan. Jika kedua properti diatur, DataTextField properti lebih diutamakan.

Tentukan bidang yang akan diikat ke URL hyperlink dengan mengatur DataNavigateUrlField properti .

Catatan

Properti DataNavigateUrlField dan NavigateUrl tidak dapat diatur secara bersamaan. Jika kedua properti diatur, DataNavigateUrlField properti lebih diutamakan.

Properti Target memungkinkan Anda menentukan jendela atau bingkai untuk menampilkan konten halaman Web yang ditautkan saat hyperlink diklik.

Saat menggunakan pengikatan data, Anda bisa memformat keterangan teks dan URL hyperlink dengan mengatur DataTextFormatString properti dan DataNavigateUrlFormatString .

Perhatian

Kontrol ini dapat digunakan untuk menampilkan input pengguna, yang mungkin menyertakan skrip klien berbahaya. Periksa informasi apa pun yang dikirim dari klien untuk skrip yang dapat dieksekusi, pernyataan SQL, atau kode lain sebelum menampilkannya di aplikasi Anda. Anda dapat menggunakan kontrol validasi untuk memverifikasi input pengguna sebelum menampilkan teks input dalam kontrol. ASP.NET menyediakan fitur validasi permintaan input untuk memblokir skrip dan HTML dalam input pengguna. Untuk informasi selengkapnya, lihat Mengamankan Kontrol Standar, Cara: Melindungi Dari Eksploitasi Skrip di Aplikasi Web dengan Menerapkan Pengodean HTML ke String, dan Memvalidasi Input Pengguna di Halaman Web ASP.NET.

Konstruktor

HyperLinkColumn()

Menginisialisasi instans baru kelas HyperLinkColumn.

Properti

DataNavigateUrlField	Mendapatkan atau mengatur bidang dari sumber data untuk mengikat ke URL hyperlink di HyperLinkColumn.
DataNavigateUrlFormatString	Mendapatkan atau mengatur format tampilan untuk URL hyperlink di HyperLinkColumn saat URL terikat data ke bidang di sumber data.
DataTextField	Mendapatkan atau mengatur bidang dari sumber data untuk mengikat ke keterangan teks hyperlink di HyperLinkColumn.
DataTextFormatString	Mendapatkan atau mengatur format tampilan untuk keterangan teks hyperlink dalam HyperLinkColumn kolom.
DesignMode	Mendapatkan nilai yang menunjukkan apakah kolom berada dalam mode desain. (Diperoleh dari DataGridColumn)
FooterStyle	Mendapatkan properti gaya untuk bagian footer kolom. (Diperoleh dari DataGridColumn)
FooterText	Mendapatkan atau mengatur teks yang ditampilkan di bagian footer kolom. (Diperoleh dari DataGridColumn)
HeaderImageUrl	Mendapatkan atau mengatur lokasi gambar untuk ditampilkan di bagian header kolom. (Diperoleh dari DataGridColumn)
HeaderStyle	Mendapatkan properti gaya untuk bagian header kolom. (Diperoleh dari DataGridColumn)
HeaderText	Mendapatkan atau mengatur teks yang ditampilkan di bagian header kolom. (Diperoleh dari DataGridColumn)
IsTrackingViewState	Mendapatkan nilai yang menentukan apakah DataGridColumn objek ditandai untuk menyimpan statusnya. (Diperoleh dari DataGridColumn)
ItemStyle	Mendapatkan properti gaya untuk sel item kolom. (Diperoleh dari DataGridColumn)
NavigateUrl	Mendapatkan atau mengatur URL yang akan ditautkan saat hyperlink dalam kolom diklik.
Owner	DataGrid Mendapatkan kontrol bahwa kolom adalah anggotanya. (Diperoleh dari DataGridColumn)
SortExpression	Mendapatkan atau mengatur nama bidang atau ekspresi untuk diteruskan ke OnSortCommand(DataGridSortCommandEventArgs) metode saat kolom dipilih untuk pengurutan. (Diperoleh dari DataGridColumn)
Target	Mendapatkan atau mengatur jendela atau bingkai target untuk menampilkan isi halaman Web yang ditautkan saat hyperlink dalam kolom diklik.
Text	Mendapatkan atau mengatur keterangan teks yang akan ditampilkan untuk hyperlink dalam kolom.
ViewState	StateBag Mendapatkan objek yang memungkinkan kolom yang berasal dari DataGridColumn kelas untuk menyimpan propertinya. (Diperoleh dari DataGridColumn)
Visible	Mendapatkan atau mengatur nilai yang menunjukkan apakah kolom terlihat dalam DataGrid kontrol. (Diperoleh dari DataGridColumn)

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FormatDataNavigateUrlValue(Object)	Memformat URL terikat data menggunakan format yang ditentukan oleh DataNavigateUrlFormatString properti .
FormatDataTextValue(Object)	Memformat keterangan teks terikat data menggunakan format yang ditentukan oleh DataTextFormatString properti .
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
Initialize()	Menyediakan implementasi dasar untuk mengatur ulang kolom yang berasal dari DataGridColumn kelas ke status awalnya.
InitializeCell(TableCell, Int32, ListItemType)	Menginisialisasi sel yang mewakili kolom ini dengan hyperlink yang terkandung.
LoadViewState(Object)	Memuat status DataGridColumn objek. (Diperoleh dari DataGridColumn)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
OnColumnChanged()	OnColumnsChanged() Memanggil metode . (Diperoleh dari DataGridColumn)
SaveViewState()	Menyimpan status DataGridColumn objek saat ini. (Diperoleh dari DataGridColumn)
ToString()	Mengembalikan representasi string kolom. (Diperoleh dari DataGridColumn)
TrackViewState()	Menyebabkan pelacakan perubahan status tampilan pada kontrol server sehingga dapat disimpan di objek kontrol StateBag server. (Diperoleh dari DataGridColumn)

Implementasi Antarmuka Eksplisit

IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah kolom melacak perubahan status tampilan. (Diperoleh dari DataGridColumn)
IStateManager.LoadViewState(Object)	Memuat status yang disimpan sebelumnya. (Diperoleh dari DataGridColumn)
IStateManager.SaveViewState()	Mengembalikan objek yang berisi perubahan status. (Diperoleh dari DataGridColumn)
IStateManager.TrackViewState()	Mulai melacak perubahan status. (Diperoleh dari DataGridColumn)

Berlaku untuk

Bagikan melalui

HyperLinkColumn Kelas

Definisi

Contoh

Keterangan

Konstruktor

Properti

Metode

Implementasi Antarmuka Eksplisit

Berlaku untuk

Lihat juga

Sumber Daya Tambahan: