HyperLink.Target HyperLink.Target HyperLink.Target HyperLink.Target Property

Definizione

Ottiene o imposta la finestra o il frame di destinazione in cui visualizzare il contenuto della pagina Web collegato quando viene fatto clic sul controllo HyperLink.Gets or sets the target window or frame in which to display the Web page content linked to when the HyperLink control is clicked.

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

Valore della proprietà

Finestra o frame di destinazione in cui caricare la pagina Web collegata quando si fa clic sul controllo HyperLink.The target window or frame to load the Web page linked to when the HyperLink control is clicked. I valori devono iniziare con una lettera compresa tra A e Z, senza distinzione tra maiuscole e minuscole, ad eccezione dei valori speciali che iniziano con un carattere di sottolineatura elencati nella tabella riportata di seguito:Values must begin with a letter in the range of a through z (case-insensitive), except for the special values listed in the following table, which begin with an underscore.

_blank Visualizza il contenuto in una nuova finestra senza frame.Renders the content in a new window without frames.
_parent Visualizza il contenuto nell'elemento padre immediato del set di frame.Renders the content in the immediate frameset parent.
_search Visualizza il contenuto nel riquadro di ricerca.Renders the content in the search pane.
_self Consente di visualizzare il contenuto nel frame attivo.Renders the content in the frame with focus.
_top Visualizza il contenuto in tutta la finestra senza frame.Renders the content in the full window without frames.

Controllare nella documentazione relativa al browser se è supportato il valore _search.Check your browser documentation to determine if the _search value is supported. Ad esempio, Microsoft Internet Explorer 5.0 e versioni successive supportano il valore di destinazione _search.For example, Microsoft Internet Explorer 5.0 and later support the _search target value.

Il valore predefinito è una stringa vuota ("").The default value is an empty string ("").

Esempi

Nell'esempio seguente viene illustrato come impostare la Target proprietà per specificare la finestra o il frame per visualizzare la pagina associata HyperLink al controllo.The following example demonstrates how to set the Target property to specify the window or frame to display the page associated with the HyperLink control.

<%@ 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 il frame o la finestra in cui viene visualizzata la pagina Web collegata HyperLink quando si fa clic sul controllo.Use the Target property to specify the frame or window that displays the Web page linked to when the HyperLink control is clicked. La pagina Web viene specificata impostando la NavigateUrl proprietà.The Web page is specified by setting the NavigateUrl property.

Se questa proprietà non è impostata, il browser o la finestra con lo HyperLink stato attivo viene aggiornato quando si fa clic sul controllo.If this property is not set, the browser or window with focus refreshes when the HyperLink control is clicked.

Nota

La Target proprietà viene sottoposta target a rendering come attributo.The Target property renders as a target attribute. L' target attributo sugli anchor elementi non è consentito in XHTML 1,1 Document Type Definition.The target attribute on anchor elements is not allowed in the XHTML 1.1 document type definition. Non impostare la Target proprietà se l'output HyperLink di cui è stato eseguito il rendering per deve essere conforme a XHTML 1,1.Do not set the Target property if the rendered output for the HyperLink must be XHTML 1.1 compliant. Per ulteriori informazioni, vedere l'argomento standard XHTML in Visual Studio e ASP.NET.For more information, refer to the topic XHTML Standards in Visual Studio and ASP.NET.

Quando si creano pagine Web accessibili, è consigliabile evitare di usare la Target proprietà per fare riferimento a un'altra finestra.When creating accessible Web pages, it is strongly recommended you avoid using the Target property to target another window. Per altre informazioni, vedere accessibilità in Visual Studio e controlli ASP.NET e ASP.NET e accessibilità.For more information, see Accessibility in Visual Studio and ASP.NET and ASP.NET Controls and Accessibility.

Si applica a

Vedi anche