MenuItemBinding.Target Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur jendela target atau bingkai untuk menampilkan isi halaman Web yang terkait dengan item menu tempat MenuItemBinding objek diterapkan.

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

Nilai Properti

String

Jendela target atau bingkai untuk menampilkan isi halaman Web yang ditautkan. Nilai default adalah string kosong (""), yang me-refresh jendela atau bingkai dengan fokus.

Contoh

Contoh kode berikut menunjukkan cara menggunakan Target properti untuk menentukan jendela tempat menampilkan konten Web yang terkait dengan item menu, saat item menu tersebut diklik. Agar contoh ini berfungsi dengan benar, Anda harus menyalin contoh data XML di bawah ini ke file bernama Menu.xml.


<%@ 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>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <DataBindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            formatstring="({0})" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            formatstring="[{0}]" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            formatstring="<{0}>" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </DataBindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

    </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>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <DataBindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            formatstring="({0})" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            formatstring="[{0}]" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            formatstring="<{0}>" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </DataBindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

    </form>
  </body>
</html>

Kode berikut adalah contoh data peta situs untuk contoh sebelumnya.

<MapHomeNode ImageUrl="~\Images\Home.gif"

Title="Home"

Description="Root Page"

ToolTip="Home Page">

<MapNode ImageUrl="~\Images\Music.gif"

Title="Music"

Description="Music Category"

ToolTip="Music Page">

<MapNode ImageUrl="~\Images\Classical.gif"

Title="Classical"

Description="Classical Section"

ToolTip="Classical Page"/>

<MapNode ImageUrl="~\Images\Rock.gif"

Title="Rock"

Description="Rock Section"

ToolTip="Rock Page"/>

<MapNode ImageUrl="~\Images\Jazz.gif"

Title="Jazz"

Description="Jazz Section"

ToolTip="Jazz Page"/>

</MapNode>

<MapNode ImageUrl="~\Images\Movies.gif"

Title="Movies"

Description="Movies Category"

ToolTip="Movies Page">

<MapNode ImageUrl="~\Images\Action.gif"

Title="Action"

Description="Action Section"

ToolTip="Action Page"/>

<MapNode ImageUrl="~\Images\Drama.gif"

Title="Drama"

Description="Drama Section"

ToolTip="Drama Page"/>

<MapNode ImageUrl="~\Images\Musical.gif"

Title="Musical"

Description="Musical Section"

ToolTip="Musical Page"/>

</MapNode>

</MapHomeNode>

Keterangan

Menu Ketika kontrol terikat ke sumber data, gunakan Target properti untuk menentukan jendela atau bingkai untuk menampilkan konten Web yang ditautkan ke item menu saat item menu tersebut diklik.

Catatan

Mengatur properti ini mengambil alih Menu.Target properti Menu kontrol untuk item menu tempat MenuItemBinding objek diterapkan. Anda dapat secara selektif mengambil alih properti ini dengan mengatur MenuItem.Target properti dari setiap item menu secara langsung.

Nilai target harus dimulai dengan huruf dalam rentang A hingga Z (tidak peka huruf besar/kecil), kecuali untuk nilai khusus tertentu yang dimulai dengan garis bawah, seperti yang diperlihatkan dalam tabel berikut.

Nilai target	Deskripsi
`_blank`	Merender konten di jendela baru tanpa bingkai.
`_parent`	Merender konten dalam induk frameset langsung.
`_search`	Merender konten di panel pencarian.
`_self`	Merender konten dalam bingkai dengan fokus.
`_top`	Merender konten di jendela penuh tanpa bingkai.

Catatan

Periksa dokumentasi browser Anda untuk menentukan apakah _search nilainya didukung. Misalnya, Microsoft Internet Explorer 5.0 dan yang lebih baru mendukung _search nilai target.

Catatan

Properti Target dirender sebagai target atribut. Atribut target pada anchor elemen tidak diizinkan dalam definisi jenis dokumen XHTML 1.1. Jangan atur Target properti jika output yang dirender untuk MenuItemBinding objek harus sesuai dengan XHTML 1.1. Untuk informasi selengkapnya, lihat topik Standar XHTML di Visual Studio dan ASP.NET.

Saat membuat halaman Web yang dapat diakses, sangat disarankan agar Anda menghindari penggunaan Target properti untuk menargetkan jendela lain. Untuk informasi selengkapnya, lihat aksesibilitas ASP.NET.

Berlaku untuk

Bagikan melalui

MenuItemBinding.Target Properti

Definisi

Nilai Properti

Contoh

Keterangan

Berlaku untuk

Lihat juga

Sumber Daya Tambahan: