MenuItemBinding.FormatString 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 string yang menentukan format tampilan untuk teks item menu tempat MenuItemBinding objek diterapkan.

public:
 property System::String ^ FormatString { System::String ^ get(); void set(System::String ^ value); };

public string FormatString { get; set; }

member this.FormatString : string with get, set

Public Property FormatString As String

Nilai Properti

String

String pemformatan yang menentukan format tampilan untuk teks item menu tempat MenuItemBinding diterapkannya. Defaultnya adalah string kosong (""), yang menunjukkan bahwa properti ini tidak diatur.

Contoh

Contoh kode berikut menunjukkan cara menggunakan FormatString properti untuk memformat teks yang ditampilkan dalam item Menu menu kontrol. 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

Properti FormatString digunakan untuk menyediakan format kustom untuk teks item menu. String format dapat terdiri dari string harfiah, tempat penampung, atau keduanya. String harfiah ditampilkan verbatim, sementara tempat penampung diganti dengan nilai yang terikat ke teks item menu.

Tempat penampung dibagi menjadi dua bagian, dipisahkan oleh titik dua, dalam bentuk {A:Bxx}. Misalnya, {0:F2} menampilkan angka titik tetap dengan dua tempat desimal.

Catatan

String tempat penampung harus diapit kurung kurawal untuk menunjukkan bahwa string tersebut adalah tempat penampung dan bukan string harfiah. Teks apa pun di luar kurung kurawal ditampilkan sebagai teks harfiah.

Mempertahankan sintaks string pemformatan standar, nilai sebelum titik dua (A dalam contoh umum) menentukan indeks parameter dalam daftar parameter berbasis nol. Karena hanya satu nilai yang dapat ditampilkan di setiap item menu, indeks parameter hanya dapat diatur ke 0.

Karakter setelah titik dua (B dalam contoh umum) menentukan format tampilan untuk nilai . Tabel berikut ini mencantumkan format umum.

Format karakter	Deskripsi
`C`	Menampilkan nilai numerik dalam format mata uang.
`D`	Menampilkan nilai numerik dalam format desimal.
`E`	Menampilkan nilai numerik dalam format ilmiah (eksponensial).
`F`	Menampilkan nilai numerik dalam format tetap.
`G`	Menampilkan nilai numerik dalam format umum.
`N`	Menampilkan nilai numerik dalam format angka.
`X`	Menampilkan nilai numerik dalam format heksadesimal.

Catatan

Karakter format tidak peka huruf besar/kecil, kecuali , Xyang menampilkan karakter heksadesimal dalam kasus yang ditentukan.

Nilai setelah karakter format (xx dalam contoh umum) menentukan jumlah digit signifikan atau tempat desimal untuk ditampilkan.

Untuk informasi selengkapnya tentang string pemformatan, lihat Jenis Pemformatan.

Nilai properti ini, ketika diatur, dapat disimpan secara otomatis ke file sumber daya dengan menggunakan alat perancang. Untuk informasi selengkapnya, lihat LocalizableAttribute dan Globalisasi dan Pelokalan.

Berlaku untuk

Bagikan melalui