BindingNavigator (Clase)
Actualización: noviembre 2007
Representa la interfaz de usuario de navegación y manipulación para los controles de un formulario que están enlazados a datos.
Ensamblado: System.Windows.Forms (en System.Windows.Forms.dll)
[ComVisibleAttribute(true)] [ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] public class BindingNavigator : ToolStrip, ISupportInitialize
/** @attribute ComVisibleAttribute(true) */ /** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ public class BindingNavigator extends ToolStrip implements ISupportInitialize
El control BindingNavigator representa una manera normalizada para navegar y manipular los datos en un formulario. En la mayoría de los casos, se empareja un control BindingNavigator con un control BindingSource para navegar por los registros de datos de un formulario e interactuar con ellos. En estos casos, la propiedad BindingSource se establece en el componente System.Windows.Forms.BindingSource asociado que actúa como origen de datos.
De manera predeterminada, la interfaz de usuario del control BindingNavigator se compone de una serie de botones, cuadros de texto y elementos de texto estático ToolStrip para la mayoría de las acciones frecuentes relacionadas con datos, como agregar y eliminar datos, y desplazarse por ellos. Cada uno de estos controles se puede recuperar o establecer mediante un miembro asociado del control BindingNavigator. De forma parecida, también hay una correspondencia uno a uno con los miembros incluidos en la clase BindingSource que realizan la misma funcionalidad mediante programación, como se muestra en la tabla siguiente.
|
Control de interfaz de usuario |
Miembro BindingNavigator |
Miembro BindingSource |
|---|---|---|
|
Mover primero |
||
|
Mover anterior |
||
|
Posición actual |
||
|
Count |
||
|
Mover siguiente |
||
|
Mover último |
||
|
Agregar nuevo |
||
|
Eliminar |
Al agregar un control BindingNavigator a un formulario y enlazarlo a un origen de datos, como un origen BindingSource, se establecerán automáticamente las relaciones en esta tabla.
Puede usar una de las técnicas siguientes para personalizar esta barra de herramientas:
-
Cree el control BindingNavigator con el constructor BindingNavigator(Boolean), que acepta un parámetro addStandardItems booleano, y establezca este parámetro en false. Después agregue los objetos ToolStripItem deseados a la colección Items.
-
Si se desea realizar muchas personalizaciones, o si se va a reutilizar el diseño personalizado, derive una clase de BindingNavigator y reemplace el método AddStandardItems para definir elementos estándar adicionales o alternativos.
En el ejemplo de código siguiente se muestra cómo utilizar un control BindingNavigator para moverse por un conjunto de datos. El conjunto está contenido en un DataView, que está enlazado a un control TextBox con un componente BindingSource.
using System; using System.Collections.Generic; using System.ComponentModel; using System.Data; using System.Drawing; using System.Data.SqlClient; using System.Windows.Forms; // This form demonstrates using a BindingNavigator to display // rows from a database query sequentially. public class Form1 : Form { // This is the BindingNavigator that allows the user // to navigate through the rows in a DataSet. BindingNavigator customersBindingNavigator = new BindingNavigator(true); // This is the BindingSource that provides data for // the Textbox control. BindingSource customersBindingSource = new BindingSource(); // This is the TextBox control that displays the CompanyName // field from the the DataSet. TextBox companyNameTextBox = new TextBox(); public Form1() { // Set up the BindingSource component. this.customersBindingNavigator.BindingSource = this.customersBindingSource; this.customersBindingNavigator.Dock = DockStyle.Top; this.Controls.Add(this.customersBindingNavigator); // Set up the TextBox control for displaying company names. this.companyNameTextBox.Dock = DockStyle.Bottom; this.Controls.Add(this.companyNameTextBox); // Set up the form. this.Size = new Size(800, 200); this.Load += new EventHandler(Form1_Load); } void Form1_Load(object sender, EventArgs e) { // Open a connection to the database. // Replace the value of connectString with a valid // connection string to a Northwind database accessible // to your system. string connectString = "Integrated Security=SSPI;Persist Security Info=False;" + "Initial Catalog=Northwind;Data Source=localhost"; using (SqlConnection connection = new SqlConnection(connectString)) { SqlDataAdapter dataAdapter1 = new SqlDataAdapter(new SqlCommand("Select * From Customers",connection)); DataSet ds = new DataSet("Northwind Customers"); ds.Tables.Add("Customers"); dataAdapter1.Fill(ds.Tables["Customers"]); // Assign the DataSet as the DataSource for the BindingSource. this.customersBindingSource.DataSource = ds.Tables["Customers"]; // Bind the CompanyName field to the TextBox control. this.companyNameTextBox.DataBindings.Add( new Binding("Text", this.customersBindingSource, "CompanyName", true)); } } [STAThread] public static void Main() { Application.EnableVisualStyles(); Application.Run(new Form1()); } }
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ScrollableControl
System.Windows.Forms.ToolStrip
System.Windows.Forms.BindingNavigator
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.