Il presente articolo è stato tradotto manualmente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale.
Traduzione
Originale
Questo argomento non è stato ancora valutato - Valuta questo argomento

Proprietà MenuItemBinding.TextField

Ottiene o imposta il nome del campo dall'origine dati per l'associazione alla proprietà Text 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=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string TextField { get; set; }

Valore proprietà

Tipo: System.String
Nome del campo dell'origine dati da associare alla proprietà Text 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à TextField per specificare il nome del campo da associare alla proprietà Text di un oggetto MenuItem. Quando si esegue il rendering, la proprietà Text di ciascuna voce di menu a cui è applicato l'oggetto MenuItemBinding contiene il valore corrispondente dal campo. Questo testo viene visualizzato nelle voci di menu.

NotaNota

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

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.

Non è possibile creare nodi vuoti in un controllo Menu impostando la proprietà Text o TextField su una stringa vuota (""). L'effetto ottenuto impostando queste proprietà su una stringa vuota è identico all'effetto ottenuto quando queste proprietà non vengono impostate. In questo caso, il controllo Menu crea un'associazione predefinita utilizzando la proprietà DataSource. Per ulteriori informazioni, vedere Accesso ai dati tramite ASP.NET.

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

NotaNota

Se le proprietà Text e TextField sono entrambe impostate, la proprietà TextField ha la precedenza.

Nell'esempio riportato di seguito viene illustrato come utilizzare la proprietà TextField per specificare il nome del campo da associare alla proprietà Text 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>

.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Il documento è risultato utile?
(1500 caratteri rimanenti)

Aggiunte alla community

AGGIUNGI
© 2013 Microsoft. Tutti i diritti riservati.