MenuItemBinding.TextField Właściwość

Definicja

Pobiera lub ustawia nazwę pola ze źródła danych, które ma zostać powiązane z Text 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 Text property of a MenuItem object to which the MenuItemBinding object is applied.

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

Wartość właściwości

String

Nazwa pola ze źródła danych, z którym ma zostać utworzone powiązanie Text MenuItem MenuItemBinding .The name of the field from the data source to bind to the Text 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, TextField Aby określić nazwę pola do powiązania z Text właściwością elementu menu.The following code example demonstrates how to use the TextField property to specify the name of the field to bind to the Text 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 TextField właściwości, aby określić nazwę pola, które ma być powiązane z Text właściwością MenuItem obiektu.When the Menu control is bound to a data source, use the TextField property to specify the name of the field to bind to the Text property of a MenuItem object. Po wyrenderowaniu Text Właściwość każdego elementu menu, do którego MenuItemBinding zastosowano obiekt, zawiera odpowiednią wartość z pola.When rendered, the Text property of each menu item to which the MenuItemBinding object is applied contains the corresponding value from the field. Ten tekst jest wyświetlany w elementach menu.This text is displayed in the menu items.

Uwaga

Można zastąpić tekst dla pojedynczego elementu menu, ustawiając jego Text Właściwość bezpośrednio.You can override the text for an individual menu item by setting its Text 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.

Nie można utworzyć pustych węzłów w Menu kontrolce przez ustawienie Text TextField właściwości lub na ciąg pusty ("").You cannot create empty nodes in a Menu control by setting the Text or TextField properties to the empty string (""). Ustawienie tych właściwości do pustego ciągu ma ten sam efekt, co ustawienie właściwości.Setting these properties to the empty string has the same effect as not setting the properties. W takim przypadku Menu formant tworzy domyślne powiązanie przy użyciu DataSource właściwości.In that case, the Menu control creates a default binding using the DataSource property. Aby uzyskać więcej informacji, zobacz ASP.net content Access map zawartości.For more information, see ASP.NET Data Access Content Map.

Zamiast używać tej właściwości do powiązania Text właściwości MenuItem obiektu z polem, można również powiązać ją z wartością statyczną przez ustawienie MenuItemBinding.Text właściwości.Instead of using this property to bind the Text property of a MenuItem object to a field, you can also bind it to a static value by setting the MenuItemBinding.Text property. Pozwala to wyświetlić ten sam tekst w każdym elemencie menu, do którego MenuItemBinding zastosowano obiekt.This allows you to display the same text in each menu item to which the MenuItemBinding object is applied.

Uwaga

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

Dotyczy

Zobacz też