HyperLinkField.DataTextFormatString Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta la stringa che specifica il formato con cui vengono visualizzate le didascalie dei collegamenti ipertestuali in un oggetto 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

Valore della proprietà

String

Stringa che specifica il formato di visualizzazione delle didascalie dei collegamenti ipertestuali di un oggetto HyperLinkField. Il valore predefinito è una stringa vuota (""), a indicare che alle didascalie dei collegamenti ipertestuali non viene applicata alcuna formattazione speciale.

Esempio

Nell'esempio di codice seguente viene illustrato come usare la DataTextFormatString proprietà per formattare i valori associati alle didascalie dei collegamenti ipertestuali visualizzati in un HyperLinkField oggetto. I valori vengono formattati come 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>

Commenti

Utilizzare la DataTextFormatString proprietà per specificare un formato di visualizzazione personalizzato per le didascalie visualizzate nell'oggetto HyperLinkField . Se la DataTextFormatString proprietà non è impostata, il valore del campo viene visualizzato senza alcuna formattazione speciale.

Nota

La stringa di formato viene applicata solo quando la DataTextField proprietà è impostata.

La stringa di formato può essere qualsiasi stringa letterale e in genere include un segnaposto per il valore del campo. Ad esempio, nella stringa di formato "Valore elemento: {0}", il {0} segnaposto viene sostituito con il valore del campo quando viene visualizzato nell'oggetto HyperLinkField . Il resto della stringa di formato viene visualizzato come testo letterale.

Nota

Se la stringa di formato non include un segnaposto, il valore del campo dall'origine dati non è incluso nel testo di visualizzazione finale.

Il segnaposto è costituito da due parti, separate da due punti e racchiuse tra parentesi graffe, nel formato {A:Bxx}. Il valore prima dei due punti (A nell'esempio generale) specifica l'indice del valore del campo in un elenco di parametri basato su zero.

Nota

Questo parametro fa parte della sintassi di formattazione. Poiché in ogni cella è presente un solo valore di campo, questo valore può essere impostato solo su 0.

I due punti e i valori dopo i due punti sono facoltativi. Il carattere dopo i due punti (B nell'esempio generale) specifica il formato in cui visualizzare il valore. Nella tabella seguente sono elencati i formati comuni.

Formato carattere Descrizione
C Visualizza i valori numerici in formato valuta.
D Visualizza i valori numerici in formato decimale.
E Visualizza i valori numerici in formato scientifico (esponenziale).
F Visualizza i valori numerici in formato fisso.
G Visualizza i valori numerici in formato generale.
N Visualizza i valori numerici in formato numero.
X Visualizza valori numerici in formato esadecimale.

Nota

I caratteri di formato non sono distinzione tra maiuscole e minuscole, ad eccezione Xdi , che visualizza i caratteri esadecimali nel caso specificato.

Il valore dopo il carattere di formato (xx nell'esempio generale) specifica il numero di cifre significative o cifre decimali da visualizzare. Ad esempio, la stringa di formato "{0:F2}" visualizza un numero a virgola fissa con due cifre decimali.

Per altre informazioni sulla formattazione delle stringhe, vedere Formatting Types (Formattazione dei tipi).

Si applica a

Vedi anche