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 die FormatString -Eigenschaft verwendet wird, um den Text zu formatieren, der in den Menüelementen eines Menu Steuerelements angezeigt wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die folgenden XML-Beispieldaten in eine Datei namens 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 enthält Beispiel-Siteübersichtsdaten 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 wörtlich angezeigt, während der Platzhalter durch den Wert ersetzt wird, der an den Text des Menüelements gebunden ist.

Der Platzhalter wird in zwei Teile geteilt, getrennt durch einen Doppelpunkt, im Format {A:Bxx}. Zeigt beispielsweise {0:F2} eine Festpunktzahl mit zwei Dezimalstellen an.

Hinweis

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

Unter Beibehaltung der Standardmäßigen Formatierungszeichenfolgensyntax gibt der Wert vor dem Doppelpunkt (A im allgemeinen Beispiel) den Parameterindex in einer nullbasierten Liste von Parametern an. Da in jedem Menüelement nur ein Wert 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 gängigen Formate aufgeführt.

Formatieren von Zeichen	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

Bei den Formatzeichen wird die Groß-/Kleinschreibung nicht beachtet, mit Ausnahme von X, das die Hexadezimalzeichen in der angegebenen Groß-/Kleinschreibung anzeigt.

Der Wert nach dem Formatzeichen (xx im allgemeinen Beispiel) gibt die Anzahl der anzuzeigenden 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:

Freigeben über