TreeNodeBindingCollection.Add(TreeNodeBinding) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega el objeto TreeNodeBinding especificado al final del objeto TreeNodeBindingCollection.
public:
int Add(System::Web::UI::WebControls::TreeNodeBinding ^ binding);
public int Add (System.Web.UI.WebControls.TreeNodeBinding binding);
member this.Add : System.Web.UI.WebControls.TreeNodeBinding -> int
Public Function Add (binding As TreeNodeBinding) As Integer
Parámetros
- binding
- TreeNodeBinding
TreeNodeBinding que se va a anexar.
Devoluciones
El índice de base cero de la ubicación del objeto TreeNodeBinding agregado en TreeNodeBindingCollection.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar el Add método para agregar un nuevo TreeNodeBinding objeto mediante programación a un TreeNodeBindingCollection objeto . Para que este ejemplo funcione correctamente, debe copiar los datos XML que se encuentran al final de esta sección en un archivo denominado Book.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)
{
// Use the Remove method to remove the TreeNodeBinding object
// for the third-level nodes (index 2).
TreeNodeBinding oldBinding = BookTreeView.DataBindings[2];
BookTreeView.DataBindings.Remove(oldBinding);
// Create a new TreeNodeBinding object and set its properties.
TreeNodeBinding newBinding = new TreeNodeBinding();
newBinding.DataMember = "Section";
newBinding.TextField = "Subject";
// Use the Add method to add the TreeNodeBinding object to the
// DataBindings collection.
BookTreeView.DataBindings.Add(newBinding);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNodeBindingCollection Add and Remove Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNodeBindingCollection Add and Remove Example</h3>
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
<asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
<asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="BookXmlDataSource"
DataFile="Book.xml"
runat="server">
</asp:XmlDataSource>
</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)
' Use the Remove method to remove the TreeNodeBinding object
' for the third-level nodes (index 2).
Dim oldBinding As TreeNodeBinding = BookTreeView.DataBindings(2)
BookTreeView.DataBindings.Remove(oldBinding)
' Create a new TreeNodeBinding object and set its properties.
Dim newBinding As TreeNodeBinding = New TreeNodeBinding
newBinding.DataMember = "Section"
newBinding.TextField = "Subject"
' Use the Add method to add the TreeNodeBinding object to the
' DataBindings collection.
BookTreeView.DataBindings.Add(newBinding)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNodeBindingCollection Add and Remove Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNodeBindingCollection Add and Remove Example</h3>
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
<asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
<asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="BookXmlDataSource"
DataFile="Book.xml"
runat="server">
</asp:XmlDataSource>
</form>
</body>
</html>
A continuación se incluyen los datos XML del ejemplo de código anterior.
<Book Title="Book Title">
<Chapter Heading="Chapter 1">
<Section Heading="Section 1"
Subject="Subject 1">
</Section>
<Section Heading="Section 2"
Subject="Subject 1">
</Section>
</Chapter>
<Chapter Heading="Chapter 2">
<Section Heading="Section 1"
Subject="Subject 1">
</Section>
</Chapter>
</Book>
Comentarios
Utilice el Add método para anexar el objeto especificado TreeNodeBinding al final del TreeNodeBindingCollection objeto .
Como alternativa, puede insertar un TreeNodeBinding objeto en en TreeNodeBindingCollection un índice específico mediante el Insert método .