Compartir a través de


MenuItemBindingCollection.Insert(Int32, MenuItemBinding) Método

Definición

Agrega el objeto MenuItemBinding especificado a la colección en la ubicación de índice especificada.

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 -> unit
Public Sub Insert (index As Integer, binding As MenuItemBinding)

Parámetros

index
Int32

Posición de índice de base cero donde se inserta el objeto MenuItemBinding.

binding
MenuItemBinding

MenuItemBinding que se va a insertar.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el Insert método para agregar un MenuItemBinding objeto a la colección en un índice específico. Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo siguientes en un archivo denominado 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>

A continuación se incluyen datos de mapa del sitio de ejemplo para el ejemplo anterior.

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

Comentarios

Utilice el Insert método para insertar el objeto especificado MenuItemBinding en la colección en el índice especificado.

Nota

Puede agregar valores NULL y objetos duplicados MenuItemBinding a la colección.

Como alternativa, simplemente puede anexar un MenuItemBinding objeto al final de la colección mediante el Add método .

Nota

El orden en que MenuItemBinding aparecen los objetos en la colección no tiene ningún efecto sobre cómo se aplican esos objetos a los elementos de menú de un Menu control .

Se aplica a

Consulte también