MenuItemBinding.FormatString Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Zeichenfolge ab, mit der das Anzeigeformat für den Text eines Menüelements angegeben wird, für das das MenuItemBinding-Objekt übernommen wird, oder legt diese fest.

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

Eigenschaftswert

String

Eine Formatierungszeichenfolge, mit der das Anzeigeformat für den Text eines Menüelements angegeben wird, für das das MenuItemBinding übernommen wird. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die FormatString Eigenschaft verwenden, um den text zu formatieren, der in den Menüelementen eines Menu Steuerelements angezeigt wird. In diesem Beispiel müssen Sie die nachstehenden XML-Beispieldaten in eine Datei mit dem Namen "Menu.xml" kopieren.


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

Der folgende Code ist Beispiel-Websitezuordnungsdaten für das vorherige Beispiel.

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

Hinweise

Die FormatString Eigenschaft wird verwendet, um ein benutzerdefiniertes Format für den Text eines Menüelements bereitzustellen. Die Formatzeichenfolge kann aus einer Literalzeichenfolge, einem Platzhalter oder beidem bestehen. Die Literalzeichenfolge wird verbatimiert, während der Platzhalter durch den Wert ersetzt wird, der an den Text des Menüelements gebunden ist.

Der Platzhalter wird in zwei Teile unterteilt, getrennt durch einen Doppelpunkt, im Formular {A:Bxx}. Zeigt beispielsweise {0:F2} eine Feste Punktnummer mit zwei Dezimalstellen an.

Hinweis

Die Platzhalterzeichenfolge muss in Klammern eingeschlossen werden, um anzugeben, dass es sich um einen Platzhalter handelt und nicht um eine Literalzeichenfolge. Jeder Text außerhalb der Klammern wird als Literaltext angezeigt.

Wenn Sie die Syntax der Standardformatierungszeichenfolge beibehalten, gibt der Wert vor dem Doppelpunkt (A im allgemeinen Beispiel) den Parameterindex in einer nullbasierten Liste der Parameter an. Da nur ein Wert in jedem Menüelement angezeigt werden kann, kann der Parameterindex nur auf 0 festgelegt werden.

Das Zeichen nach dem Doppelpunkt (B im allgemeinen Beispiel) gibt das Anzeigeformat für den Wert an. In der folgenden Tabelle sind die allgemeinen Formate aufgeführt.

Zeichen formatieren	BESCHREIBUNG
`C`	Zeigt numerische Werte im Währungsformat an.
`D`	Zeigt numerische Werte im Dezimalformat an.
`E`	Zeigt numerische Werte im wissenschaftlichen (exponentiellen) Format an.
`F`	Zeigt numerische Werte im festen Format an.
`G`	Zeigt numerische Werte im allgemeinen Format an.
`N`	Zeigt numerische Werte im Zahlenformat an.
`X`	Zeigt numerische Werte im Hexadezimalformat an.

Hinweis

Die Formatzeichen sind nicht groß- und kleinschreibungsgeschützt, außer Xfür die Hexadezimalzeichen in dem angegebenen Fall.

Der Wert nach dem Formatzeichen (xx im allgemeinen Beispiel) gibt die Anzahl der zu anzeigenden signifikanten Ziffern oder Dezimalstellen an.

Weitere Informationen zum Formatieren von Zeichenfolgen finden Sie unter Formatierungstypen.

Der Wert dieser Eigenschaft, wenn festgelegt, kann mithilfe eines Designers Tools automatisch zu einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und Globalisierung und Lokalisierung.

Gilt für