HyperLinkField Kelas
Definisi
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.
Mewakili bidang yang ditampilkan sebagai hyperlink dalam kontrol terikat data.
public ref class HyperLinkField : System::Web::UI::WebControls::DataControlFieldpublic class HyperLinkField : System.Web.UI.WebControls.DataControlFieldtype HyperLinkField = class
inherit DataControlFieldPublic Class HyperLinkField
Inherits DataControlField- Warisan
Contoh
Contoh kode berikut menunjukkan cara menggunakan HyperLinkField objek untuk menampilkan kolom hyperlink statis dalam GridView kontrol. Setiap hyperlink dalam HyperLinkField objek berbagi keterangan dan URL navigasi yang sama yang ditentukan oleh Text properti dan 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>
Contoh kode berikut menunjukkan cara mengikat HyperLinkField objek ke bidang di sumber data. Properti DataTextField dan DataNavigateUrlFields digunakan untuk menentukan bidang yang akan diikat ke keterangan dan URL navigasi, masing-masing, dari setiap hyperlink yang ditampilkan dalam HyperLinkField objek.
<%@ 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>
Keterangan
Kelas HyperLinkField digunakan oleh kontrol terikat data (seperti GridView dan DetailsView) untuk menampilkan hyperlink untuk setiap rekaman yang ditampilkan. Saat pengguna mengklik hyperlink, mereka diarahkan ke halaman Web yang terkait dengan hyperlink. Objek HyperLinkField ditampilkan secara berbeda tergantung pada kontrol terikat data tempat objek digunakan. Misalnya, GridView kontrol menampilkan HyperLinkField objek sebagai kolom, sementara DetailsView kontrol menampilkannya sebagai baris.
Untuk menentukan keterangan yang akan ditampilkan untuk hyperlink, gunakan Text properti . NavigateUrl Gunakan properti untuk menentukan URL yang akan dinavigasi saat hyperlink diklik. Jika Anda ingin menampilkan konten tertaut di jendela atau bingkai tertentu, atur Target properti .
Nota
Text Saat properti dan NavigateUrl diatur, semua hyperlink dalam HyperLinkField objek berbagi keterangan dan URL navigasi yang sama. Demikian juga, Target properti juga berlaku untuk semua hyperlink.
Atau, Anda dapat mengikat objek ke HyperLinkField bidang di sumber data. Ini memungkinkan Anda menampilkan keterangan yang berbeda untuk setiap hyperlink dalam HyperLinkField objek dan meminta setiap hyperlink menavigasi ke lokasi yang berbeda. Untuk mengikat bidang ke keterangan, atur DataTextField properti . Untuk membuat URL untuk navigasi, atur DataNavigateUrlFields properti ke daftar bidang yang dipisahkan koma untuk digunakan untuk membuat URL.
Anda dapat menentukan format kustom untuk keterangan dan URL navigasi dengan mengatur DataTextFormatString properti dan DataNavigateUrlFormatString .
Anda dapat menyembunyikan HyperLinkField objek dalam kontrol terikat data dengan mengatur Visible properti ke false.
Anda dapat mengkustomisasi HyperLinkField bagian header dan footer objek. Untuk menampilkan keterangan di bagian header atau footer, atur HeaderText properti atau FooterText . Untuk menampilkan gambar di bagian header, bukan teks, atur HeaderImageUrl properti . Bagian header dapat disembunyikan dalam HyperLinkField objek dengan mengatur ShowHeader properti ke false.
Nota
Beberapa kontrol terikat data (seperti GridView kontrol) hanya dapat menampilkan atau menyembunyikan seluruh bagian header kontrol. Kontrol terikat data ini tidak mendukung ShowHeader properti untuk bidang terikat individual. Untuk memperlihatkan atau menyembunyikan seluruh bagian header kontrol terikat data, gunakan properti kontrol ShowHeader (jika tersedia).
Anda juga dapat menyesuaikan tampilan HyperLinkField objek (warna font, warna latar belakang, dan sebagainya) dengan mengatur properti gaya untuk berbagai bagian bidang. Tabel berikut ini mencantumkan properti gaya yang berbeda.
| Properti gaya | Deskripsi |
|---|---|
| ControlStyle | Pengaturan gaya untuk kontrol server Web anak objek HyperLinkField . |
| FooterStyle | Pengaturan gaya untuk bagian HyperLinkField footer objek. |
| HeaderStyle | Pengaturan gaya untuk bagian HyperLinkField header objek. |
| ItemStyle | Pengaturan gaya untuk item data dalam HyperLinkField objek. |
Konstruktor
| Nama | Deskripsi |
|---|---|
| HyperLinkField() |
Menginisialisasi instans baru dari kelas HyperLinkField. |
Properti
| Nama | Deskripsi |
|---|---|
| AccessibleHeaderText |
Mendapatkan atau mengatur teks yang dirender sebagai |
| Control |
Mendapatkan referensi ke kontrol data yang DataControlField terkait dengan objek. (Diperoleh dari DataControlField) |
| ControlStyle |
Mendapatkan gaya kontrol server Web apa pun yang terkandung oleh DataControlField objek. (Diperoleh dari DataControlField) |
| DataNavigateUrlFields |
Mendapatkan atau mengatur nama bidang dari sumber data yang digunakan untuk membuat URL untuk hyperlink dalam HyperLinkField objek. |
| DataNavigateUrlFormatString |
Mendapatkan atau mengatur string yang menentukan format di mana URL untuk hyperlink dalam objek dirender HyperLinkField . |
| DataTextField |
Mendapatkan atau mengatur nama bidang dari sumber data yang berisi teks yang akan ditampilkan untuk keterangan hyperlink dalam HyperLinkField objek. |
| DataTextFormatString |
Mendapatkan atau mengatur string yang menentukan format di mana keterangan hyperlink dalam HyperLinkField objek ditampilkan. |
| DesignMode |
Mendapatkan nilai yang menunjukkan apakah bidang kontrol data saat ini dilihat di lingkungan waktu desain. (Diperoleh dari DataControlField) |
| FooterStyle |
Mendapatkan atau mengatur gaya footer bidang kontrol data. (Diperoleh dari DataControlField) |
| FooterText |
Mendapatkan atau mengatur teks yang ditampilkan dalam item footer bidang kontrol data. (Diperoleh dari DataControlField) |
| HeaderImageUrl |
Mendapatkan atau mengatur URL gambar yang ditampilkan di item header bidang kontrol data. (Diperoleh dari DataControlField) |
| HeaderStyle |
Mendapatkan atau mengatur gaya header bidang kontrol data. (Diperoleh dari DataControlField) |
| HeaderText |
Mendapatkan atau mengatur teks yang ditampilkan di item header bidang kontrol data. (Diperoleh dari DataControlField) |
| InsertVisible |
Mendapatkan nilai yang menunjukkan apakah DataControlField objek terlihat ketika kontrol terikat data induknya berada dalam mode sisipkan. (Diperoleh dari DataControlField) |
| IsTrackingViewState |
Mendapatkan nilai yang menunjukkan apakah DataControlField objek menyimpan perubahan pada status tampilannya. (Diperoleh dari DataControlField) |
| ItemStyle |
Mendapatkan gaya konten berbasis teks apa pun yang ditampilkan oleh bidang kontrol data. (Diperoleh dari DataControlField) |
| NavigateUrl |
Mendapatkan atau mengatur URL yang akan dinavigasi saat hyperlink dalam objek diklik HyperLinkField . |
| ShowHeader |
Mendapatkan atau mengatur nilai yang menunjukkan apakah item header bidang kontrol data dirender. (Diperoleh dari DataControlField) |
| SortExpression |
Mendapatkan atau mengatur ekspresi pengurutan yang digunakan oleh kontrol sumber data untuk mengurutkan data. (Diperoleh dari DataControlField) |
| Target |
Mendapatkan atau mengatur jendela target atau bingkai untuk menampilkan halaman Web yang ditautkan saat hyperlink dalam objek diklik HyperLinkField . |
| Text |
Mendapatkan atau mengatur teks yang akan ditampilkan untuk setiap hyperlink dalam HyperLinkField objek. |
| ValidateRequestMode |
Mendapatkan atau menetapkan nilai yang menentukan apakah kontrol memvalidasi input klien. (Diperoleh dari DataControlField) |
| ViewState |
Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status DataControlField tampilan objek di beberapa permintaan untuk halaman yang sama. (Diperoleh dari DataControlField) |
| Visible |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah bidang kontrol data dirender. (Diperoleh dari DataControlField) |
Metode
| Nama | Deskripsi |
|---|---|
| CloneField() |
Membuat salinan duplikat dari objek -turunan saat ini DataControlField. (Diperoleh dari DataControlField) |
| CopyProperties(DataControlField) |
Menyalin properti objek saat ini HyperLinkField ke objek yang ditentukan. |
| CreateField() |
Mengembalikan instans HyperLinkField baru kelas. |
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Mengekstrak nilai bidang kontrol data dari sel tabel saat ini dan menambahkan nilai ke koleksi yang ditentukan IDictionary . (Diperoleh dari DataControlField) |
| FormatDataNavigateUrlValue(Object[]) |
Memformat URL navigasi menggunakan string format yang ditentukan oleh DataNavigateUrlFormatString properti . |
| FormatDataTextValue(Object) |
Memformat teks keterangan menggunakan string format yang ditentukan oleh DataTextFormatString properti . |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetType() |
Mendapatkan Type instans saat ini. (Diperoleh dari Object) |
| Initialize(Boolean, Control) |
Menginisialisasi objek HyperLinkField. |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Menginisialisasi sel dalam HyperLinkField objek. |
| LoadViewState(Object) |
Memulihkan status tampilan sumber data yang sebelumnya disimpan. (Diperoleh dari DataControlField) |
| MemberwiseClone() |
Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object) |
| OnFieldChanged() |
Menaikkan |
| SaveViewState() |
Menyimpan perubahan yang dibuat pada DataControlField status tampilan sejak halaman diposting kembali ke server. (Diperoleh dari DataControlField) |
| ToString() |
Mengembalikan string yang mewakili objek ini DataControlField . (Diperoleh dari DataControlField) |
| TrackViewState() |
DataControlField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan disimpan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari DataControlField) |
| ValidateSupportsCallback() |
Menunjukkan bahwa kontrol yang dimuat oleh HyperLinkField panggilan balik dukungan objek. |
Implementasi Antarmuka Eksplisit
| Nama | Deskripsi |
|---|---|
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Mendapatkan atau mengatur skema yang terkait dengan objek ini DataControlField . (Diperoleh dari DataControlField) |
| IStateManager.IsTrackingViewState |
Mendapatkan nilai yang menunjukkan apakah DataControlField objek menyimpan perubahan pada status tampilannya. (Diperoleh dari DataControlField) |
| IStateManager.LoadViewState(Object) |
Memulihkan status tampilan yang disimpan sebelumnya di bidang kontrol data. (Diperoleh dari DataControlField) |
| IStateManager.SaveViewState() |
Menyimpan perubahan yang dibuat pada DataControlField status tampilan sejak halaman diposting kembali ke server. (Diperoleh dari DataControlField) |
| IStateManager.TrackViewState() |
DataControlField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan disimpan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari DataControlField) |
