Поделиться через

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 специальные возможности.

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

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