HyperLinkColumn Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Sütundaki DataGrid her öğe için köprü içeren denetim için bir sütun türü.
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
- Devralma
Örnekler
Aşağıdaki örnekte, ayrı bir sayfaya bağlanan bir HyperLinkColumn oluşturma gösterilmektedir.
Not
Aşağıdaki kod örneği tek dosyalı kod modelini kullanır ve doğrudan arka planda kod dosyasına kopyalandığında düzgün çalışmayabilir. Bu kod örneği, .aspx uzantısına sahip boş bir metin dosyasına kopyalanmalıdır. Web Forms kod modeli hakkında daha fazla bilgi için bkz. Sayfa Kodu Modeli 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>
Aşağıdaki ilgili örnek, önceki örnekte seçilen öğeyi görüntüler.
<%@ 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>
Açıklamalar
Denetimdeki HyperLinkColumn sütun türünü kullanarak içindeki DataGrid her satır DataGridiçin bir köprü oluşturun. Köprü için Text resim yazısı metnini belirtmek için özelliğini ayarlayın. Köprüye tıklandığında bağlanılacak URL'yi belirtmek için özelliğini ayarlayın NavigateUrl .
Not
ve NavigateUrl özelliklerini ayarlarsanızText, sütundaki tüm köprüler aynı resim yazısını ve URL'yi paylaşır.
ayrıca ve NavigateUrl özelliklerini ayarlamak yerine içindeki köprülerin HyperLinkColumn metin başlığını ve URL'sini Text veri kaynağındaki bir alana bağlayabilirsiniz. Bu, farklı bir resim yazısı görüntülemenize ve sütundaki her köprü için farklı bir URL belirtmenize olanak tanır.
Sütundaki köprülerin DataTextField metin başlığına bağlanacak veri kaynağında bir alan belirtmek için özelliğini kullanın.
Not
DataTextField ve Text özellikleri aynı anda ayarlanamaz. Her iki özellik de ayarlanırsa, DataTextField özellik öncelikli olur.
özelliğini ayarlayarak DataNavigateUrlField köprü url'sine bağlanacak alanı belirtin.
Not
DataNavigateUrlField ve NavigateUrl özellikleri aynı anda ayarlanamaz. Her iki özellik de ayarlanırsa, DataNavigateUrlField özellik öncelikli olur.
özelliği, Target köprüye tıklandığında bağlanılan Web sayfası içeriğini görüntülemek için pencereyi veya çerçeveyi belirtmenize olanak tanır.
Veri bağlamayı kullanırken, sırasıyla ve özelliklerini ayarlayarak köprü metni açıklamalı alt yazısını ve DataNavigateUrlFormatString URL'sini DataTextFormatString biçimlendirebilirsiniz.
Dikkat
Bu denetim, kötü amaçlı istemci betiği içerebilecek kullanıcı girişini görüntülemek için kullanılabilir. Uygulamanızda görüntülemeden önce bir istemciden yürütülebilir betik, SQL deyimleri veya başka bir kod için gönderilen tüm bilgileri denetleyin. Denetimde giriş metnini görüntülemeden önce kullanıcı girişini doğrulamak için doğrulama denetimlerini kullanabilirsiniz. ASP.NET, kullanıcı girişinde betiği ve HTML'yi engellemek için bir giriş isteği doğrulama özelliği sağlar. Daha fazla bilgi için bkz. Standart Denetimlerin Güvenliğini Sağlama, Nasıl yapılır: Dizelere HTML Kodlaması Uygulayarak ve ASP.NET Web Sayfalarında Kullanıcı Girişini Doğrulayarak Web Uygulamasında Betik Açıklarından Yararlanmaya Karşı Koruma.
Oluşturucular
HyperLinkColumn() |
HyperLinkColumn sınıfının yeni bir örneğini başlatır. |
Özellikler
DataNavigateUrlField |
Bir veri kaynağından içindeki köprülerin HyperLinkColumnURL'sine bağlanacak alanı alır veya ayarlar. |
DataNavigateUrlFormatString |
URL bir veri kaynağındaki bir alana veri bağlı olduğunda içindeki HyperLinkColumn köprülerin URL'si için görüntüleme biçimini alır veya ayarlar. |
DataTextField |
Veri kaynağındaki alanı, içindeki HyperLinkColumnköprülerin metin başlığına bağlanacak şekilde alır veya ayarlar. |
DataTextFormatString |
Sütundaki köprülerin HyperLinkColumn metin başlığı için görüntüleme biçimini alır veya ayarlar. |
DesignMode |
Sütunun tasarım modunda olup olmadığını gösteren bir değer alır. (Devralındığı yer: DataGridColumn) |
FooterStyle |
Sütunun alt bilgi bölümünün stil özelliklerini alır. (Devralındığı yer: DataGridColumn) |
FooterText |
Sütunun alt bilgi bölümünde görüntülenen metni alır veya ayarlar. (Devralındığı yer: DataGridColumn) |
HeaderImageUrl |
Sütunun üst bilgi bölümünde görüntülenecek görüntünün konumunu alır veya ayarlar. (Devralındığı yer: DataGridColumn) |
HeaderStyle |
Sütunun üst bilgi bölümünün stil özelliklerini alır. (Devralındığı yer: DataGridColumn) |
HeaderText |
Sütunun üst bilgi bölümünde görüntülenen metni alır veya ayarlar. (Devralındığı yer: DataGridColumn) |
IsTrackingViewState |
Nesnenin DataGridColumn durumunu kaydetmek için işaretlenip işaretlenmediğini belirleyen bir değer alır. (Devralındığı yer: DataGridColumn) |
ItemStyle |
Sütunun öğe hücrelerinin stil özelliklerini alır. (Devralındığı yer: DataGridColumn) |
NavigateUrl |
Sütundaki bir köprüye tıklandığında bağlanacak URL'yi alır veya ayarlar. |
Owner |
Sütunun DataGrid üyesi olduğu denetimi alır. (Devralındığı yer: DataGridColumn) |
SortExpression |
Sıralama için bir sütun seçildiğinde yöntemine geçirilmesi için alanın veya ifadenin OnSortCommand(DataGridSortCommandEventArgs) adını alır veya ayarlar. (Devralındığı yer: DataGridColumn) |
Target |
Sütundaki köprüye tıklandığında bağlanılan Web sayfası içeriğini görüntülemek için hedef pencereyi veya çerçeveyi alır veya ayarlar. |
Text |
Sütundaki köprüler için görüntülenecek metin başlığını alır veya ayarlar. |
ViewState |
sınıfından StateBag türetilmiş bir sütunun DataGridColumn özelliklerini depolamasına izin veren nesnesini alır. (Devralındığı yer: DataGridColumn) |
Visible |
Sütunun denetimde DataGrid görünür olup olmadığını gösteren bir değer alır veya ayarlar. (Devralındığı yer: DataGridColumn) |
Yöntemler
Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
FormatDataNavigateUrlValue(Object) |
Veriye bağlı URL'yi özelliği tarafından belirtilen biçimi kullanarak biçimlendirin DataNavigateUrlFormatString . |
FormatDataTextValue(Object) |
Veriye bağlı metin başlığını özelliği tarafından belirtilen biçimi kullanarak biçimlendirilir DataTextFormatString . |
GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
Initialize() |
sınıfından türetilen DataGridColumn bir sütunu ilk durumuna sıfırlamak için temel uygulamayı sağlar. |
InitializeCell(TableCell, Int32, ListItemType) |
Bu sütunu temsil eden hücreyi kapsanan köprüyle başlatır. |
LoadViewState(Object) |
Nesnenin DataGridColumn durumunu yükler. (Devralındığı yer: DataGridColumn) |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
OnColumnChanged() |
OnColumnsChanged() yöntemini çağırır. (Devralındığı yer: DataGridColumn) |
SaveViewState() |
Nesnenin geçerli durumunu DataGridColumn kaydeder. (Devralındığı yer: DataGridColumn) |
ToString() |
Sütunun dize gösterimini döndürür. (Devralındığı yer: DataGridColumn) |
TrackViewState() |
Sunucu denetiminin nesnesinde depolanabilmeleri için sunucu StateBag denetiminde görünüm durumu değişikliklerinin izlenmesine neden olur. (Devralındığı yer: DataGridColumn) |
Belirtik Arabirim Kullanımları
IStateManager.IsTrackingViewState |
Sütunun görünüm durumunun değişikliklerini izleyip izlemediğini gösteren bir değer alır. (Devralındığı yer: DataGridColumn) |
IStateManager.LoadViewState(Object) |
Önceden kaydedilmiş durumu yükler. (Devralındığı yer: DataGridColumn) |
IStateManager.SaveViewState() |
Durum değişikliklerini içeren bir nesne döndürür. (Devralındığı yer: DataGridColumn) |
IStateManager.TrackViewState() |
Durum değişikliklerini izlemeye başlar. (Devralındığı yer: DataGridColumn) |
Şunlara uygulanır
Ayrıca bkz.
- DataGridColumn
- DataGridColumnCollection
- DataGrid
- HyperLink
- BoundColumn
- ButtonColumn
- EditCommandColumn
- TemplateColumn
- Standart Denetimlerin Güvenliğini Sağlama
- Nasıl yapılır: Dizelere HTML Kodlaması Uygulayarak Bir Web Uygulamasında Betik Açıklarından Korunma
- ASP.NET Web Sayfalarında Kullanıcı Girişini Doğrulamaya Giriş
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin