MenuItemBindingCollection.Insert(Int32, MenuItemBinding) Méthode
Définition
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.
Ajoute l'objet MenuItemBinding spécifié à la collection à l'emplacement d'index spécifié.
public:
void Insert(int index, System::Web::UI::WebControls::MenuItemBinding ^ binding);public void Insert (int index, System.Web.UI.WebControls.MenuItemBinding binding);member this.Insert : int * System.Web.UI.WebControls.MenuItemBinding -> unitPublic Sub Insert (index As Integer, binding As MenuItemBinding)Paramètres
- index
- Int32
Position de l'index de base zéro à laquelle insérer MenuItemBinding.
- binding
- MenuItemBinding
MenuItemBinding à insérer.
Exemples
L’exemple de code suivant montre comment utiliser la Insert méthode pour ajouter un MenuItemBinding objet à la collection à un index spécifique. 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 MenuItemBinding object to insert.
MenuItemBinding binding;
binding = CreateMenuItemBinding("MapNode", 1, "title", "url");
// Use the Insert method to add the MenuItemBinding
// object to the Bindings collection at index 1.
NavigationMenu.DataBindings.Insert(1, 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 Insert Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBindingCollection Insert Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="2"
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="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">
<script runat="server">
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
If Not IsPostBack Then
' Create the MenuItemBinding object to insert.
Dim binding As MenuItemBinding
binding = CreateMenuItemBinding("MapNode", 1, "title", "url")
' Use the Insert method to add the MenuItemBinding
' object to the Bindings collection at index 1.
NavigationMenu.DataBindings.Insert(1, 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 Insert Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBindingCollection Insert Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="2"
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="2"
textfield="title"
navigateurlfield="url"/>
</DataBindings>
</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 l’exemple précédent.
<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
Utilisez la Insert méthode pour insérer l’objet spécifié MenuItemBinding dans la collection à l’index spécifié.
Notes
Vous pouvez ajouter des valeurs null et des objets en double MenuItemBinding à la collection.
En guise d’alternative, vous pouvez simplement ajouter un MenuItemBinding objet à la fin de la collection à l’aide de la Add méthode.
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.