Udostępnij przez

HyperLink.Target Własność

Definicja

Namespace:
System.Web.UI.WebControls
Montaż:
System.Web.dll

Pobiera lub ustawia okno docelowe lub ramkę, w której ma być wyświetlana zawartość strony sieci Web połączona po kliknięciu kontrolki HyperLink .

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

Wartość nieruchomości

String

Okno docelowe lub ramka do załadowania strony sieci Web połączonej z kontrolką po kliknięciu kontrolki HyperLink . Wartości muszą zaczynać się literą w zakresie od z (bez uwzględniania wielkości liter), z wyjątkiem wartości specjalnych wymienionych w poniższej tabeli, które zaczynają się od podkreślenia.

_blank Renderuje zawartość w nowym oknie bez ramek.
_parent Renderuje zawartość w obiekcie nadrzędnym bezpośredniego zestawu ramek.
_search Renderuje zawartość w okienku wyszukiwania.
_self Renderuje zawartość w ramce z fokusem.
_top Renderuje zawartość w pełnym oknie bez ramek.

Uwaga: Sprawdź dokumentację przeglądarki, aby określić, czy wartość jest obsługiwana _search . Na przykład program Microsoft Internet Explorer 5.0 lub nowszy obsługują wartość docelową _search .

Wartością domyślną jest ciąg pusty ("").

Atrybuty
BindableAttribute TypeConverterAttribute

Przykłady

W poniższym przykładzie pokazano, jak ustawić Target właściwość w celu określenia okna lub ramki w celu wyświetlenia strony skojarzonej z kontrolką HyperLink .

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

Uwagi

Target Użyj właściwości , aby określić ramkę lub okno wyświetlające stronę sieci Web połączoną z kliknięciem kontrolkiHyperLink. Strona sieci Web jest określana przez ustawienie NavigateUrl właściwości .

Jeśli ta właściwość nie jest ustawiona, przeglądarka lub okno z fokusem odświeża się po kliknięciu kontrolki HyperLink .

Uwaga

Właściwość Target jest renderowana jako target atrybut. Atrybut target elementów anchor nie jest dozwolony w definicji typu dokumentu XHTML 1.1. Nie ustawiaj Target właściwości, jeśli renderowane dane wyjściowe elementu muszą być zgodne ze standardem HyperLink XHTML 1.1. Aby uzyskać więcej informacji, zapoznaj się z tematem XHTML Standards in Visual Studio and ASP.NET (Standardy XHTML w programie Visual Studio i ASP.NET).

Podczas tworzenia dostępnych stron sieci Web zdecydowanie zaleca się unikanie używania Target właściwości do kierowania innego okna. Aby uzyskać więcej informacji, zobacz Ułatwienia dostępu w programie Visual Studio oraz ASP.NET i kontrolki ASP.NET i ułatwienia dostępu.

Dotyczy

Zobacz także