MenuItemBinding.ToolTipField Właściwość

Definicja

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

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

Wartość właściwości

String

Nazwa pola do powiązania z, ToolTip MenuItem do którego MenuItemBinding ma zostać zastosowany.The name of the field to bind to the ToolTip 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, ToolTipField Aby określić nazwę pola do powiązania z ToolTip właściwością elementu menu.The following code example demonstrates how to use the ToolTipField property to specify the name of the field to bind to the ToolTip 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 ToolTipField właściwości, aby określić nazwę pola, które ma być powiązane z ToolTip właściwością MenuItem obiektu.When the Menu control is bound to a data source, use the ToolTipField property to specify the name of the field to bind to the ToolTip property of a MenuItem object. Po wyrenderowaniu ToolTip Właściwość każdego elementu menu, do którego MenuItemBinding zastosowano obiekt, zawiera odpowiednią wartość z pola.When rendered, the ToolTip property of each menu item to which the MenuItemBinding object is applied contains the corresponding value from the field. Określony tekst jest wyświetlany, gdy użytkownik umieści wskaźnik myszy nad elementem menu.The specified text is displayed when the user positions the mouse pointer over a menu item.

Uwaga

Można zastąpić tekst dla pojedynczego elementu menu, ustawiając jego ToolTip Właściwość bezpośrednio.You can override the text for an individual menu item by setting its ToolTip 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 ToolTip właściwości MenuItem obiektu z polem, można również powiązać ją z wartością statyczną przez ustawienie MenuItemBinding.ToolTip właściwości.Instead of using this property to bind the ToolTip property of a MenuItem object to a field, you can also bind it to a static value by setting the MenuItemBinding.ToolTip property. Pozwala to wyświetlić tę samą etykietkę narzędzia dla każdego elementu menu, do którego MenuItemBinding zastosowano obiekt.This allows you to display the same ToolTip for each menu item to which the MenuItemBinding object is applied.

Uwaga

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

Dotyczy

Zobacz też