MenuItemBindingCollection Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente une collection d'objets MenuItemBinding.

public ref class MenuItemBindingCollection sealed : System::Web::UI::StateManagedCollection

public sealed class MenuItemBindingCollection : System.Web.UI.StateManagedCollection

type MenuItemBindingCollection = class
    inherit StateManagedCollection

Public NotInheritable Class MenuItemBindingCollection
Inherits StateManagedCollection

Héritage: Object

StateManagedCollection
MenuItemBindingCollection

Exemples

L’exemple de code suivant montre comment remplir un MenuItemBindingCollection objet de manière déclarative. Pour que cet exemple fonctionne correctement, vous devez copier l’exemple de données XML ci-dessous dans un fichier nommé Map.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>Menu DataBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu DataBindings Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        runat="server">
        
       <DataBindings>
        
          <asp:menuitembinding datamember="MapHomeNode" 
            depth="0"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            textfield="title" 
            navigateurlfield="url"/>
        </DataBindings>
        
      </asp:menu>
      
      <asp:XmlDataSource id="MenuSource"
        datafile="Map.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>Menu DataBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu DataBindings Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        runat="server">
        
        <DataBindings>
          <asp:menuitembinding datamember="MapHomeNode" 
            depth="0"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="title" 
            navigateurlfield="url"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            textfield="title" 
            navigateurlfield="url"/>
        </DataBindings>
        
      </asp:menu>
      
      <asp:XmlDataSource id="MenuSource"
        datafile="Map.xml"
        runat="server"/>        

    </form>
  </body>
</html>

L’exemple de code suivant montre comment ajouter MenuItemBinding des objets à un MenuItemBindingCollection objet par programmation. Pour que cet exemple fonctionne correctement, vous devez copier l’exemple de données XML ci-dessous dans un fichier nommé Map.xml.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void Page_Load(Object sender, EventArgs e)
  {
    if(!IsPostBack)
    {
      // Create the menu item bindings for the Menu control.
      MenuItemBinding binding;
      
      binding = CreateMenuItemBinding("MapHomeNode", 0, "title", "url");
      NavigationMenu.DataBindings.Add(binding);

      binding = CreateMenuItemBinding("MapNode", 1, "title", "url");
      NavigationMenu.DataBindings.Add(binding);

      binding = CreateMenuItemBinding("MapNode", 2, "title", "url");
      NavigationMenu.DataBindings.Add(binding);
    }
  }

  // This is a helper method to create a MenuItemBinding 
  // object from the specified parameters.
  MenuItemBinding CreateMenuItemBinding(String dataMember, int depth, String textField, String navigateUrlField)
  {
    // Create a new MenuItemBinding object.
    MenuItemBinding binding = new MenuItemBinding();

    // Set the properties of the MenuItemBinding object.
    binding.DataMember = dataMember;
    binding.Depth = depth;
    binding.TextField = textField;
    binding.NavigateUrlField = navigateUrlField;

    return binding;
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemBindingCollection Add Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemBindingCollection Add Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        runat="server">        
      </asp:menu>
      
      <asp:xmldatasource id="MenuSource"
        datafile="Map.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">
<script runat="server">

  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
 
    If Not IsPostBack Then
    
      ' Create the menu item bindings for the Menu control.
      Dim binding As MenuItemBinding
      
      binding = CreateMenuItemBinding("MapHomeNode", 0, "title", "url")
      NavigationMenu.DataBindings.Add(binding)

      binding = CreateMenuItemBinding("MapNode", 1, "title", "url")
      NavigationMenu.DataBindings.Add(binding)

      binding = CreateMenuItemBinding("MapNode", 2, "title", "url")
      NavigationMenu.DataBindings.Add(binding)
   
    End If
    
  End Sub

  ' This is a helper method to create a MenuItemBinding 
  ' object from the specified parameters.
  Function CreateMenuItemBinding(ByVal dataMember As String, ByVal depth As Integer, ByVal textField As String, ByVal navigateUrlField As String) As MenuItemBinding
  
    ' Create a new MenuItemBinding object.
    Dim binding As New MenuItemBinding()

    ' Set the properties of the MenuItemBinding object.
    binding.DataMember = dataMember
    binding.Depth = depth
    binding.TextField = textField
    binding.NavigateUrlField = navigateUrlField

    Return binding
    
  End Function
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemBindingCollection Add Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemBindingCollection Add Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"
        datasourceid="MenuSource"
        runat="server">        
      </asp:menu>
      
      <asp:xmldatasource id="MenuSource"
        datafile="Map.xml"
        runat="server"/>        

    </form>
  </body>
</html>

Voici un exemple de données de mappage de site pour les exemples précédents.

<MapHomeNode url="~\Home.aspx"

title="Home"

description="Home">

<MapNode url="~\Music.aspx"

title="Music"

description="Music">

<MapNode url="~\Classical.aspx"

title="Classical"

description="Classical"/>

<MapNode url="~\Rock.aspx"

title="Rock"

description="Rock"/>

<MapNode url="~\Jazz.aspx"

title="Jazz"

description="Jazz"/>

</MapNode>

<MapNode url="~\Movies.aspx"

title="Movies"

description="Movies">

<MapNode url="~\Action.aspx"

title="Action"

description="Action"/>

<MapNode url="~\Drama.aspx"

title="Drama"

description="Drama"/>

<MapNode url="~\Musical.aspx"

title="Musical"

description="Musical"/>

</MapNode>

</MapHomeNode>

Remarques

La MenuItemBindingCollection classe est utilisée pour stocker et gérer une collection d’objets MenuItemBinding dans le Menu contrôle. Le Menu contrôle utilise la MenuItemBindingCollection classe comme type de données pour sa DataBindings propriété. La DataBindings propriété est utilisée pour stocker toutes les liaisons d’élément de menu définies pour le Menu contrôle.

Notes

L’ordre dans lequel MenuItemBinding les objets apparaissent dans la collection n’a aucun effet sur la façon dont ces objets sont appliqués aux éléments de menu d’un Menu contrôle.

La MenuItemBindingCollection classe prend en charge plusieurs façons d’accéder aux éléments de la collection :

Utilisez l’indexeur Item[] pour récupérer directement l’objet MenuItemBinding à un index de base zéro spécifique.
Utilisez la GetEnumerator méthode pour créer un énumérateur qui peut être utilisé pour itérer dans la collection.
Utilisez la CopyTo méthode pour copier le contenu de la collection dans un tableau.

Vous pouvez gérer par programmation un MenuItemBindingCollection objet en ajoutant et en supprimant des MenuItemBinding objets. Pour ajouter des éléments de menu à la collection, utilisez la méthode ou la Add Insert méthode. Pour supprimer des nœuds de la collection, utilisez le , le Remove RemoveAt, ou la Clear méthode.

La MenuItemBindingCollection classe contient des propriétés et des méthodes qui vous permettent de récupérer des informations sur la collection elle-même. Pour savoir combien d’éléments se trouvent dans la collection, utilisez la Count propriété. Si vous souhaitez déterminer si la collection contient un certain MenuItemBinding objet, utilisez la Contains méthode. Pour obtenir l’index d’un MenuItemBinding objet dans la collection, utilisez la IndexOf méthode.

Propriétés

Count	Obtient le nombre d'éléments contenus dans la collection StateManagedCollection. (Hérité de StateManagedCollection)
Item[Int32]	Obtient l'objet MenuItemBinding situé à l'index spécifié de la collection.

Méthodes

Add(MenuItemBinding)	Ajoute l'objet MenuItemBinding spécifié à la fin de la collection.
Clear()	Supprime tous les éléments de la collection StateManagedCollection. (Hérité de StateManagedCollection)
Contains(MenuItemBinding)	Détermine si l'objet MenuItemBinding spécifié se trouve dans la collection.
CopyTo(Array, Int32)	Copie les éléments de la collection StateManagedCollection dans un tableau, en commençant au niveau d'un index de tableau particulier. (Hérité de StateManagedCollection)
CopyTo(MenuItemBinding[], Int32)	Copie tous les éléments de l'objet MenuItemBindingCollection dans un tableau d'objets MenuItemBinding compatible unidimensionnel, en commençant à l'index spécifié dans le tableau cible.
CreateKnownType(Int32)	En cas de substitution dans une classe dérivée, crée une instance d'une classe qui implémente IStateManager. Le type d'objet créé repose sur le membre spécifié de la collection retournée par la méthode GetKnownTypes(). (Hérité de StateManagedCollection)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetEnumerator()	Retourne un itérateur qui itère au sein de la collection StateManagedCollection. (Hérité de StateManagedCollection)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetKnownTypes()	En cas de substitution dans une classe dérivée, obtient un tableau de types IStateManager que la collection StateManagedCollection peut contenir. (Hérité de StateManagedCollection)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(MenuItemBinding)	Détermine l'index de l'objet MenuItemBinding spécifié dans la collection.
Insert(Int32, MenuItemBinding)	Ajoute l'objet MenuItemBinding spécifié à la collection à l'emplacement d'index spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnClear()	En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire avant que la méthode Clear() supprime tous les éléments de la collection. (Hérité de StateManagedCollection)
OnClearComplete()	En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire une fois tous les éléments de la collection supprimés par la méthode Clear(). (Hérité de StateManagedCollection)
OnInsert(Int32, Object)	En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire avant que la méthode IList.Insert(Int32, Object) ou IList.Add(Object) ajoute un élément à la collection. (Hérité de StateManagedCollection)
OnInsertComplete(Int32, Object)	En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire après que la méthode IList.Insert(Int32, Object) ou IList.Add(Object) a ajouté un élément à la collection. (Hérité de StateManagedCollection)
OnRemove(Int32, Object)	En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire avant que la méthode IList.Remove(Object) ou IList.RemoveAt(Int32) supprime l'élément spécifié de la collection. (Hérité de StateManagedCollection)
OnRemoveComplete(Int32, Object)	En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire après que la méthode IList.Remove(Object) ou IList.RemoveAt(Int32) a supprimé l'élément spécifié de la collection. (Hérité de StateManagedCollection)
OnValidate(Object)	En cas de substitution dans une classe dérivée, valide un élément de la collection StateManagedCollection. (Hérité de StateManagedCollection)
Remove(MenuItemBinding)	Supprime l'objet MenuItemBinding spécifié de la collection.
RemoveAt(Int32)	Supprime de la collection l'objet MenuItemBinding situé à l'emplacement d'index spécifié.
SetDirty()	Force la sérialisation de l'intégralité de la collection StateManagedCollection dans l'état d'affichage. (Hérité de StateManagedCollection)
SetDirtyObject(Object)	En cas de substitution dans une classe dérivée, commande à un `object` contenu dans la collection d'enregistrer l'intégralité de son état dans l'état d'affichage, plutôt que d'enregistrer uniquement des informations relatives aux modifications. (Hérité de StateManagedCollection)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

ICollection.Count	Obtient le nombre d'éléments contenus dans la collection StateManagedCollection. (Hérité de StateManagedCollection)
ICollection.IsSynchronized	Obtient une valeur indiquant si la collection StateManagedCollection est synchronisée (thread-safe). Cette méthode retourne `false` dans tous les cas. (Hérité de StateManagedCollection)
ICollection.SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l'accès à la collection StateManagedCollection. Cette méthode retourne `null` dans tous les cas. (Hérité de StateManagedCollection)
IEnumerable.GetEnumerator()	Retourne un itérateur qui itère au sein de la collection StateManagedCollection. (Hérité de StateManagedCollection)
IList.Add(Object)	Ajoute un élément à la collection StateManagedCollection. (Hérité de StateManagedCollection)
IList.Clear()	Supprime tous les éléments de la collection StateManagedCollection. (Hérité de StateManagedCollection)
IList.Contains(Object)	Détermine si la collection StateManagedCollection contient une valeur spécifique. (Hérité de StateManagedCollection)
IList.IndexOf(Object)	Détermine l'index d'un élément spécifié de la collection StateManagedCollection. (Hérité de StateManagedCollection)
IList.Insert(Int32, Object)	Insère un élément dans la collection StateManagedCollection au niveau de l'index spécifié. (Hérité de StateManagedCollection)
IList.IsFixedSize	Obtient une valeur indiquant si la collection StateManagedCollection est de taille fixe. Cette méthode retourne `false` dans tous les cas. (Hérité de StateManagedCollection)
IList.IsReadOnly	Obtient une valeur indiquant si la collection StateManagedCollection est en lecture seule. (Hérité de StateManagedCollection)
IList.Item[Int32]	Obtient l’élément IStateManager à l’index spécifié. (Hérité de StateManagedCollection)
IList.Remove(Object)	Supprime la première occurrence de l'objet spécifié dans la collection StateManagedCollection. (Hérité de StateManagedCollection)
IList.RemoveAt(Int32)	Supprime l'élément IStateManager au niveau de l'index spécifié. (Hérité de StateManagedCollection)
IStateManager.IsTrackingViewState	Obtient une valeur indiquant si la collection StateManagedCollection enregistre les modifications apportées à son état d'affichage. (Hérité de StateManagedCollection)
IStateManager.LoadViewState(Object)	Restaure l'état d'affichage précédemment enregistré de la collection StateManagedCollection et les éléments IStateManager qu'elle contient. (Hérité de StateManagedCollection)
IStateManager.SaveViewState()	Enregistre les modifications apportées à la collection StateManagedCollection et à chaque objet IStateManager qu'elle contient, depuis la publication de la page sur le serveur. (Hérité de StateManagedCollection)
IStateManager.TrackViewState()	Commande à la collection StateManagedCollection et à chacun des objets IStateManager qu'elle contient de procéder au suivi des modifications apportées à leur état d'affichage afin qu'ils puissent être rendus persistants au fil des requêtes d'une même page. (Hérité de StateManagedCollection)

Méthodes d’extension

Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

S’applique à

Share via