HyperLinkField.Target Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger målfönstret eller ramen där webbsidan som är länkad till visas när en hyperlänk i ett HyperLinkField objekt klickas.

public:
 virtual property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public virtual string Target { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
Public Overridable Property Target As String

Egenskapsvärde

String

Målfönstret eller ramen där du vill läsa in webbsidan som är länkad till när en hyperlänk i en HyperLinkField klickas. Standardvärdet är en tom sträng (") som anger att den här egenskapen inte har angetts.

Attribut
TypeConverterAttribute

Exempel

Följande kodexempel visar hur du använder Target egenskapen för att ange ett målfönster där innehållet på webbsidan som är associerad med en hyperlänk i ett HyperLinkField objekt ska visas. Den länkade webbsidan visas i ett nytt fönster när hyperlänken klickas.


<%@ Page language="C#" %>

<!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>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>


<%@ Page language="VB" %>

<!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>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Kommentarer

Använd egenskapen Target för att ange det fönster eller den ram där webbinnehållet som är länkat till en hyperlänk ska visas när hyperlänken klickas.

Värden måste börja med en bokstav i intervallet A till Z (skiftlägesokänslig), förutom de specialvärden som anges i följande tabell, som var och en börjar med ett understreck.

Value Description
_blank Renderar innehållet i ett nytt fönster utan bildrutor.
_parent Renderar innehållet i den överordnade ramuppsättningen.
_search Renderar innehållet i sökfönstret.
_self Renderar innehållet i ramen med fokus.
_top Renderar innehållet i det fullständiga fönstret utan bildrutor.

Note

Kontrollera webbläsarens dokumentation för att avgöra om värdet _search stöds. Till exempel stöder Microsoft Internet Explorer 5.0 och senare versioner _search målvärdet.

Note

Egenskapen Target återges som ett target attribut. Attributet target för anchor element tillåts inte i XHTML 1.1-dokumenttypens definition. Ange Target inte egenskapen om de renderade utdata för HyperLinkField objektet måste vara XHTML 1.1-kompatibla. Mer information finns i avsnittet XHTML-standarder i Visual Studio och ASP.NET.

När du skapar tillgängliga webbsidor rekommenderar vi starkt att du undviker att använda Target egenskapen för att rikta in dig på ett annat fönster. Mer information finns i ASP.NET Accessibility.

Gäller för

Se även