HyperLinkField.DataNavigateUrlFormatString プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As HyperLinkField Dim value As String value = instance.DataNavigateUrlFormatString instance.DataNavigateUrlFormatString = value
public: virtual property String^ DataNavigateUrlFormatString { String^ get (); void set (String^ value); }
/** @property */ public String get_DataNavigateUrlFormatString () /** @property */ public void set_DataNavigateUrlFormatString (String value)
public function get DataNavigateUrlFormatString () : String public function set DataNavigateUrlFormatString (value : String)
HyperLinkField オブジェクトに表示されるハイパーリンクの URL に適用する書式指定文字列。既定値は空の文字列です ("")。この値は、URL 値に適用される特定の書式が設定されていないことを示します。
解説HyperLinkField オブジェクトに表示されるハイパーリンクの URL にカスタム書式を指定するには、DataNavigateUrlFormatString プロパティを使用します。DataNavigateUrlFormatString プロパティが設定されていない場合、ハイパーリンクの URL には特別な書式は一切適用されません。
.gif) メモ |
|---|
書式指定文字列には、任意のリテラル文字列を使用でき、通常は、フィールド値のプレースホルダが含まれます。たとえば、"Item Value: {0}" という書式指定文字列があった場合、"{0}" のプレースホルダは、対応するフィールドの値と置き換えられた上で、HyperLinkField オブジェクトに表示されます。書式指定文字列の残りの部分は、リテラル テキストとして表示されます。
プレースホルダは、{ A : Bxx } の形式で、中かっこで囲まれた、コロン区切りの 2 つの部分から構成されます。コロンの前の値 (一般的な例での A) は 0 から始まるパラメータのリストのフィールド値インデックスを指定します。
| メモ |
|---|
| このパラメータは、書式指定構文の一部です。各セルはフィールド値を 1 つしか格納できないので、この値は必ず 0 に設定します。 |
コロンおよびコロンの後の値は省略可能です。コロンの後の文字 (一般的な例での B) には、値を表示する際に使用する書式を指定します。共通の書式を次の表に示します。
| C | |
| D | |
| E | |
| F | |
| G | |
| N | |
| X |
書式指定文字の後の値 (一般的な例での xx) は、表示する有効桁数または小数点を指定します。たとえば、書式指定文字列 "{0:F2}" を使用すると、2 桁の固定小数点数で表示されます。
使用例HyperLinkField オブジェクトに表示されるハイパーリンクのナビゲーション URL に対し、DataNavigateUrlFormatString プロパティを使用して、カスタム書式を指定する方法を次のコード例に示します。DataTextField プロパティで指定されたフィールドの値は、書式指定文字列で指定された Web ページにクエリ文字列として渡されます。
<%@ Page language="VB" %> <html> <body> <form 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>
<%@ Page language="C#" %> <html> <body> <form 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>
プラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- HyperLinkField.DataNavigateUrlFormatString プロパティのページへのリンク
