HyperLink.Target Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
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ść właściwości

String

Okno docelowe lub ramka do załadowania strony sieci Web połączonej z kliknięciem 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 natychmiastowego 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ługuje 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, na której jest wyświetlana strona sieci Web połączona po kliknięciu 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 właściwości, Target 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 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 Visual Studio i ASP.NET oraz kontrolki i ułatwienia dostępu ASP.NET.

Dotyczy

Zobacz też