Condividi tramite

HyperLinkField.Target Proprietà

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta la finestra o il frame di destinazione in cui visualizzare la pagina Web collegata quando si fa clic su un collegamento ipertestuale in un HyperLinkField oggetto .

public:
 virtual property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public virtual string Target { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
Public Overridable Property Target As String

Valore della proprietà

String

Finestra o frame di destinazione in cui caricare la pagina Web collegata quando si fa clic su un collegamento ipertestuale in un HyperLinkField oggetto . Il valore predefinito è una stringa vuota (""), che indica che questa proprietà non è impostata.

Attributi
TypeConverterAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la Target proprietà per specificare una finestra di destinazione in cui visualizzare il contenuto della pagina Web associata a un collegamento ipertestuale in un HyperLinkField oggetto . La pagina Web collegata viene visualizzata in una nuova finestra quando si fa clic sul collegamento ipertestuale.


<%@ 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 Target proprietà per specificare la finestra o il frame in cui visualizzare il contenuto Web collegato a un collegamento ipertestuale quando si fa clic su tale collegamento ipertestuale.

I valori devono iniziare con una lettera nell'intervallo da A a Z (senza distinzione tra maiuscole e minuscole), ad eccezione dei valori speciali elencati nella tabella seguente, ognuno dei quali inizia con un carattere di sottolineatura.

Valore Descrizione
_blank Esegue il rendering del contenuto in una nuova finestra senza frame.
_parent Esegue il rendering del contenuto nell'elemento padre del frameset immediato.
_search Esegue il rendering del contenuto nel riquadro di ricerca.
_self Esegue il rendering del contenuto nel frame con lo stato attivo.
_top Esegue il rendering del contenuto nella finestra completa senza frame.

Annotazioni

Controllare la documentazione del browser per determinare se il _search valore è supportato. Ad esempio, Microsoft Internet Explorer 5.0 e versioni successive supportano il _search valore di destinazione.

Annotazioni

Il rendering della Target proprietà viene eseguito come target attributo. L'attributo target sugli anchor elementi non è consentito nella definizione del tipo di documento XHTML 1.1. Non impostare la Target proprietà se l'output sottoposto a rendering per l'oggetto HyperLinkField deve essere conforme a XHTML 1.1. Per altre informazioni, vedere l'argomento Standard XHTML in Visual Studio e ASP.NET.

Quando si creano pagine Web accessibili, è consigliabile evitare di usare la proprietà per impostare come Target destinazione un'altra finestra. Per altre informazioni, vedere ASP.NET Accessibilità.

Si applica a

Vedi anche