HyperLinkField.DataTextFormatString Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämta eller anger strängen som anger i vilket format hyperlänktexterna i ett HyperLinkField objekt ska visas.

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

Egenskapsvärde

String

En sträng som anger i vilket format hyperlänktexterna i en HyperLinkField visas. Standardvärdet är en tom sträng (""), som anger att ingen särskild formatering tillämpas på hyperlänktexterna.

Exempel

I följande kodexempel visas hur du använder DataTextFormatString egenskapen för att formatera de värden som är bundna till hyperlänktexterna som visas i ett HyperLinkField objekt. Värdena formateras som valuta.


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

Kommentarer

Använd egenskapen DataTextFormatString för att ange ett anpassat visningsformat för de bildtexter som visas i HyperLinkField objektet. Om egenskapen DataTextFormatString inte har angetts visas fältets värde utan någon särskild formatering.

Note

Formatsträngen tillämpas endast när egenskapen DataTextField har angetts.

Formatsträngen kan vara valfri literalsträng och innehåller vanligtvis en platshållare för fältets värde. I formatsträngen "Item Value: {0}" {0} ersätts platshållaren till exempel med fältets värde när det visas i HyperLinkField objektet. Resten av formatsträngen visas som literaltext.

Note

Om formatsträngen inte innehåller någon platshållare inkluderas inte fältets värde från datakällan i den slutliga visningstexten.

Platshållaren består av två delar, avgränsade med ett kolon och inslagna i klammerparenteser, i formatet {A:Bxx}. Värdet före kolonet (A i det allmänna exemplet) anger fältvärdets index i en nollbaserad lista med parametrar.

Note

Den här parametern är en del av formateringssyntaxen. Eftersom det bara finns ett fältvärde i varje cell kan det här värdet bara anges till 0.

Kolonet och värdena efter kolonet är valfria. Tecknet efter kolonet (B i det allmänna exemplet) anger i vilket format värdet ska visas. I följande tabell visas de vanliga formaten.

Formattecken Description
C Visar numeriska värden i valutaformat.
D Visar numeriska värden i decimalformat.
E Visar numeriska värden i vetenskapligt (exponentiellt) format.
F Visar numeriska värden i fast format.
G Visar numeriska värden i allmänt format.
N Visar numeriska värden i talformat.
X Visar numeriska värden i hexadecimalt format.

Note

Formattecken är inte skiftlägeskänsliga, förutom X, som visar hexadecimala tecken i det angivna fallet.

Värdet efter formattecknet (xx i det allmänna exemplet) anger antalet signifikanta siffror eller decimaler som ska visas. Formatsträngen "{0:F2}" visar till exempel ett fast punktnummer med två decimaler.

Mer information om formateringssträngar finns i Formateringstyper.

Gäller för

Se även