Sdílet prostřednictvím

MenuItemBinding.FormatString Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví řetězec, který určuje formát zobrazení pro text položky nabídky, na kterou MenuItemBinding je objekt použit.

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

Hodnota vlastnosti

String

Formátovací řetězec, který určuje formát zobrazení pro text položky nabídky, na kterou MenuItemBinding je použit. Výchozí hodnota je prázdný řetězec (""), který označuje, že tato vlastnost není nastavena.

Příklady

Následující příklad kódu ukazuje, jak použít FormatString vlastnost k formátování textu zobrazeného v položkách nabídky ovládacího prvku Menu . Aby tento příklad fungoval správně, musíte zkopírovat níže uvedená ukázková data XML do souboru s názvem 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>

Následující kód představuje ukázková data mapy webu pro předchozí příklad.

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

Poznámky

Vlastnost FormatString slouží k poskytnutí vlastního formátu pro text položky nabídky. Formátovací řetězec může obsahovat řetězec literálu, zástupný symbol nebo obojí. Literálový řetězec se zobrazí doslovně, zatímco zástupný symbol se nahradí hodnotou, která je vázaná na text položky nabídky.

Zástupný symbol je rozdělený na dvě části oddělené dvojtečkami ve tvaru {A:Bxx}. {0:F2} Například zobrazí číslo s pevnou desetinnou čárkou se dvěma desetinnými místy.

Poznámka

Zástupný řetězec musí být uzavřený ve složených závorkách, aby bylo možné označit, že se jedná o zástupný text, a ne o řetězec literálu. Jakýkoli text mimo složené závorky se zobrazí jako literálový text.

Při zachování standardní syntaxe formátovacích řetězců určuje hodnota před dvojtečka (A v obecném příkladu) index parametru v seznamu parametrů založeném na nule. Vzhledem k tomu, že v každé položce nabídky může být zobrazena pouze jedna hodnota, index parametru lze nastavit pouze na hodnotu 0.

Znak za dvojtečka (B v obecném příkladu) určuje formát zobrazení hodnoty. Následující tabulka obsahuje seznam běžných formátů.

Formát znaku Description
C Zobrazí číselné hodnoty ve formátu měny.
D Zobrazí číselné hodnoty v desítkovém formátu.
E Zobrazí číselné hodnoty ve vědeckém (exponenciálním) formátu.
F Zobrazí číselné hodnoty v pevném formátu.
G Zobrazí číselné hodnoty v obecném formátu.
N Zobrazí číselné hodnoty v číselném formátu.
X Zobrazí číselné hodnoty v šestnáctkovém formátu.

Poznámka

Formátové znaky nerozlišují velká a malá písmena, s výjimkou Xpříkazu , který v zadaných případech zobrazuje šestnáctkové znaky.

Hodnota za formátovacím znakem (xx v obecném příkladu) určuje počet platných číslic nebo desetinných míst, která se mají zobrazit.

Další informace o formátování řetězců najdete v tématu Typy formátování.

Hodnota této vlastnosti, je-li nastavena, lze automaticky uložit do souboru prostředků pomocí nástroje návrháře. Další informace najdete v tématech LocalizableAttribute a Globalizace a lokalizace.

Platí pro

Viz také