Esporta (0) Stampa
Espandi tutto

Proprietà MenuItemBinding.Text

Nota: questa proprietà è stata introdotta con .NET Framework versione 2.0.

Ottiene o imposta il testo visualizzato per la voce di menu a cui è applicato l'oggetto MenuItemBinding.

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

[LocalizableAttribute(true)] 
public string Text { get; set; }
/** @property */
public String get_Text ()

/** @property */
public void set_Text (String value)

public function get Text () : String

public function set Text (value : String)

Valore proprietà

Testo visualizzato per la voce di menu 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à Text per specificare il testo da associare alla proprietà MenuItem.Text di un oggetto MenuItem. Questo testo viene visualizzato in una voce di menu e viene condiviso con tutte le voci di menu a cui è applicato l'oggetto MenuItemBinding.

NotaNota

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

Anzichè utilizzare questa proprietà per visualizzare lo stesso testo per ciascuna voce di menu, è anche possibile associare la proprietà Text di un oggetto MenuItem a un campo di un'origine dati impostando la proprietà TextField. 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.

NotaNota

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

Non è possibile creare nodi vuoti in un controllo Menu impostando le 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 Tecniche di associazione ai dati in una pagina Web.

Il valore di questa proprietà, se impostato, può essere salvato automaticamente in un file di risorse utilizzando uno strumento di progettazione. Per ulteriori informazioni, vedere LocalizableAttribute e Globalizzazione e localizzazione ASP.NET.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà Text per specificare il testo da visualizzare in una voce di menu. Questo testo viene visualizzato in ciascuna voce di menu a cui è applicato l'oggetto MenuItemBinding. Perché questo esempio funzioni correttamente, è necessario copiare i dati XML di esempio che seguono in un file denominato Menu.xml.


<%@ page language="C#" %>

<html>
  <body>
    <form runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <databindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            text="Static Title"
            value="Static Description"
            imageurl="~\Images\StaticImage.jpg"
            tooltip="Static ToolTip"/>
          
        </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 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supportato in: 2.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2015 Microsoft