HyperLinkField.DataTextField Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta il nome del campo dell'origine dati contenente il testo da visualizzare per le didascalie dei collegamenti ipertestuali nell'oggetto HyperLinkField.
public:
virtual property System::String ^ DataTextField { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public virtual string DataTextField { get; set; }[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public virtual string DataTextField { get; set; }[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.DataTextField : string with get, set[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.DataTextField : string with get, setPublic Overridable Property DataTextField As StringValore della proprietà
Il nome del campo dell'origine dati contenente i valori da visualizzare per le didascalie dei collegamenti ipertestuali nell'oggetto HyperLinkField. Il valore predefinito è una stringa vuota (""), a indicare che questa proprietà non è impostata.
- Attributi
Esempio
Nell'esempio di codice seguente viene illustrato come utilizzare la DataTextField proprietà per specificare un campo dall'origine dati da associare alle didascalie dei collegamenti ipertestuali visualizzati in un HyperLinkField oggetto .
<%@ 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 DataBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField DataBinding Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- Bind the CompanyName and HomePage fields from the -->
<!-- Northwind database to the caption and URL of the -->
<!-- hyperlinks in the HyperLinkField field column. Note -->
<!-- that the URLs specified in the Northwind database -->
<!-- might not be valid URLs. -->
<asp:gridview id="SuppliersGridView"
datasourceid="SuppliersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:hyperlinkfield datatextfield="CompanyName"
datanavigateurlfields="HomePage"
headertext="Company Name"
target="_blank" />
<asp:boundfield datafield="City"
headertext="City"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="SuppliersSqlDataSource"
selectcommand="SELECT [SupplierID], [CompanyName], [City], [HomePage] FROM [Suppliers]"
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 DataBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField DataBinding Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- Bind the CompanyName and HomePage fields from the -->
<!-- Northwind database to the caption and URL of the -->
<!-- hyperlinks in the HyperLinkField field column. Note -->
<!-- that the URLs specified in the Northwind database -->
<!-- might not be valid URLs. -->
<asp:gridview id="SuppliersGridView"
datasourceid="SuppliersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:hyperlinkfield datatextfield="CompanyName"
datanavigateurlfields="HomePage"
headertext="Company Name"
target="_blank" />
<asp:boundfield datafield="City"
headertext="City"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="SuppliersSqlDataSource"
selectcommand="SELECT [SupplierID], [CompanyName], [City], [HomePage] FROM [Suppliers]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Nell'esempio di codice seguente viene illustrato come utilizzare 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 DataTextField proprietà per specificare il nome del campo contenente il testo da visualizzare per le didascalie dei collegamenti ipertestuali nell'oggetto HyperLinkField .
Anziché usare questa proprietà per associare le didascalie dei collegamenti ipertestuali a un campo, è possibile utilizzare la Text proprietà per impostare le didascalie dei collegamenti ipertestuali su un valore statico. Con questa opzione, ogni collegamento ipertestuale condivide la stessa didascalia.
Nota
Se le DataTextField proprietà e Text sono entrambe impostate, la proprietà ha la DataTextField precedenza.