HyperLinkField.DataTextFormatString Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

De tekenreeks ophalen of instellen die de indeling aangeeft waarin de hyperlinkbijschriften in een HyperLinkField object worden weergegeven.

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

Waarde van eigenschap

String

Een tekenreeks die de indeling aangeeft waarin de hyperlinkbijschriften in een HyperLinkField worden weergegeven. De standaardwaarde is een lege tekenreeks (""), die aangeeft dat er geen speciale opmaak wordt toegepast op de hyperlinkbijschriften.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de DataTextFormatString eigenschap gebruikt om de waarden op te maken die zijn gebonden aan de hyperlinkbijschriften die in een HyperLinkField object worden weergegeven. De waarden worden opgemaakt als 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>

Opmerkingen

Gebruik de DataTextFormatString eigenschap om een aangepaste weergave-indeling op te geven voor de bijschriften die in het HyperLinkField object worden weergegeven. Als de DataTextFormatString eigenschap niet is ingesteld, wordt de waarde van het veld weergegeven zonder speciale opmaak.

Note

De notatietekenreeks wordt alleen toegepast wanneer de DataTextField eigenschap is ingesteld.

De notatietekenreeks kan elke letterlijke tekenreeks zijn en bevat meestal een tijdelijke aanduiding voor de waarde van het veld. In de notatietekenreeks 'Itemwaarde: {0}', wordt de {0} tijdelijke aanduiding vervangen door de waarde van het veld wanneer deze wordt weergegeven in het HyperLinkField object. De rest van de notatietekenreeks wordt weergegeven als letterlijke tekst.

Note

Als de notatietekenreeks geen tijdelijke aanduiding bevat, wordt de waarde van het veld uit de gegevensbron niet opgenomen in de uiteindelijke weergavetekst.

De tijdelijke aanduiding bestaat uit twee delen, gescheiden door een dubbele punt en verpakt in accolades, in de vorm {A:Bxx}. De waarde vóór de dubbele punt (A in het algemene voorbeeld) geeft de index van de veldwaarde op in een op nul gebaseerde lijst met parameters.

Note

Deze parameter maakt deel uit van de syntaxis van de opmaak. Omdat er slechts één veldwaarde in elke cel is, kan deze waarde alleen worden ingesteld op 0.

De dubbele punt en de waarden na de dubbele punt zijn optioneel. Het teken na de dubbele punt (B in het algemene voorbeeld) geeft de notatie op waarin de waarde moet worden weergegeven. De volgende tabel bevat de algemene notaties.

Teken opmaken Beschrijving
C Geeft numerieke waarden weer in valutanotatie.
D Geeft numerieke waarden weer in decimale notatie.
E Geeft numerieke waarden weer in wetenschappelijke (exponentiële) notatie.
F Geeft numerieke waarden weer in vaste notatie.
G Geeft numerieke waarden weer in de algemene notatie.
N Geeft numerieke waarden weer in getalnotatie.
X Geeft numerieke waarden weer in hexadecimale notatie.

Note

De notatietekens zijn niet hoofdlettergevoelig, met uitzondering van X, waarin de hexadecimale tekens in het opgegeven geval worden weergegeven.

De waarde na het notatieteken (xx in het algemene voorbeeld) geeft het aantal significante cijfers of decimalen op dat moet worden weergegeven. De notatietekenreeks '{0:F2}' geeft bijvoorbeeld een vast puntnummer weer met twee decimalen.

Zie Opmaaktypen voor meer informatie over het opmaken van tekenreeksen.

Van toepassing op

Zie ook