MenuItemBinding.ValueField Właściwość

Definicja

Pobiera lub ustawia nazwę pola ze źródła danych, które ma zostać powiązane z Value właściwością MenuItem obiektu, do którego MenuItemBinding zastosowano obiekt.Gets or sets the name of the field from the data source to bind to the Value property of a MenuItem object to which the MenuItemBinding object is applied.

public:
 property System::String ^ ValueField { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ValueField { get; set; }
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ValueField { get; set; }
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ValueField : string with get, set
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ValueField : string with get, set
Public Property ValueField As String

Wartość właściwości

String

Nazwa pola do powiązania z, Value MenuItem do którego MenuItemBinding ma zostać zastosowany.The name of the field to bind to the Value of a MenuItem to which the MenuItemBinding is applied. Wartość domyślna to ciąg pusty (""), który wskazuje, że ta właściwość nie jest ustawiona.The default is an empty string (""), which indicates that this property is not set.

Atrybuty

Przykłady

Poniższy przykład kodu demonstruje, jak użyć właściwości, ValueField Aby określić nazwę pola do powiązania z Value właściwością elementu menu.The following code example demonstrates how to use the ValueField property to specify the name of the field to bind to the Value property of a menu item. Aby ten przykład działał prawidłowo, należy skopiować przykładowe dane XML poniżej do pliku o nazwie Menu.xml.For this example to work correctly, you must copy the sample XML data below to a file named 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>

Poniższy kod zawiera przykładowe dane mapy witryny dla poprzedniego przykładu.The following code is sample site map data for the previous example.

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

Uwagi

Gdy Menu formant jest powiązany ze źródłem danych, użyj ValueField właściwości, aby określić nazwę pola, które ma być powiązane z Value właściwością MenuItem obiektu.When the Menu control is bound to a data source, use the ValueField property to specify the name of the field to bind to the Value property of a MenuItem object. Po wyrenderowaniu Value Właściwość każdego elementu menu, do którego MenuItemBinding zastosowano obiekt, zawiera odpowiednią wartość z pola.When rendered, the Value property of each menu item to which the MenuItemBinding object is applied contains the corresponding value from the field. Określona wartość nie jest wyświetlana w elemencie menu i służy do przechowywania wszelkich dodatkowych danych dotyczących elementu menu, do którego MenuItemBinding zastosowano obiekt, takich jak dane używane do obsługi zdarzeń ogłaszania zwrotnego.The specified value is not displayed in a menu item and is used to store any additional data about a menu item to which the MenuItemBinding object is applied, such as data used for handling postback events.

Uwaga

Można zastąpić wartość dla pojedynczego elementu menu, ustawiając jego Value Właściwość bezpośrednio.You can override the value for an individual menu item by setting its Value property directly.

Jeśli źródło danych zawiera wiele tabel lub atrybutów, należy najpierw ustanowić kryteria powiązań przez ustawienie Depth właściwości, DataMember właściwości lub obu.If the data source contains multiple tables or attributes, you must first establish the binding criteria by setting the Depth property, the DataMember property, or both.

Zamiast używać tej właściwości do powiązania Value właściwości MenuItem obiektu z polem, można również powiązać ją z wartością statyczną przez ustawienie MenuItemBinding.Value właściwości.Instead of using this property to bind the Value property of a MenuItem object to a field, you can also bind it to a static value by setting the MenuItemBinding.Value property. Pozwala to określić tę samą wartość dla każdego elementu menu, do którego ma zostać MenuItemBinding zastosowany obiekt.This allows you to specify the same value for each menu item to which the MenuItemBinding object is applied.

Uwaga

Jeśli Value właściwości i ValueField są ustawione, ValueField Właściwość ma pierwszeństwo.If the Value and ValueField properties are both set, the ValueField property takes precedence.

Dotyczy

Zobacz też