MenuItemBinding.FormatString Vlastnost

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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 použití FormatString vlastnosti k formátování textu zobrazeného v položkách Menu nabídky ovládacího prvku. Aby tento příklad fungoval správně, musíte zkopírovat ukázková data XML níže 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

Tato FormatString vlastnost slouží k zadání vlastního formátu textu položky nabídky. Formátovací řetězec se může skládat z literálového řetězce, zástupného symbolu nebo obojího. 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ý do dvou částí oddělených dvojtečkami ve tvaru {A:Bxx}. Zobrazí například {0:F2} číslo s pevným bodem 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ý symbol, nikoli literálový řetězec. Libovolný text mimo složené závorky se zobrazí jako literálový text.

Zachování standardní syntaxe řetězce formátování určuje hodnota před dvojtečku (A v obecném příkladu) index parametrů v seznamu parametrů založených na nule. Protože v každé položce nabídky lze zobrazit pouze jednu hodnotu, index parametrů lze nastavit pouze na 0.

Znak za dvojtečku (B v obecném příkladu) určuje formát zobrazení hodnoty. Následující tabulka uvádí běžné formáty.

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:

Znaky formátu nerozlišují malá a velká písmena, s výjimkou Xznaků , které zobrazují šestnáctkové znaky v zadaném případě.

Hodnota za znakem formátu (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ů naleznete v tématu Typy formátování.

Hodnotu této vlastnosti lze při nastavení automaticky uložit do souboru prostředků pomocí nástroje návrháře. Další informace naleznete v tématu LocalizableAttribute a globalizace a lokalizace.

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?