Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe MenuItemBinding

 

Data di pubblicazione: ottobre 2016

Definisce la relazione tra un elemento dati e la voce di menu a cui è associato in un controllo Menu. Questa classe non può essere ereditata.

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

System.Object
  System.Web.UI.WebControls.MenuItemBinding

public sealed class MenuItemBinding : IStateManager, ICloneable, 
	IDataSourceViewSchemaAccessor

NomeDescrizione
System_CAPS_pubmethodMenuItemBinding()

Inizializza una nuova istanza della classe MenuItemBinding.

NomeDescrizione
System_CAPS_pubpropertyDataMember

Ottiene o imposta il membro dati da associare a una voce di menu.

System_CAPS_pubpropertyDepth

Ottiene o imposta la profondità del menu in cui il MenuItemBinding è applicato l'oggetto.

System_CAPS_pubpropertyEnabled

Ottiene o imposta un valore che indica se la voce di menu in cui il MenuItemBinding è applicato l'oggetto è abilitato, consentendo l'elemento per visualizzare un'immagine popout e qualsiasi oggetto figlio voci di menu.

System_CAPS_pubpropertyEnabledField

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

System_CAPS_pubpropertyFormatString

Ottiene o imposta la stringa che specifica il formato di visualizzazione per il testo di una voce di menu in cui il MenuItemBinding è applicato l'oggetto.

System_CAPS_pubpropertyImageUrl

Ottiene o imposta l'URL di un'immagine che viene visualizzata accanto al testo di una voce di menu in cui il MenuItemBinding è applicato l'oggetto.

System_CAPS_pubpropertyImageUrlField

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

System_CAPS_pubpropertyNavigateUrl

Ottiene o imposta l'URL a cui collegarsi quando una voce di menu in cui il MenuItemBinding è applicato l'oggetto si fa clic.

System_CAPS_pubpropertyNavigateUrlField

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

System_CAPS_pubpropertyPopOutImageUrl

Ottiene o imposta l'URL di un'immagine che indica la presenza di un sottomenu dinamico per una voce di menu in cui il MenuItemBinding è applicato l'oggetto.

System_CAPS_pubpropertyPopOutImageUrlField

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

System_CAPS_pubpropertySelectable

Ottiene o imposta un valore che indica se la voce di menu in cui il MenuItemBinding è applicato l'oggetto può essere selezionato, o "selezionabile".

System_CAPS_pubpropertySelectableField

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

System_CAPS_pubpropertySeparatorImageUrl

Ottiene o imposta l'URL di un'immagine visualizzata sotto il testo di una voce di menu (per separarle da altre voci di menu) per una voce di menu in cui il MenuItemBinding è applicato l'oggetto.

System_CAPS_pubpropertySeparatorImageUrlField

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

System_CAPS_pubpropertyTarget

Ottiene o imposta la finestra di destinazione o il frame in cui visualizzare il contenuto della pagina Web associato a una voce di menu in cui il MenuItemBinding è applicato l'oggetto.

System_CAPS_pubpropertyTargetField

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

System_CAPS_pubpropertyText

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

System_CAPS_pubpropertyTextField

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

System_CAPS_pubpropertyToolTip

Ottiene o imposta il testo della descrizione comando per una voce di menu in cui il MenuItemBinding è applicato l'oggetto.

System_CAPS_pubpropertyToolTipField

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

System_CAPS_pubpropertyValue

Ottiene o imposta un valore non visualizzato utilizzato per archiviare dati aggiuntivi relativi a una voce di menu in cui il MenuItemBinding è applicato l'oggetto, ad esempio i dati utilizzati per la gestione degli eventi di postback.

System_CAPS_pubpropertyValueField

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

NomeDescrizione
System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente. (Esegue l'override di Object.ToString().)

NomeDescrizione
System_CAPS_pubinterfaceSystem_CAPS_privmethodICloneable.Clone()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Crea una copia di MenuItemBinding oggetto.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

Carica il nodo precedentemente salvato lo stato di visualizzazione.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Salva la vista stato viene modificato in un Object.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Indica il MenuItemBinding oggetto delle modifiche apportate al relativo stato di visualizzazione.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataSourceViewSchemaAccessor.DataSourceViewSchema

Per una descrizione di questo membro, vedere DataSourceViewSchema.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

Questa API supporta l'infrastruttura prodotto e non può essere usata direttamente dal codice. Ottiene un valore che indica se il MenuItemBinding oggetto Salva le modifiche apportate al relativo stato di visualizzazione.

Quando il Menu è associato a un'origine dati in cui ogni elemento di dati contiene più campi (ad esempio, un elemento XML con diversi attributi), se non sono definite alcun associazioni delle voci di menu, una voce di menu viene visualizzato il valore restituito dal ToString() metodo dell'elemento di dati per impostazione predefinita. Nel caso di un elemento XML, la voce di menu Visualizza il nome dell'elemento, che mostra la struttura sottostante del menu di scelta, ma non è molto utile in caso contrario. È possibile associare le proprietà di una voce di menu a un campo specifico, specificando le associazioni delle voci di menu. Oggetto MenuItemBinding oggetto definisce la relazione tra ogni elemento di dati e la voce di menu è associato.

System_CAPS_noteNota

Quando il Menu è associato a un SiteMapDataSource controllo, le associazioni delle voci di menu non hanno alcun effetto. Associazione viene eseguita automaticamente utilizzando il provider di mappa del sito.

Il Menu controllare archivi relativo MenuItemBinding gli oggetti di DataBindings proprietà e applica le associazioni all'origine dati per creare una relazione uno a uno tra la gerarchia di menu e la gerarchia di origine dati. Per ogni elemento di dati nell'origine dati, il Menu controllo tenta di individuare l'elemento di dati per un MenuItemBinding oggetto da creare corrispondente MenuItem oggetto.

Quando si crea un MenuItemBinding dell'oggetto, è necessario specificare i criteri di associazione. I criteri indicano quando un elemento di dati deve essere associato a una voce di menu. È possibile specificare il Depth, DataMember, o entrambi.

Una profondità di voce di menu specifica il livello di menu che viene associato. Ad esempio, MenuItemBinding dichiarazione associa i campi nome e l'ID dell'origine dati per il Text e Value proprietà, rispettivamente, di tutti i nodi con una profondità pari a 0:

<asp:MenuItemBinding Depth="0" TextField="Name" ValueField="ID">

Un membro dati specifica il tipo di elemento di dati nell'origine dati sottostante, ma può rappresentare informazioni diverse a seconda dell'origine dati. Ogni elemento di dati in un'origine dati gerarchica (rappresentato da un IHierarchyData oggetto) espone una Type proprietà, che specifica il tipo di elemento di dati. Ad esempio, il membro dati per un elemento XML specifica il nome dell'elemento. Quando un'origine dati contiene più tipi di elemento di dati, il membro dati specifica i dati dell'elemento del tipo da utilizzare. Le operazioni seguenti MenuItemBinding dichiarazione associa il <Book> elementi di un XmlDataSource controllo per tutte le voci di menu nel menu, indipendentemente dalla posizione nella gerarchia:

<asp:MenuItemBinding DataMember="Book" TextField="Title" ValueField= "ISBN">

In alcuni casi si potrebbe essere necessario creare un'associazione di voci di menu che specifica una profondità e un membro dati. Viene spesso utilizzata quando l'origine dati contiene gli elementi a livelli diversi che hanno lo stesso valore di membro dati. Ad esempio, è possibile <Item> gli elementi presenti a diversi livelli all'interno di un file XML. Nell'esempio MenuItemBinding dichiarazioni viene descritto come specificare associazioni delle voci di menu che si applicano a dati identici membri profondità di menu diverse:

<asp:MenuItemBinding DataMember="Item" Depth="1" TextField="Title">

<asp:MenuItemBinding DataMember="Item" Depth="2" TextField="ISBN">

Se un'associazione di voci di menu viene definita senza una profondità e un membro dati, l'associazione di voce di menu viene applicata a tutte le voci del menu. Viene in genere utilizzato quando tutti gli elementi di dati con le stesse proprietà e devono essere visualizzati in modo identico, indipendentemente dalla profondità del menu.

Dopo aver stabiliti i criteri di associazione, è quindi possibile associare una proprietà di un MenuItem oggetto che può essere associato a un valore. È possibile associare a un campo di un elemento di dati o in un valore statico. Quando è associato a un valore statico, tutti MenuItem oggetti a cui il MenuItemBinding è applicato l'oggetto condividono lo stesso valore. Le proprietà associate ai campi contengono i valori del campo corrispondente dall'origine dati.

System_CAPS_noteNota

È possibile ignorare in modo selettivo una proprietà associata in un MenuItem oggetto impostando direttamente la proprietà corrispondente.

Nella tabella seguente sono elencate le proprietà del MenuItemBinding che consentono di associare una proprietà di classe di MenuItem oggetto a un campo di un elemento di dati.

Proprietà

Descrizione

ImageUrlField

Il campo da associare il ImageUrl proprietà di un MenuItem oggetto.

NavigateUrlField

Il campo da associare il NavigateUrl proprietà di un MenuItem oggetto.

TextField

Il campo da associare il Text proprietà di un MenuItem oggetto.

ToolTipField

Il campo da associare il ToolTip proprietà di un MenuItem oggetto.

ValueField

Il campo da associare il Value proprietà di un MenuItem oggetto.

Nella tabella seguente sono elencate le proprietà del MenuItemBinding che consentono di associare una proprietà di classe di MenuItem oggetto in un valore statico.

Proprietà

Descrizione

ImageUrl

Il valore statico da associare il ImageUrl proprietà di un MenuItem oggetto.

NavigateUrl

Il valore statico da associare il NavigateUrl proprietà di un MenuItem oggetto.

Target

Il valore statico da associare il Target proprietà di un MenuItem oggetto.

Text

Il valore statico da associare il Text proprietà di un MenuItem oggetto.

ToolTip

Il valore statico da associare il ToolTip proprietà di un MenuItem oggetto.

Value

Il valore statico da associare il Value proprietà di un MenuItem oggetto.

Se in conflitto MenuItemBinding sono definiti oggetti, il Menu controllo Applica le associazioni di voci di menu nel seguente ordine di precedenza:

  1. Il MenuItemBinding oggetto che definisce e corrisponde a una profondità e un membro dati.

  2. Il MenuItemBinding oggetto che definisce e corrisponde solo al membro dati.

  3. Il MenuItemBinding oggetto che definisce e corrisponde solo alla profondità.

  4. Il MenuItemBinding oggetto che definisce la profondità né il membro dati. (Questo tipo di associazione di voce di menu viene applicato a tutte le voci di menu nel menu).

  5. Il MenuItemBinding oggetto che dispone di una corrispondenza nell'origine dati. In questo caso, il valore restituito dal ToString() metodo dell'elemento di dati viene quindi associato al Text e Value delle voci di menu in cui il MenuItemBinding è applicato l'oggetto.

La MenuItemBinding classe consente inoltre di formattare il testo visualizzato in una voce di menu impostando la FormatString proprietà.

Esempio di codice seguente viene illustrato come utilizzare MenuItemBinding oggetti per definire la relazione tra i campi di un XmlDataSource controllo e le voci di menu in un Menu controllo. Per eseguire l'esempio funzioni correttamente, è necessario copiare i dati XML di esempio seguente in un file denominato menu.


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

Il codice seguente è dati 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
Disponibile da 2.0

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: