HyperLink.Target Tulajdonság

Definíció

Névtér:

System.Web.UI.WebControls

Szerelvény:

System.Web.dll

Lekéri vagy beállítja azt a célablakot vagy keretet, amelyben a vezérlő kattintásakor HyperLink csatolt weblaptartalmak jelenjenek meg.

public:
 property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public string Target { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set

Public Property Target As String

Tulajdonság értéke

String

A vezérlő kattintásakor HyperLink csatolt weblap betöltéséhez szükséges célablak vagy keret. Az értékeknek egy betűvel kell kezdődniük az a-z tartományában (kis- és nagybetűk érzéketlenek), kivéve az alábbi táblázatban felsorolt speciális értékeket, amelyek aláhúzásjellel kezdődnek.

_blank	Képkockák nélkül jeleníti meg a tartalmat egy új ablakban.
_parent	Megjeleníti a tartalmat az azonnali keretkészlet szülőjében.
_search	Megjeleníti a tartalmat a keresési panelen.
_self	Fókuszban jeleníti meg a keret tartalmát.
_top	Képkockák nélkül jeleníti meg a tartalmat a teljes ablakban.

Megjegyzés: Ellenőrizze a böngésző dokumentációjában, hogy az _search érték támogatott-e. Az 5.0-s és újabb Microsoft Internet Explorer például támogatja a _search célértéket.

Az alapértelmezett érték egy üres sztring ("").

Attribútumok

TypeConverterAttribute

Példák

Az alábbi példa bemutatja, hogyan állíthatja be a tulajdonságot úgy Target , hogy megadja az ablakot vagy a keretet a vezérlőelemhez HyperLink társított oldal megjelenítéséhez.

<%@ 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>

Megjegyzések

Target A tulajdonság használatával megadhatja azt a keretet vagy ablakot, amely a vezérlőelem kattintásakor HyperLink csatolt weblapot jeleníti meg. A weblap a tulajdonság beállításával NavigateUrl van megadva.

Ha ez a tulajdonság nincs beállítva, a fókuszt tartalmazó böngésző vagy ablak frissül, amikor a HyperLink vezérlőre kattint.

Note

A Target tulajdonság attribútumként target jelenik meg. Az target elemek attribútuma anchor nem engedélyezett az XHTML 1.1 dokumentumtípus-definícióban. Ne állítsa be a Target tulajdonságot, ha a renderelt kimenetnek HyperLink XHTML 1.1-kompatibilisnek kell lennie. További információ: XHTML szabványok Visual Studio és ASP.NET.

Akadálymentes weblapok létrehozásakor javasoljuk, hogy ne használja a Target tulajdonságot egy másik ablak megcélzására. További információ: Hozzáérthetőség Visual Studio és ASP.NET és ASP.NET Vezérlők és kisegítő lehetőségek.

Lásd még

• NavigateUrl
• A HyperLink webkiszolgáló vezérlőjének áttekintése