Questa documentazione è stata archiviata e non viene gestita.

Proprietà MenuItemBinding.ToolTipField

Aggiornamento: novembre 2007

Ottiene o imposta il nome del campo dall'origine dati per l'associazione alla proprietà ToolTip di un oggetto MenuItem a cui è applicato l'oggetto MenuItemBinding.

Spazio dei nomi:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

[TypeConverterAttribute("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ToolTipField { get; set; }
/** @property */
/** @attribute TypeConverterAttribute("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") */
public String get_ToolTipField()
/** @property */
/** @attribute TypeConverterAttribute("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") */
public  void set_ToolTipField(String value)

public function get ToolTipField () : String
public function set ToolTipField (value : String)

Valore proprietà

Tipo: System.String

Nome del campo da associare alla proprietà ToolTip di un oggetto MenuItem a cui è applicato l'oggetto MenuItemBinding. Il valore predefinito è una stringa vuota (""), a indicare che questa proprietà non è impostata.

Quando il controllo Menu è associato a un'origine dati, utilizzare la proprietà ToolTipField per specificare il nome del campo da associare alla proprietà ToolTip di un oggetto MenuItem. Quando si esegue il rendering, la proprietà ToolTip di ciascuna voce di menu a cui è applicato l'oggetto MenuItemBinding contiene il valore corrispondente dal campo. Il testo specificato viene visualizzato quando l'utente posiziona il puntatore del mouse su una voce di menu.

Nota:

È possibile eseguire l'override di una singola voce di menu impostandone direttamente la proprietà ToolTip.

Se l'origine dati contiene più tabelle o attributi, è necessario innanzitutto stabilire i criteri di associazione impostando la proprietà Depth, la proprietà DataMember o entrambe.

Anziché utilizzare questa proprietà per associare la proprietà ToolTip di un oggetto MenuItem a un campo, è anche possibile associarla a un valore statico tramite l'impostazione della proprietà MenuItemBinding.ToolTip. In questo modo è possibile visualizzare la stessa descrizione comandi per ciascuna voce di menu a cui è applicato l'oggetto MenuItemBinding.

Nota:

Se le proprietà ToolTip e ToolTipField sono entrambe impostate, la proprietà ToolTipField ha la precedenza.

Nell'esempio riportato di seguito viene illustrato come utilizzare la proprietà ToolTipField per specificare il nome del campo da associare alla proprietà ToolTip di una voce di menu. Perché questo esempio funzioni correttamente, è necessario copiare i dati XML di esempio che seguono in un file denominato 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>



Nel codice riportato di seguito sono riportati i dati della mappa del sito di esempio per l'esempio precedente.

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

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0
Mostra: