Aracılığıyla paylaş

HyperLinkField.DataTextFormatString Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Nesnedeki HyperLinkField köprü açıklamalı alt yazılarının görüntülendiği biçimi belirten dizeyi alın veya ayarlar.

public:
 virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataTextFormatString { get; set; }
member this.DataTextFormatString : string with get, set
Public Overridable Property DataTextFormatString As String

Özellik Değeri

String

içindeki köprü açıklamalı alt yazılarının görüntülendiği biçimi belirten dize HyperLinkField . Varsayılan değer, köprü açıklamalı alt yazılarına özel biçimlendirme uygulanmadığını gösteren boş bir dizedir ("").

Örnekler

Aşağıdaki kod örneği, bir nesnede DataTextFormatString görüntülenen köprü açıklamalı alt yazılarına bağlı değerleri biçimlendirmek için özelliğinin nasıl kullanılacağını HyperLinkField gösterir. Değerler para birimi olarak biçimlendirilir.


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

nesnesinde DataTextFormatString görüntülenen HyperLinkField resim yazıları için özel bir görüntü biçimi belirtmek için özelliğini kullanın. DataTextFormatString Özellik ayarlanmamışsa, alanın değeri herhangi bir özel biçimlendirme olmadan görüntülenir.

Not

Biçim dizesi yalnızca DataTextField özellik ayarlandığında uygulanır.

Biçim dizesi herhangi bir değişmez değer dizesi olabilir ve genellikle alanın değeri için bir yer tutucu içerir. Örneğin, "Öğe Değeri: {0}" biçim dizesinde yer tutucu, {0} nesnede HyperLinkField görüntülendiğinde alanın değeriyle değiştirilir. Biçim dizesinin geri kalanı değişmez metin olarak görüntülenir.

Not

Biçim dizesi yer tutucu içermiyorsa, alanın veri kaynağındaki değeri son görüntüleme metnine dahil değildir.

Yer tutucu, iki nokta üst üste ile ayrılmış ve {A:Bxx} biçiminde küme ayraçları içinde sarmalanmış iki bölümden oluşur. İki nokta üst üste işaretinden önceki değer (A genel örnekte) alan değerinin dizinini sıfır tabanlı bir parametre listesinde belirtir.

Not

Bu parametre biçimlendirme söz diziminin bir parçasıdır. Her hücrede yalnızca bir alan değeri olduğundan, bu değer yalnızca 0 olarak ayarlanabilir.

İki nokta üst üste ve iki nokta üst üsteden sonraki değerler isteğe bağlıdır. İki nokta üst üste işaretinden sonraki karakter (B genel örnekte) değerin görüntüleneceği biçimi belirtir. Aşağıdaki tabloda ortak biçimler listelenmektedir.

Karakter biçimlendirme Açıklama
C Sayısal değerleri para birimi biçiminde görüntüler.
D Sayısal değerleri ondalık biçimde görüntüler.
E Sayısal değerleri bilimsel (üstel) biçimde görüntüler.
F Sayısal değerleri sabit biçimde görüntüler.
G Sayısal değerleri genel biçimde görüntüler.
N Sayısal değerleri sayı biçiminde görüntüler.
X Sayısal değerleri onaltılık biçimde görüntüler.

Not

Biçim karakterleri, belirtilen durumda onaltılık karakterleri görüntüleyen dışında Xbüyük/küçük harfe duyarlı değildir.

Biçim karakterinden sonraki değer (xx genel örnekte) görüntülenecek anlamlı basamak veya ondalık basamak sayısını belirtir. Örneğin, "{0:F2}" biçim dizesi iki ondalık basamaklı sabit noktalı bir sayı görüntüler.

Dizeleri biçimlendirme hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.

Şunlara uygulanır

Ayrıca bkz.