Udostępnij za pośrednictwem

HyperLinkField.DataTextFormatString Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobierz lub ustawia ciąg określający format wyświetlania podpisów hiperlinków w HyperLinkField obiekcie.

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

Wartość właściwości

String

Ciąg określający format wyświetlania podpisów hiperlinków w obiekcie HyperLinkField . Wartość domyślna to pusty ciąg (""), który wskazuje, że do podpisów hiperlinków nie zastosowano żadnego specjalnego formatowania.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać DataTextFormatString właściwości do formatowania wartości powiązanych z podpisami hiperlinków wyświetlanymi w HyperLinkField obiekcie. Wartości są formatowane jako waluta.


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

Uwagi

DataTextFormatString Użyj właściwości , aby określić niestandardowy format wyświetlania podpisów wyświetlanych w HyperLinkField obiekcie. DataTextFormatString Jeśli właściwość nie jest ustawiona, wartość pola jest wyświetlana bez specjalnego formatowania.

Uwaga

Ciąg formatu jest stosowany tylko wtedy, gdy właściwość jest ustawiona DataTextField .

Ciąg formatu może być dowolnym ciągiem literału i zwykle zawiera symbol zastępczy wartości pola. Na przykład w ciągu formatu "Wartość elementu: {0}" {0} symbol zastępczy jest zastępowany wartością pola, gdy jest wyświetlany w HyperLinkField obiekcie. Pozostała część ciągu formatu jest wyświetlana jako tekst literału.

Uwaga

Jeśli ciąg formatu nie zawiera symbolu zastępczego, wartość pola ze źródła danych nie jest uwzględniona w ostatnim tekście wyświetlania.

Symbol zastępczy składa się z dwóch części oddzielonych dwukropkiem i opakowanych w nawiasy klamrowe w postaci {A:Bxx}. Wartość przed dwukropkiem (A w ogólnym przykładzie) określa indeks wartości pola na liście parametrów opartych na zera.

Uwaga

Ten parametr jest częścią składni formatowania. Ponieważ w każdej komórce istnieje tylko jedna wartość pola, tę wartość można ustawić tylko na wartość 0.

Dwukropek i wartości po dwukropku są opcjonalne. Znak po dwukropku (B w ogólnym przykładzie) określa format, w którym ma być wyświetlana wartość. W poniższej tabeli wymieniono typowe formaty.

Formatuj znak Opis
C Wyświetla wartości liczbowe w formacie waluty.
D Wyświetla wartości liczbowe w formacie dziesiętny.
E Wyświetla wartości liczbowe w formacie naukowym (wykładniczym).
F Wyświetla wartości liczbowe w stałym formacie.
G Wyświetla wartości liczbowe w formacie ogólnym.
N Wyświetla wartości liczbowe w formacie liczbowym.
X Wyświetla wartości liczbowe w formacie szesnastkowym.

Uwaga

Znaki formatu nie są uwzględniane w wielkości liter, z wyjątkiem znaków szesnastkowej, z wyjątkiem Xznaków szesnastkowej w określonym przypadku.

Wartość po znaku formatu (xx w ogólnym przykładzie) określa liczbę cyfr znaczących lub miejsc dziesiętnych do wyświetlenia. Na przykład ciąg formatu "{0:F2}" wyświetla liczbę stałą z dwoma miejscami dziesiętnymi.

Aby uzyskać więcej informacji na temat formatowania ciągów, zobacz Formatting Types (Typy formatowania).

Dotyczy

Zobacz też