HyperLinkColumn Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Ö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: Object

DataGridColumn
HyperLinkColumn

Ö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