MenuItemBinding.FormatString Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia ciąg określający format wyświetlania tekstu elementu menu, do którego MenuItemBinding jest stosowany obiekt.

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

Wartość właściwości

String

Ciąg formatowania określający format wyświetlania tekstu elementu menu, do którego MenuItemBinding jest stosowany. Wartość domyślna to pusty ciąg (""), który wskazuje, że ta właściwość nie jest ustawiona.

Przykłady

Poniższy przykład kodu pokazuje, jak używać FormatString właściwości do formatowania tekstu wyświetlanego w elementach menu kontrolki Menu . Aby ten przykład działał poprawnie, należy skopiować przykładowe dane XML poniżej do pliku o nazwie 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>

Poniższy kod to przykładowe dane mapy witryny dla poprzedniego przykładu.

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

Uwagi

Właściwość FormatString służy do udostępniania niestandardowego formatu tekstu elementu menu. Ciąg formatu może składać się z ciągu literału, symbolu zastępczego lub obu. Ciąg literału jest wyświetlany dosłownie, podczas gdy symbol zastępczy jest zastępowany wartością powiązaną z tekstem elementu menu.

Symbol zastępczy jest podzielony na dwie części oddzielone dwukropkiem w postaci {A:Bxx}. Na przykład {0:F2} wyświetla stałą liczbę z dwoma miejscami dziesiętnymi.

Uwaga

Ciąg zastępczy musi być ujęty w nawiasy klamrowe, aby wskazać, że jest symbolem zastępczym, a nie ciągiem literału. Dowolny tekst poza nawiasami klamrowych jest wyświetlany jako tekst literału.

Zachowując standardową składnię ciągu formatowania, wartość przed dwukropkiem (A w ogólnym przykładzie) określa indeks parametrów na liście parametrów opartych na zera. Ponieważ w każdym elemencie menu można wyświetlić tylko jedną wartość, indeks parametrów można ustawić tylko na wartość 0.

Znak po dwukropku (B w ogólnym przykładzie) określa format wyświetlania wartości. W poniższej tabeli wymieniono typowe formaty.

Formatuj znak Opis
C Wyświetla wartości liczbowe w formacie waluty.
D Wyświetla wartości liczbowe w formacie dziesiętny.
E Wyświetla wartości liczbowe w formacie naukowym (wykładniczym).
F Wyświetla wartości liczbowe w stałym formacie.
G Wyświetla wartości liczbowe w formacie ogólnym.
N Wyświetla wartości liczbowe w formacie liczbowym.
X Wyświetla wartości liczbowe w formacie szesnastkowym.

Uwaga

Znaki formatu nie są uwzględniane w wielkości liter, z wyjątkiem znaków szesnastkowej, z wyjątkiem Xznaków szesnastkowej w określonym przypadku.

Wartość po znaku formatu (xx w ogólnym przykładzie) określa liczbę cyfr znaczących lub miejsc dziesiętnych do wyświetlenia.

Aby uzyskać więcej informacji na temat formatowania ciągów, zobacz Formatting Types (Typy formatowania).

Wartość tej właściwości, po ustawieniu, można zapisać automatycznie w pliku zasobów przy użyciu narzędzia projektanta. Aby uzyskać więcej informacji, zobacz LocalizableAttribute temat Globalizacja i Lokalizacja.

Dotyczy

Zobacz też