HyperLinkField.DataNavigateUrlFormatString Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает или задает строку, определяющую формат, по которому генерируются URL-адреса гиперссылок в объекте 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

Значение свойства

String

Строка, задающая формат, по которому генерируются URL-адреса гиперссылок в объекте HyperLinkField. По умолчанию это пустая строка (""), указывающая на неприменение к значениям URL-адресов специального форматирования.

Примеры

В следующем примере кода показано, как использовать DataNavigateUrlFormatString свойство для указания настраиваемого формата для применения к URL-адресам навигации гиперссылок, отображаемых в объекте HyperLinkField . Значение поля, указанного свойством DataTextField , передается в виде строки запроса на веб-страницу, указанную в строке формата.


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

Комментарии

DataNavigateUrlFormatString Используйте свойство, чтобы указать пользовательский формат ДЛЯ URL-адресов гиперссылок в объектеHyperLinkField. DataNavigateUrlFormatString Если свойство не задано, URL-адреса гиперссылок не получают специального форматирования.

Примечание

Строка формата применяется только в том случае, если DataNavigateUrlFields свойство задано.

Строка формата может быть любой литеральной строкой и обычно включает заполнитель для значения поля. Например, в строке формата "Значение элемента" {0}{0} заполнитель заменяется значением поля в объектеHyperLinkField. Остальная часть строки формата отображается в виде литерального текста.

Примечание

Если строка формата не содержит заполнитель, значение поля из источника данных не включается в окончательный отображаемый текст.

Заполнитель состоит из двух частей, разделенных двоеточием и завернутыми в фигурные скобки, в формате {A:Bxx}. Значение перед двоеточием (A в общем примере) указывает индекс значения поля в отсчитываемом от нуля списке параметров.

Примечание

Этот параметр является частью синтаксиса форматирования. Так как в каждой ячейке имеется только одно значение поля, это значение может иметь только значение 0.

Двоеточие и значения после двоеточия являются необязательными. Символ после двоеточия (B в общем примере) указывает формат, в котором будет отображаться значение. В следующей таблице перечислены распространенные форматы.

Символ форматирования Описание
C Отображает числовые значения в денежном формате.
D Отображает числовые значения в десятичном формате.
E Отображает числовые значения в экспоненциальном формате.
F Отображает числовые значения в фиксированном формате.
G Отображает числовые значения в общем формате.
N Отображает числовые значения в числовом формате.
X Отображает числовые значения в шестнадцатеричном формате.

Примечание

Символы формата не чувствительны к регистру, за исключением Xтого, что в указанном регистре отображаются шестнадцатеричные символы.

Значение после символа формата (xx в общем примере) указывает количество значимых цифр или десятичных разрядов для отображения. Например, строка формата "{0:F2}" отображает число с фиксированной запятой с двумя десятичными знаками.

Дополнительные сведения о форматировании строк см. в статье Общие сведения о форматировании.

Применяется к

См. также раздел