Condividi tramite

HtmlAnchor.Target Proprietà

Definizione

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

Ottiene o imposta il nome della finestra o del frame del browser che visualizza il contenuto della pagina Web a cui è collegato quando si fa clic sul HtmlAnchor controllo.

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

Valore della proprietà

String

Finestra o cornice del browser che visualizza il contenuto della pagina Web collegata a quando HtmlAnchor si fa clic su . Il valore predefinito è una stringa vuota ("").

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la Target proprietà per visualizzare la pagina a cui si accede quando si fa clic sul HtmlAnchor controllo in una nuova finestra senza frame.

<%@ 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 runat="server">
        <title>ASP.NET Example</title>
    </head>
    <body>
      <form id="Form1" method="post" runat="server">
  
         <a href="http://www.microsoft.com"
            title="Open Microsoft site in a new window"
            target="_blank" 
            runat="server"> Enter site.</a>
  
       </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 runat="server">
        <title>ASP.NET Sample</title>
    </head>
   
    <body>
      <form id="Form1" method="post" runat="server">
  
         <a href="http://www.microsoft.com"
            target="_blank" 
            title="Open Microsoft.com site in a new window"
            runat="server"> Enter site.</a>
  
       </form>
     </body>
 
 </html>

Commenti

Utilizzare la Target proprietà per specificare la finestra o il frame di destinazione che visualizza il contenuto della pagina Web collegata a quando si fa clic sul HtmlAnchor controllo.

Annotazioni

La proprietà esegue il Target rendering come target attributo. L'attributo target sugli a 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 HtmlAnchor essere conforme a XHTML 1.1. Per altre informazioni, vedere Standard XHTML in Visual Studio e ASP.NET.

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

Il Target valore deve iniziare con una lettera nell'intervallo da A a Z (senza distinzione tra maiuscole e minuscole), ad eccezione dei valori speciali seguenti, che iniziano con un carattere di sottolineatura.

Valore target 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.

Si applica a

Vedi anche