HtmlAnchor.Target Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Namen des Browserfensters bzw. -frames ab, in dem der Inhalt der beim Klicken auf das HtmlAnchor-Steuerelement aufgerufenen Webseite angezeigt wird, oder legt diesen fest.

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

Eigenschaftswert

String

Das Browserfenster bzw. der Browserframe, in dem der Inhalt der Webseite angezeigt wird, die beim Klicken auf das HtmlAnchor-Steuerelement aufgerufen wird. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Eigenschaft zum Anzeigen der Seite verwendet wird, zu der Target navigiert wird, wenn das HtmlAnchor Steuerelement in einem neuen, unframed-Fenster geklickt wird.

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

Hinweise

Verwenden Sie die Target Eigenschaft, um das Zielfenster oder den Frame anzugeben, mit dem der Inhalt der Webseite angezeigt wird, die verknüpft ist, wenn auf das HtmlAnchor Steuerelement geklickt wird.

Hinweis

Die Target Eigenschaft wird als target Attribut gerendert. Das target Attribut für a Elemente ist in der XHTML 1.1-Dokumenttypdefinition nicht zulässig. Legen Sie die Target Eigenschaft nicht fest, wenn die gerenderte Ausgabe für die HtmlAnchor Ausgabe mit XHTML 1.1 kompatibel sein muss. Weitere Informationen finden Sie unter XHTML-Standards in Visual Studio und ASP.NET.

Vermeiden Sie beim Erstellen barrierefreier Webseiten die Verwendung der Target Eigenschaft zum Ziel eines anderen Fensters. Weitere Informationen finden Sie unter ASP.NET Barrierefreiheit.

Der Target Wert muss mit einem Buchstaben im Bereich von A bis Z (Groß-/Kleinschreibung) beginnen, mit Ausnahme der folgenden speziellen Werte, die mit einem Unterstrich beginnen.

Zielwert	BESCHREIBUNG
`_blank`	Stellt den Inhalt in einem neuen Fenster ohne Frames dar.
`_parent`	Stellt den Inhalt im unmittelbar übergeordneten Frameset dar.
`_search`	Gibt den Inhalt im Suchbereich wieder.
`_self`	Stellt den Inhalt in dem Frame dar, der den Fokus besitzt.
`_top`	Stellt den Inhalt im gesamten Fenster ohne Frames dar.

Hinweis

Sie können der Browserdokumentation entnehmen, ob der _search-Wert unterstützt wird. Beispielsweise unterstützen Microsoft Internet Explorer 5.0 und höhere Versionen den _search-Zielwert.

Gilt für

Siehe auch

ASP.NET und XHTML Compliance

Share via