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


BulletedList.Target Свойство

Определение

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

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

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

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

Атрибуты

Примеры

В следующем примере кода показано, как создать BulletedList элемент управления и задать Target свойство . Когда пользователь выбирает HyperLink режим отображения в списке, свойству Target присваивается значение _blank , чтобы отобразить связанную страницу в новом окне браузера.

<%@ 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>DisplayMode Example</title>
<script runat="server">
  
  void Index_Changed(object sender, System.EventArgs e)
  {

      // Change the message displayed, based on 
      // the display mode selected from the list box.
      if (DisplayModeListBox.SelectedIndex > -1)
      {
          Message1.Text = "You chose: " + DisplayModeListBox.SelectedItem.Text;
      }

      // Change the display mode, based on 
      // the mode selected from the list box.
      switch (DisplayModeListBox.SelectedIndex) 
    {
          case 0:
              ItemsBulletedList.DisplayMode = BulletedListDisplayMode.Text;
              Message2.Text = "";
              break;
          case 1:
              ItemsBulletedList.DisplayMode = BulletedListDisplayMode.HyperLink;
              // Opens a new browser window to display the page linked to.
              ItemsBulletedList.Target = "_blank";
              Message2.Text = "";
              break;
          case 2:
              ItemsBulletedList.DisplayMode = BulletedListDisplayMode.LinkButton;
              break;
          default:
              throw new Exception("You did not select a valid display mode.");
              break;
      }

  }

  void ItemsBulletedList_Click(object sender, System.Web.UI.WebControls.BulletedListEventArgs e)
  {

      // Change the message displayed, based on the index
      // of the bulletedlist list item that was clicked.
      switch (e.Index) 
    {
          case 0:
              Message2.Text = "You  clicked list item 1.";
              break;
          case 1:
              Message2.Text = "You  clicked list item 2.";
              break;
          case 2:
              Message2.Text = "You  clicked list item 3.";
              break;
          default:
              throw new Exception("You did not click a valid list item.");
              break;
      }

  }

</script>

</head>
<body>

  <h3>DisplayMode Example</h3>

  <form id="form1" runat="server">

    <h3>BulletedListDisplayMode Example</h3>

    <p>
    <asp:BulletedList id="ItemsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="Text" 
      OnClick="ItemsBulletedList_Click"
      runat="server">    
      <asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
      <asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
      <asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
    </asp:BulletedList></p>

    <hr />

    <h4>Select from the list to change the display mode:</h4>
    <asp:ListBox id="DisplayModeListBox" 
      Rows="1"
      SelectionMode="Single"
      AutoPostBack="True"
      OnSelectedIndexChanged="Index_Changed"
      runat="server">
        <asp:ListItem>Text</asp:ListItem>
        <asp:ListItem>Hyperlink</asp:ListItem>
        <asp:ListItem>LinkButton</asp:ListItem>
    </asp:ListBox>

    <asp:Label id="Message1" 
      runat="server"
      AssociatedControlID="DisplayModeListBox"/><br /><br />

    <asp:Label id="Message2"
      runat="server"
      AssociatedControlID="DisplayModeListBox"/>

   </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>DisplayMode Example</title>
<script runat="server">

  Sub Index_Changed(ByVal sender As Object, ByVal e As System.EventArgs)

    ' Change the message displayed, based on 
    ' the display mode selected from the list box.
    If DisplayModeListBox.SelectedIndex > -1 Then
      Message1.Text = "You chose: " & DisplayModeListBox.SelectedItem.Text
    End If

    ' Change the display mode, based on 
    ' the mode selected from the list box.
    Select Case (DisplayModeListBox.SelectedIndex)
      Case 0
        ItemsBulletedList.DisplayMode = BulletedListDisplayMode.Text
        Message2.Text = ""
      Case 1
        ItemsBulletedList.DisplayMode = BulletedListDisplayMode.HyperLink
        ' Opens a new browser window to display the page linked to.
        ItemsBulletedList.Target = "_blank"
        Message2.Text = ""
      Case 2
        ItemsBulletedList.DisplayMode = BulletedListDisplayMode.LinkButton
      Case Else
        Throw New Exception("You did not select a valid display mode.")
    End Select

  End Sub

  Sub ItemsBulletedList_Click(ByVal sender As Object, _
                              ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)

    ' Change the message displayed, based on the index
    ' of the bulletedlist list item that was clicked.
    Select Case (e.Index)
      Case 0
        Message2.Text = "You  clicked list item 1."
      Case 1
        Message2.Text = "You  clicked list item 2."
      Case 2
        Message2.Text = "You  clicked list item 3."
      Case Else
        Throw New Exception("You did not click a valid list item.")
    End Select

  End Sub

</script>

</head>
<body>

  <h3>DisplayMode Example</h3>

  <form id="form1" runat="server">

    <h3>BulletedListDisplayMode Example</h3>

    <p>
    <asp:BulletedList id="ItemsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="Text" 
      OnClick="ItemsBulletedList_Click"
      runat="server">    
      <asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
      <asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
      <asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
    </asp:BulletedList></p>

    <hr />

    <h4>Select from the list to change the display mode:</h4>
    <asp:ListBox id="DisplayModeListBox" 
      Rows="1"
      SelectionMode="Single"
      AutoPostBack="True"
      OnSelectedIndexChanged="Index_Changed"
      runat="server">
        <asp:ListItem>Text</asp:ListItem>
        <asp:ListItem>Hyperlink</asp:ListItem>
        <asp:ListItem>LinkButton</asp:ListItem>
    </asp:ListBox>

    <asp:Label id="Message1" 
      runat="server"
      AssociatedControlID="DisplayModeListBox"/><br /><br />

    <asp:Label id="Message2"
      runat="server"
      AssociatedControlID="DisplayModeListBox"/>

   </form>

</body>
</html>

Комментарии

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

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

Примечание

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

Используйте свойство , Target чтобы указать фрейм или окно, в котором отображается веб-страница, с которым связана гиперссылка в элементе BulletedList управления. Чтобы отобразить содержимое элементов списка в виде гиперссылок в элементе BulletedList управления, присвойте свойству BulletedListDisplayMode значение HyperLink. Затем задайте Value для свойства каждого элемента списка URL-адрес веб-страницы для перехода.

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

Примечание

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

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

Значение этого свойства хранится в состоянии представления.

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

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