Condividi tramite

HyperLink.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 il contenuto della pagina Web collegato quando si fa clic sul HyperLink controllo.

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

Valore della proprietà

String

Finestra o frame di destinazione a cui caricare la pagina Web collegata quando si fa clic sul HyperLink controllo. I valori devono iniziare con una lettera nell'intervallo da a z (senza distinzione tra maiuscole e minuscole), ad eccezione dei valori speciali elencati nella tabella seguente, che iniziano con un carattere di sottolineatura.

_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.

Nota: 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.

Il valore predefinito è una stringa vuota ("").

Attributi
BindableAttribute TypeConverterAttribute

Esempio

Nell'esempio seguente viene illustrato come impostare la Target proprietà per specificare la finestra o il frame per visualizzare la pagina associata al HyperLink controllo .

<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
    <title>HyperLink Sample</title>
</head>
<body>
<form id="Form1" runat="server">


   <h3>HyperLink Sample</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  runat="server"/>       

</form>
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
    <title>HyperLink Sample</title>
</head>
<body>
<form id="Form1" runat="server">

   <h3>HyperLink Sample</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  runat="server"/>       

</form>
</body>
</html>

Commenti

Utilizzare la Target proprietà per specificare la cornice o la finestra a cui viene visualizzata la pagina Web collegata quando si fa clic sul HyperLink controllo. La pagina Web viene specificata impostando la NavigateUrl proprietà .

Se questa proprietà non è impostata, il browser o la finestra con lo stato attivo viene aggiornato quando si fa clic sul HyperLink controllo.

Annotazioni

La proprietà esegue il Target rendering 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 deve HyperLink 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 Accessibilità in Visual Studio e ASP.NET e controlli ASP.NET e accessibilità.

Si applica a

Vedi anche