HyperLinkField.Target Proprietà

Riferimento

Definizione

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

Assembly:: System.Web.dll

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 la finestra o il frame di destinazione in cui visualizzare la pagina Web collegata quando viene fatto clic su un collegamento ipertestuale in un oggetto HyperLinkField.

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 oggetto HyperLinkField. Il valore predefinito è una stringa vuota (""), a indicare che questa proprietà non è impostata.

Attributi: TypeConverterAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come usare 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 viene fatto 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 la cornice in cui visualizzare il contenuto Web collegato a un collegamento ipertestuale quando viene fatto clic su tale collegamento ipertestuale.

I valori devono iniziare con una lettera nell'intervallo di A tramite 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`	Visualizza il contenuto in una nuova finestra senza frame.
`_parent`	Visualizza il contenuto nell'elemento padre immediato del set di frame.
`_search`	Visualizza il contenuto nel riquadro di ricerca.
`_self`	Consente di visualizzare il contenuto nel frame attivo.
`_top`	Visualizza il contenuto in tutta la finestra senza frame.

Nota

Controllare nella documentazione relativa al browser se è supportato il valore _search. Ad esempio, Microsoft Internet Explorer 5.0 e versioni successive supportano il _search valore di destinazione.

Nota

La Target proprietà viene eseguita come target attributo. L'attributo target sugli anchor elementi non è consentito nella definizione del tipo di documento XHTML 1.1. Non impostare la proprietà se l'output di cui è stato eseguito il Target 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 eseguire la Target destinazione di un'altra finestra. Per altre informazioni, vedere Accessibilità ASP.NET.

Si applica a