Sdílet prostřednictvím

HyperLinkField.DataTextFormatString Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví řetězec, který určuje formát, ve kterém se zobrazují titulky hypertextových odkazů v objektu HyperLinkField .

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

Hodnota vlastnosti

String

Řetězec, který určuje formát, ve kterém jsou zobrazeny titulky hypertextových odkazů v .HyperLinkField Výchozí hodnota je prázdný řetězec (""), který označuje, že u titulků hypertextových odkazů není použito žádné zvláštní formátování.

Příklady

Následující příklad kódu ukazuje, jak pomocí DataTextFormatString vlastnosti formátovat hodnoty vázané na titulky hypertextového odkazu zobrazené v objektu HyperLinkField . Hodnoty jsou formátované jako měna.


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

Poznámky

DataTextFormatString Pomocí vlastnosti určete vlastní formát zobrazení titulků zobrazených v objektuHyperLinkField. DataTextFormatString Pokud vlastnost není nastavená, zobrazí se hodnota pole bez speciálního formátování.

Poznámka

Formátovací řetězec se použije pouze při DataTextField nastavení vlastnosti .

Formátovací řetězec může být libovolný řetězec literálu a obvykle obsahuje zástupný symbol pro hodnotu pole. Například ve formátovacím řetězci "Item Value: {0}" {0} je zástupný symbol nahrazen hodnotou pole, když se zobrazí v objektu HyperLinkField . Zbytek formátovaného řetězce se zobrazí jako literálový text.

Poznámka

Pokud formátovací řetězec neobsahuje zástupný symbol, hodnota pole ze zdroje dat se do konečného zobrazovaného textu nezahrne.

Zástupný symbol se skládá ze dvou částí oddělených dvojtečkami a zabalených ve složených závorkách ve tvaru {A:Bxx}. Hodnota před dvojtečka (A v obecném příkladu) určuje index hodnoty pole v seznamu parametrů od nuly.

Poznámka

Tento parametr je součástí syntaxe formátování. Vzhledem k tomu, že v každé buňce je jenom jedna hodnota pole, dá se tato hodnota nastavit jenom na 0.

Dvojtečka a hodnoty za dvojtečkami jsou volitelné. Znak za dvojtečka (B v obecném příkladu) určuje formát, ve kterém se má hodnota zobrazit. Následující tabulka obsahuje seznam běžných formátů.

Formát znaku Description
C Zobrazí číselné hodnoty ve formátu měny.
D Zobrazí číselné hodnoty v desítkovém formátu.
E Zobrazí číselné hodnoty ve vědeckém (exponenciálním) formátu.
F Zobrazí číselné hodnoty v pevném formátu.
G Zobrazí číselné hodnoty v obecném formátu.
N Zobrazí číselné hodnoty v číselném formátu.
X Zobrazí číselné hodnoty v šestnáctkovém formátu.

Poznámka

Formátové znaky nerozlišují velká a malá písmena, s výjimkou Xpříkazu , který v zadaných případech zobrazuje šestnáctkové znaky.

Hodnota za formátovacím znakem (xx v obecném příkladu) určuje počet platných číslic nebo desetinných míst, která se mají zobrazit. Například formátovací řetězec "{0:F2}" zobrazí číslo s pevnou desetinnou čárkou se dvěma desetinnými místy.

Další informace o formátování řetězců najdete v tématu Typy formátování.

Platí pro

Viz také