HyperLinkField 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.
Veriye bağlı denetimde köprü olarak görüntülenen bir alanı temsil eder.
public ref class HyperLinkField : System::Web::UI::WebControls::DataControlFieldpublic class HyperLinkField : System.Web.UI.WebControls.DataControlFieldtype HyperLinkField = class
inherit DataControlFieldPublic Class HyperLinkField
Inherits DataControlField- Devralma
Örnekler
Aşağıdaki kod örneği, bir nesnenin bir HyperLinkField denetimde GridView statik köprüler sütununu görüntülemek için 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. Nesne HyperLinkField , 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 .
Not
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 sayede nesnedeki HyperLinkField her köprü için farklı bir resim yazısı görüntüleyebilir ve her köprü farklı bir konuma gidebilir. Alanı açıklamalı alt yazıya 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 alanları virgülle ayrılmış bir listeye 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 HyperLinkField nesneyi gizleyebilirsiniz.
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. Üstbilgi bölümünde metin yerine görüntü görüntülemek için özelliğini ayarlayın HeaderImageUrl . üst bilgi bölümü, özelliği falseolarak ayarlanarak nesnede gizlenebilir.HyperLinkField ShowHeader
Not
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 için ö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 | Description |
|---|---|
| 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
| HyperLinkField() |
HyperLinkField sınıfının yeni bir örneğini başlatır. |
Özellikler
| AccessibleHeaderText |
Bazı denetimlerde özellik değeri olarak |
| Control |
Nesnenin ilişkili olduğu veri denetimine DataControlField başvuru alır. (Devralındığı yer: DataControlField) |
| ControlStyle |
Nesnenin içerdiği DataControlField web sunucusu denetimlerinin stilini alır. (Devralındığı yer: DataControlField) |
| DataNavigateUrlFields |
Nesnedeki köprülerin HyperLinkField URL'lerini oluşturmak için kullanılan veri kaynağından alanların adlarını alır veya ayarlar. |
| DataNavigateUrlFormatString |
Nesnedeki HyperLinkField köprülerin URL'lerinin işlendiği biçimi belirten dizeyi alır veya ayarlar. |
| DataTextField |
Nesnedeki köprü resim 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ülendiği biçimi belirten dizeyi alın veya ayarlar. |
| DesignMode |
Bir veri denetim alanının şu anda bir 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 denetim alanının alt bilgisinin stilini alır veya ayarlar. (Devralındığı yer: DataControlField) |
| FooterText |
Veri denetim alanının alt bilgi öğesinde görüntülenen metni alır veya ayarlar. (Devralındığı yer: DataControlField) |
| HeaderImageUrl |
Bir 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 denetim alanının üst bilgisinin stilini alır veya ayarlar. (Devralındığı yer: DataControlField) |
| HeaderText |
Veri denetim 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ı belirten bir değer alır. (Devralındığı yer: DataControlField) |
| IsTrackingViewState |
Nesnenin DataControlField görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır. (Devralındığı yer: DataControlField) |
| ItemStyle |
Veri denetim 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 gidilen 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 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 kaydetmenizi ve geri yüklemenizi sağlayan durum DataControlField bilgileri sözlüğü alır. (Devralındığı yer: DataControlField) |
| Visible |
Veri denetim alanının işlenip işlenmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: DataControlField) |
Yöntemler
| 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ç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(Boolean, Control) |
HyperLinkField Nesnesini başlatır. |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Nesnedeki bir HyperLinkField hücreyi 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 Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
| OnFieldChanged() |
Olayı tetikler |
| 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ı
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Bu DataControlField nesneyle ilişkili şemayı alır veya ayarlar. (Devralındığı yer: DataControlField) |
| IStateManager.IsTrackingViewState |
Nesnenin DataControlField görünüm durumundaki değişiklikleri 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) |