HyperLinkField.Text HyperLinkField.Text HyperLinkField.Text HyperLinkField.Text Property

Definizione

Ottiene o imposta il testo da visualizzare per ciascun collegamento ipertestuale nell'oggetto HyperLinkField.Gets or sets the text to display for each hyperlink in the HyperLinkField object.

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

Valore della proprietà

Testo da visualizzare per ciascun collegamento ipertestuale nell'oggetto HyperLinkField.The text to display for each hyperlink in the HyperLinkField. Il valore predefinito è una stringa vuota (""), a indicare che questa proprietà non è impostata.The default is an empty string (""), which indicates that this property is not set.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato Text come utilizzare la proprietà per specificare una didascalia statica da visualizzare per i collegamenti HyperLinkField ipertestuali in un oggetto.The following code example demonstrates how to use the Text property to specify a static caption to display for the hyperlinks in a HyperLinkField object.


<%@ 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. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        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 Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Commenti

Utilizzare la Text proprietà per specificare la didascalia da visualizzare per i collegamenti ipertestuali in HyperLinkField un oggetto.Use the Text property to specify the caption to display for the hyperlinks in a HyperLinkField object. Quando questa proprietà è impostata, ogni collegamento ipertestuale condivide la stessa didascalia.When this property is set, each hyperlink shares the same caption.

Anziché usare questa proprietà per impostare le didascalie dei collegamenti ipertestuali, è possibile DataTextField usare la proprietà per associare le didascalie dei collegamenti ipertestuali a un campo in un'origine dati.Instead of using this property to set the hyperlink captions, you can use the DataTextField property to bind the hyperlink captions to a field in a data source. In questo modo è possibile visualizzare una didascalia diversa per ogni collegamento ipertestuale.This allows you to display a different caption for each hyperlink.

Nota

Se le DataTextField proprietà Text e sono entrambe impostate, la DataTextField proprietà avrà la precedenza.If the DataTextField and Text properties are both set, the DataTextField property takes precedence.

Il valore di questa proprietà, se impostato, può essere salvato automaticamente in un file di risorse tramite uno strumento di progettazione.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Per ulteriori informazioni, vedere LocalizableAttribute e globalizzazione e localizzazione.For more information, see LocalizableAttribute and Globalization and Localization.

Si applica a

Vedi anche