MenuItemBinding.FormatString Egenskap

Definition

Namnområde:: System.Web.UI.WebControls

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Hämtar eller anger strängen som anger visningsformatet för texten i ett menyobjekt som MenuItemBinding objektet används på.

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

Egenskapsvärde

String

En formateringssträng som anger visningsformatet för texten i ett menyalternativ som MenuItemBinding används. Standardvärdet är en tom sträng (") som anger att den här egenskapen inte har angetts.

Exempel

Följande kodexempel visar hur du använder FormatString egenskapen för att formatera texten som visas i menyalternativen i en Menu kontroll. För att det här exemplet ska fungera korrekt måste du kopiera XML-exempeldata nedan till en fil med namnet 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>

Följande kod är exempel på webbplatsöversiktsdata för föregående exempel.

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

Kommentarer

Egenskapen FormatString används för att ange ett anpassat format för ett menyalternativs text. Formatsträngen kan bestå av en literalsträng, en platshållare eller båda. Strängen literal visas ordagrant, medan platshållaren ersätts med det värde som är bundet till menyalternativets text.

Platshållaren är uppdelad i två delar, avgränsade med ett kolon, i formuläret {A:Bxx}. Visar till exempel {0:F2} ett fast punktnummer med två decimaler.

Note

Platshållarsträngen måste omges av klammerparenteser för att indikera att den är en platshållare och inte en literalsträng. All text utanför klammerparenteserna visas som literaltext.

Med standardformateringssträngssyntaxen anger värdet före kolonet (A i det allmänna exemplet) parameterindexet i en nollbaserad lista med parametrar. Eftersom endast ett värde kan visas i varje menyalternativ kan parameterindexet endast anges till 0.

Tecknet efter kolonet (B i det allmänna exemplet) anger visningsformatet för värdet. I följande tabell visas de vanliga formaten.

Formattecken	Description
`C`	Visar numeriska värden i valutaformat.
`D`	Visar numeriska värden i decimalformat.
`E`	Visar numeriska värden i vetenskapligt (exponentiellt) format.
`F`	Visar numeriska värden i fast format.
`G`	Visar numeriska värden i allmänt format.
`N`	Visar numeriska värden i talformat.
`X`	Visar numeriska värden i hexadecimalt format.

Note

Formattecken är inte skiftlägeskänsliga, förutom X, som visar hexadecimala tecken i det angivna fallet.

Värdet efter formattecknet (xx i det allmänna exemplet) anger antalet signifikanta siffror eller decimaler som ska visas.

Mer information om formateringssträngar finns i Formateringstyper.

Värdet för den här egenskapen kan när den anges sparas automatiskt i en resursfil med hjälp av ett designerverktyg. Mer information finns i LocalizableAttribute globalisering och lokalisering.

Gäller för

Se även

Feedback

Var den här sidan till hjälp?