HyperLinkField.Target Свойство

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает или задает целевое окно или фрейм, в котором отображается содержимое веб-страницы при переходе по гиперссылке в объекте HyperLinkField.

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

Значение свойства

String

Целевое окно или фрейм для загрузки веб-страницы, на которую осуществляется переход при выборе гиперссылки в HyperLinkField. По умолчанию используется пустая строка (""), указывающая, что это свойство не задано.

Атрибуты
TypeConverterAttribute

Примеры

В следующем примере кода показано, как использовать Target свойство для указания целевого окна, в котором будет отображаться содержимое веб-страницы, связанной с гиперссылкой в объекте HyperLinkField . Связанная веб-страница отображается в новом окне при щелчке гиперссылки.


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

Комментарии

Используйте свойство , Target чтобы указать окно или фрейм, в котором будет отображаться веб-содержимое, связанное с гиперссылкой, при щелчке по этой гиперссылке.

Значения должны начинаться с буквы в диапазоне от A до Z (без учета регистра), за исключением специальных значений, перечисленных в следующей таблице, каждое из которых начинается с символа подчеркивания.

Значение Описание
_blank Отображает содержимое в новом окне без фреймов.
_parent Отрисовывает содержимое в непосредственно родительском элементе набора фреймов.
_search Отображает содержимое в панели поиска.
_self Отображает содержимое во фрейме с фокусировкой.
_top Отображает содержимое в окне без фреймов.

Примечание

Чтобы выяснить, поддерживается ли значение _search, обратитесь к документации браузера. Например, Microsoft Internet Explorer 5.0 и более поздние версии поддерживают целевое _search значение.

Примечание

Свойство Target отображается в виде атрибута target . Атрибут target элементов anchor не допускается в определении типа документа XHTML 1.1. Не устанавливайте свойство , Target если отображаемые выходные HyperLinkField данные для объекта должны быть совместимыми с XHTML 1.1. Дополнительные сведения см. в статье Стандарты XHTML в Visual Studio и ASP.NET.

При создании веб-страниц со специальными возможностями настоятельно рекомендуется избегать использования свойства для другого Target окна. Дополнительные сведения см. в разделе ASP.NET специальные возможности.

Применяется к

См. также раздел