Aracılığıyla paylaş

MenuItemBinding.FormatString Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Nesnenin uygulandığı menü öğesinin metni için görüntüleme biçimini belirten dizeyi MenuItemBinding alır veya ayarlar.

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

Özellik Değeri

String

Uygulandığı menü öğesinin MenuItemBinding metni için görüntüleme biçimini belirten biçimlendirme dizesi. Varsayılan, bu özelliğin ayarlanmadığını gösteren boş bir dizedir ("").

Örnekler

Aşağıdaki kod örneği, bir denetimin FormatString menü öğelerinde görüntülenen metni biçimlendirmek için özelliğinin Menu nasıl kullanılacağını gösterir. Bu örneğin düzgün çalışması için aşağıdaki örnek XML verilerini Menu.xml adlı bir dosyaya kopyalamanız gerekir.


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

Aşağıdaki kod, önceki örnekteki örnek site haritası verileridir.

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

Açıklamalar

FormatString özelliği, menü öğesinin metni için özel bir biçim sağlamak için kullanılır. Biçim dizesi değişmez değer dizesi, yer tutucu veya her iki dizeden oluşabilir. Sabit dize tam olarak görüntülenirken yer tutucu, menü öğesinin metnine bağlı değerle değiştirilir.

Yer tutucu, {A:Bxx} biçiminde iki bölüme ayrılır ve iki nokta üst üste ile ayrılır. Örneğin, {0:F2} iki ondalık basamaklı sabit noktalı bir sayı görüntüler.

Not

Yer tutucu dize, değişmez değer dizesi değil yer tutucu olduğunu belirtmek için küme ayraçları içine alınmalıdır. Ayraçların dışındaki tüm metinler değişmez metin olarak görüntülenir.

Standart biçimlendirme dizesi söz dizimini koruyarak, iki nokta üst üsteden önceki değer (A genel örnekte) parametre dizinini sıfır tabanlı bir parametre listesinde belirtir. Her menü öğesinde yalnızca bir değer görüntülenebildiği için parametre dizini yalnızca 0 olarak ayarlanabilir.

İki nokta üst üste işaretinden sonraki karakter (B genel örnekte) değerin görüntüleme biçimini belirtir. Aşağıdaki tabloda ortak biçimler listeledik.

Karakter biçimlendirme Description
C Sayısal değerleri para birimi biçiminde görüntüler.
D Sayısal değerleri ondalık biçimde görüntüler.
E Sayısal değerleri bilimsel (üstel) biçimde görüntüler.
F Sayısal değerleri sabit biçimde görüntüler.
G Sayısal değerleri genel biçimde görüntüler.
N Sayısal değerleri sayı biçiminde görüntüler.
X Sayısal değerleri onaltılık biçimde görüntüler.

Not

Biçim karakterleri, belirtilen durumda onaltılık karakterleri görüntüleyen dışında Xbüyük/küçük harfe duyarlı değildir.

Biçim karakterinden sonraki değer (xx genel örnekte) görüntülenecek anlamlı basamak veya ondalık basamak sayısını belirtir.

Dizeleri biçimlendirme hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.

Bu özelliğin değeri ayarlandığında, bir tasarımcı aracı kullanılarak otomatik olarak bir kaynak dosyasına kaydedilebilir. Daha fazla bilgi için bkz LocalizableAttribute . ve Genelleştirme ve Yerelleştirme.

Şunlara uygulanır

Ayrıca bkz.