HyperLinkField Sınıf

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.

Veriye bağlı denetimde köprü olarak görüntülenen bir alanı temsil eder.

public ref class HyperLinkField : System::Web::UI::WebControls::DataControlField

public class HyperLinkField : System.Web.UI.WebControls.DataControlField

type HyperLinkField = class
    inherit DataControlField

Public Class HyperLinkField
Inherits DataControlField

Devralma: Object

DataControlField
HyperLinkField

Örnekler

Aşağıdaki kod örneği, bir HyperLinkField denetimde GridView statik köprüler sütununu görüntülemek için bir nesnenin nasıl kullanılacağını gösterir. Nesnedeki HyperLinkField her köprü sırasıyla ve özellikleri tarafından belirtilen aynı resim yazısını ve NavigateUrl gezinti URL'sini Text paylaşır.


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

Aşağıdaki kod örneği, bir HyperLinkField nesnenin veri kaynağındaki alanlara nasıl bağlanacağını gösterir. DataTextField ve DataNavigateUrlFields özellikleri, nesnede görüntülenen her köprü için sırasıyla resim yazısına ve gezinti URL'sine HyperLinkField bağlanacak alanları belirtmek için kullanılır.


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

Açıklamalar

sınıfıHyperLinkField, görüntülenen her kayıt için bir köprü görüntülemek üzere veriye bağlı denetimler (ve DetailsViewgibiGridView) tarafından kullanılır. Kullanıcı bir köprüye tıkladığında, köprüyle ilişkili Web sayfasına yönlendirilir. HyperLinkField Nesne, kullanıldığı veriye bağlı denetime bağlı olarak farklı şekilde görüntülenir. Örneğin, GridView denetim bir HyperLinkField nesneyi sütun olarak görüntülerken DetailsView , denetim bunu satır olarak görüntüler.

Köprüler için görüntülenecek resim yazısını belirtmek için özelliğini kullanın Text . Köprü tıklatıldığında NavigateUrl gidilmesi gereken URL'yi belirtmek için özelliğini kullanın. Bağlı içeriği belirli bir pencerede veya çerçevede görüntülemek istiyorsanız özelliğini ayarlayın Target .

Uyarı

Text ve NavigateUrl özellikleri ayarlandığında, nesnedeki HyperLinkField tüm köprüler aynı resim yazısını ve gezinti URL'sini paylaşır. Benzer şekilde, Target özelliği tüm köprüler için de geçerlidir.

Alternatif olarak, nesneyi bir veri kaynağındaki alanlara bağlayabilirsiniz HyperLinkField . Bu, nesnedeki her köprü için farklı bir resim yazısı görüntülemenize ve her köprüye HyperLinkField farklı bir konuma gitmelerini sağlar. Bir alanı resim yazısına bağlamak için özelliğini ayarlayın DataTextField . Gezinti url'si oluşturmak için özelliğini, URL'yi oluşturmak için kullanılacak virgülle ayrılmış bir alan listesi olarak ayarlayın DataNavigateUrlFields .

sırasıyla ve DataNavigateUrlFormatString özelliklerini ayarlayarak DataTextFormatString resim yazıları ve gezinti URL'leri için özel bir biçim belirtebilirsiniz.

özelliğini falseolarak ayarlayarak veriye bağlı denetimdeki Visible bir nesneyi gizleyebilirsinizHyperLinkField.

Bir nesnenin üst bilgi ve alt bilgi bölümlerini HyperLinkField özelleştirebilirsiniz. Üst bilgi veya alt bilgi bölümlerinde resim yazısı görüntülemek için sırasıyla veya FooterText özelliklerini ayarlayınHeaderText. Metin yerine üst bilgi bölümünde görüntü görüntülemek için özelliğini ayarlayın HeaderImageUrl . Üst bilgi bölümü, özelliği falseolarak ayarlanarak nesnede HyperLinkField gizlenebilirShowHeader.

Uyarı

Bazı verilere bağlı denetimler (denetim gibi) denetimin GridView yalnızca üst bilgi bölümünün tamamını gösterebilir veya gizleyebilir. Bu veriye bağlı denetimler, tek bir bağlı alanın özelliğini desteklemez ShowHeader . Veriye bağlı denetimin üst bilgi bölümünün tamamını göstermek veya gizlemek için denetimin ShowHeader özelliğini kullanın (varsa).

Ayrıca, alanın farklı bölümleri için stil özelliklerini ayarlayarak nesnenin HyperLinkField görünümünü özelleştirebilirsiniz (yazı tipi rengi, arka plan rengi vb.). Aşağıdaki tabloda farklı stil özellikleri listeılmıştır.

Style özelliği	Açıklama
ControlStyle	Nesnenin alt Web sunucusu denetimleri HyperLinkField için stil ayarları.
FooterStyle	Nesnenin alt bilgi bölümünün HyperLinkField stil ayarları.
HeaderStyle	Nesnenin üst bilgi bölümünün HyperLinkField stil ayarları.
ItemStyle	Nesnedeki veri öğelerinin HyperLinkField stil ayarları.

Oluşturucular

Name	Description
HyperLinkField()	HyperLinkField sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
AccessibleHeaderText	Bazı denetimlerde özellik değeri olarak `AbbreviatedText` işlenen metni alır veya ayarlar. (Devralındığı yer: DataControlField)
Control	Nesnenin ilişkili olduğu veri denetimine DataControlField başvuru alır. (Devralındığı yer: DataControlField)
ControlStyle	Nesnenin DataControlField içerdiği tüm Web sunucusu denetimlerinin stilini alır. (Devralındığı yer: DataControlField)
DataNavigateUrlFields	Nesnedeki köprüler HyperLinkField için URL'leri oluşturmak için kullanılan veri kaynağından alanların adlarını alır veya ayarlar.
DataNavigateUrlFormatString	Bir HyperLinkField nesnedeki köprüler için URL'lerin işlendiği biçimi belirten dizeyi alır veya ayarlar.
DataTextField	Nesnedeki köprü açıklamalı alt yazıları HyperLinkField için görüntülenecek metni içeren veri kaynağından alanın adını alır veya ayarlar.
DataTextFormatString	Nesnedeki HyperLinkField köprü açıklamalı alt yazılarının görüntüleneceği biçimi belirten dizeyi alın veya ayarlar.
DesignMode	Bir veri denetimi alanının şu anda tasarım zamanı ortamında görüntülenip görüntülenmediğini belirten bir değer alır. (Devralındığı yer: DataControlField)
FooterStyle	Veri denetimi alanının alt bilgisinin stilini alır veya ayarlar. (Devralındığı yer: DataControlField)
FooterText	Veri denetimi alanının alt bilgi öğesinde görüntülenen metni alır veya ayarlar. (Devralındığı yer: DataControlField)
HeaderImageUrl	Veri denetimi alanının üst bilgi öğesinde görüntülenen görüntünün URL'sini alır veya ayarlar. (Devralındığı yer: DataControlField)
HeaderStyle	Veri denetimi alanının üst bilgisinin stilini alır veya ayarlar. (Devralındığı yer: DataControlField)
HeaderText	Veri denetimi alanının üst bilgi öğesinde görüntülenen metni alır veya ayarlar. (Devralındığı yer: DataControlField)
InsertVisible	Üst veri bağlı denetimi ekleme modundayken nesnenin DataControlField görünür olup olmadığını gösteren bir değer alır. (Devralındığı yer: DataControlField)
IsTrackingViewState	Nesnenin DataControlField değişiklikleri görünüm durumuna kaydedip kaydetmediğini belirten bir değer alır. (Devralındığı yer: DataControlField)
ItemStyle	Veri denetimi alanı tarafından görüntülenen metin tabanlı içeriğin stilini alır. (Devralındığı yer: DataControlField)
NavigateUrl	Nesnedeki bir köprüye tıklandığında gidecek URL'yi HyperLinkField alır veya ayarlar.
ShowHeader	Veri denetim alanının üst bilgi öğesinin işlenip işlenmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: DataControlField)
SortExpression	Verileri sıralamak için bir veri kaynağı denetimi tarafından kullanılan bir sıralama ifadesi alır veya ayarlar. (Devralındığı yer: DataControlField)
Target	Nesnedeki bir köprüye HyperLinkField tıklandığında web sayfasının bağlandığı hedef pencereyi veya çerçeveyi alır veya ayarlar.
Text	Nesnedeki her köprü HyperLinkField için görüntülenecek metni alır veya ayarlar.
ValidateRequestMode	Denetimin istemci girişini doğrulayıp doğrulamadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: DataControlField)
ViewState	Aynı sayfa için birden çok istekte bir nesnenin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum DataControlField bilgileri sözlüğü alır. (Devralındığı yer: DataControlField)
Visible	Veri denetimi alanının işlenip işlenmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: DataControlField)

Yöntemler

Name	Description
CloneField()	Geçerli DataControlFieldtüretilmiş nesnenin yinelenen bir kopyasını oluşturur. (Devralındığı yer: DataControlField)
CopyProperties(DataControlField)	Geçerli HyperLinkField nesnenin özelliklerini belirtilen nesneye kopyalar.
CreateField()	Sınıfının yeni bir örneğini HyperLinkField döndürür.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Geçerli tablo hücresinden veri denetimi alanının değerini ayıklar ve değeri belirtilen IDictionary koleksiyona ekler. (Devralındığı yer: DataControlField)
FormatDataNavigateUrlValue(Object[])	Özelliği tarafından belirtilen biçim dizesini kullanarak gezinti URL'sini biçimlendirin DataNavigateUrlFormatString .
FormatDataTextValue(Object)	Özelliği tarafından belirtilen biçim dizesini kullanarak resim yazısı metnini biçimlendirilir DataTextFormatString .
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
Initialize(Boolean, Control)	Nesnesini başlatır HyperLinkField .
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Nesnedeki bir hücreyi HyperLinkField başlatır.
LoadViewState(Object)	Veri kaynağı görünümünün daha önce kaydedilmiş görünüm durumunu geri yükler. (Devralındığı yer: DataControlField)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
OnFieldChanged()	Olayı tetikler `FieldChanged` . (Devralındığı yer: DataControlField)
SaveViewState()	Sayfanın sunucuya DataControlField geri gönderildiği zamandan bu yana görünüm durumunda yapılan değişiklikleri kaydeder. (Devralındığı yer: DataControlField)
ToString()	Bu DataControlField nesneyi temsil eden bir dize döndürür. (Devralındığı yer: DataControlField)
TrackViewState()	Nesnenin görünüm durumundaki DataControlField değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState özelliğinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir. (Devralındığı yer: DataControlField)
ValidateSupportsCallback()	Nesnenin içerdiği denetimlerin geri çağırmaları desteklediğini HyperLinkField gösterir.

Belirtik Arabirim Kullanımları

Name	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Bu DataControlField nesneyle ilişkili şemayı alır veya ayarlar. (Devralındığı yer: DataControlField)
IStateManager.IsTrackingViewState	Nesnenin DataControlField değişiklikleri görünüm durumuna kaydedip kaydetmediğini belirten bir değer alır. (Devralındığı yer: DataControlField)
IStateManager.LoadViewState(Object)	Veri denetimi alanının daha önce kaydedilmiş görünüm durumunu geri yükler. (Devralındığı yer: DataControlField)
IStateManager.SaveViewState()	Sayfanın sunucuya DataControlField geri gönderildiği zamandan bu yana görünüm durumunda yapılan değişiklikleri kaydeder. (Devralındığı yer: DataControlField)
IStateManager.TrackViewState()	Nesnenin görünüm durumundaki DataControlField değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState özelliğinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir. (Devralındığı yer: DataControlField)

Şunlara uygulanır

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?