MenuItemBinding.FormatString Свойство

Ссылка

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Получает или задает строку, определяющую формат отображения текста пункта меню, к которому применяется объект MenuItemBinding.

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

Значение свойства

String

Строка форматирования, определяющая формат отображения пункта меню, к которому применяется объект MenuItemBinding. По умолчанию используется пустая строка (""), указывающая, что это свойство не задано.

Примеры

В следующем примере кода показано, как использовать FormatString свойство для форматирования текста, отображаемого Menu в пунктах меню элемента управления. Для правильной работы этого примера необходимо скопировать приведенные ниже примеры XML-данных в файл с именем 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>

Следующий код является примером данных карты сайта для предыдущего примера.

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

Свойство FormatString используется для предоставления настраиваемого формата для текста элемента меню. Строка формата может состоять из литеральной строки, заполнителя или обоих. Литералная строка отображается подробно, а заполнитель заменяется значением, привязанным к тексту элемента меню.

Заполнитель разделен на две части, разделенные двоеточием в форме {A:Bxx}. Например, {0:F2} отображается число фиксированной точки с двумя десятичными знаками.

Примечание

Строка заполнителя должна быть заключена в фигурные скобки, чтобы указать, что это заполнитель, а не литералная строка. Любой текст за пределами фигурных скобок отображается как литеральный текст.

При сохранении стандартного синтаксиса строки форматирования значение перед двоеточием (A в общем примере) указывает индекс параметров в отсчитываемом от нуля списке параметров. Так как в каждом пункте меню может отображаться только одно значение, индекс параметров можно задать только 0.

Символ после двоеточия (B в общем примере) задает формат отображения значения. В следующей таблице перечислены распространенные форматы.

Символ форматирования	Описание
`C`	Отображает числовые значения в формате валюты.
`D`	Отображает числовые значения в десятичном формате.
`E`	Отображает числовые значения в формате экспоненциального формата.
`F`	Отображает числовые значения в фиксированном формате.
`G`	Отображает числовые значения в общем формате.
`N`	Отображает числовые значения в числовом формате.
`X`	Отображает числовые значения в шестнадцатеричном формате.

Примечание

Символы формата не чувствительны к регистру, за исключением Xсимволов, которые отображают шестнадцатеричные символы в указанном случае.

Значение после символа формата (xx в общем примере) указывает количество значимых цифр или десятичных разрядов для отображения.

Дополнительные сведения о форматировании строк см. в статье Общие сведения о форматировании.

Значение этого свойства при установке может быть автоматически сохранено в файле ресурсов с помощью средства конструктора. Дополнительные сведения см. в разделе LocalizableAttribute и глобализации и локализации.

Применяется к

MenuItemBinding.FormatString Свойство

Определение

Значение свойства

Примеры

Комментарии

Применяется к

См. также раздел

Дополнительные ресурсы