Aracılığıyla paylaş


HyperLinkColumn Sınıf

Tanım

Denetim için sütundaki DataGrid her öğe için köprü içeren 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
HyperLinkColumn

Örnekler

Aşağıdaki örnekte, ayrı bir sayfaya bağlanan bir HyperLinkColumn öğesinin nasıl oluşturulacağı 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. ASP.NET Web Forms Sayfa Kodu Modeli.

<%@ 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 karşılık gelen ö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ü tıklatıldığında bağlanılacak URL'yi belirtmek için özelliğini ayarlayın NavigateUrl .

Not

ve NavigateUrl özelliklerini ayarlarsanız Text 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ğlanmak üzere 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 özelliği DataTextField ö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 özelliği DataNavigateUrlField öncelikli olur.

özelliği, Target köprü tıklatıldığında web sayfası içeriğinin görüntüleneceği pencereyi veya çerçeveyi belirtmenize olanak tanır.

Veri bağlamayı kullanırken, sırasıyla ve DataNavigateUrlFormatString özelliklerini ayarlayarak köprü metni resim yazısını ve 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 istemciden yürütülebilir betik, SQL deyimleri veya başka kodlar 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 Web Uygulamasında Betik Açıklarına Karşı Koruma ve ASP.NET Web Sayfalarında Kullanıcı Girişini Doğrulama.

Oluşturucular

HyperLinkColumn()

HyperLinkColumn sınıfının yeni bir örneğini başlatır.

Özellikler

DataNavigateUrlField

Veri kaynağındaki alanı, içindeki HyperLinkColumnköprülerin URL'sine bağlanacak şekilde 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ğlanılacak 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üretilen 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çimlendirilir DataNavigateUrlFormatString .

FormatDataTextValue(Object)

Veriye bağlı metin başlığını özelliği tarafından belirtilen biçimi kullanarak biçimlendirin 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 denetiminde görünüm durumu değişikliklerinin izlenmesine StateBag neden olur.

(Devralındığı yer: DataGridColumn)

Belirtik Arabirim Kullanımları

IStateManager.IsTrackingViewState

Sütunun görünüm durumunun değişikliklerini izlediğini gösteren bir değer alır.

(Devralındığı yer: DataGridColumn)
IStateManager.LoadViewState(Object)

Daha önce 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.