Sdílet prostřednictvím

HyperLinkField.DataNavigateUrlFormatString 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 jsou vykreslovány adresy URL hypertextových odkazů v objektu HyperLinkField .

public:
 virtual property System::String ^ DataNavigateUrlFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataNavigateUrlFormatString { get; set; }
member this.DataNavigateUrlFormatString : string with get, set
Public Overridable Property DataNavigateUrlFormatString As String

Hodnota vlastnosti

String

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

Příklady

Následující příklad kódu ukazuje, jak použít DataNavigateUrlFormatString vlastnost k určení vlastního formátu, který se použije na navigační adresy URL hypertextových odkazů zobrazených v objektu HyperLinkField . Hodnota pole určeného DataTextField vlastností je předána jako řetězec dotazu webové stránce zadané v řetězci formátu.


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

DataNavigateUrlFormatString Vlastnost slouží k určení vlastního formátu pro adresy URL hypertextových odkazů v objektuHyperLinkField. DataNavigateUrlFormatString Pokud vlastnost není nastavená, nezískají adresy URL hypertextových odkazů žádné zvláštní formátování.

Poznámka

Formátovací řetězec se použije pouze při DataNavigateUrlFields 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 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é