Procedimiento para enlazar datos al control MaskedTextBox

Puede enlazar datos a un control MaskedTextBox igual que a cualquier otro control de Windows Forms. Pero si el formato de los datos de la base de datos no coincide con el formato esperado por la definición de máscara, deberá volver a formatear los datos. En el procedimiento siguiente se indica cómo se hace con los eventos Format y Parse de la clase Binding para mostrar campos independientes de la base de datos de extensiones y números de teléfono como un único campo editable.

El siguiente procedimiento requiere que tenga acceso a una base de datos de SQL Server con la base de datos de ejemplo Northwind instalada.

Para enlazar datos al control MaskedTextBox

1. Cree un nuevo proyecto de Windows Forms.

2. Arrastre dos controles TextBox al formulario y asígneles los nombres FirstName y LastName.

3. Arrastre un control MaskedTextBox al formulario y asígnele el nombre PhoneMask.

4. Establezca la propiedad Mask de PhoneMask en (000) 000-0000 x9999.

5. Agregue las siguientes importaciones de espacio de nombres al formulario.

   C#

   using System.Data.SqlClient;  
   

6. Haga clic con el botón derecho en el formulario y seleccione Ver código. Coloque este código en cualquier lugar de la clase de formulario.

   C#

   Binding currentBinding, phoneBinding;  
   DataSet employeesTable = new DataSet();  
   SqlConnection sc;  
   SqlDataAdapter dataConnect;  
   
   private void Form1_Load(object sender, EventArgs e)  
   {  
       DoMaskBinding();  
   }  
   
   private void DoMaskBinding()  
   {  
       try  
       {  
           sc = new SqlConnection("Data Source=CLIENTUE;Initial Catalog=NORTHWIND;Integrated Security=SSPI");  
           sc.Open();  
       }  
       catch (Exception ex)  
       {  
           MessageBox.Show(ex.Message);  
           return;  
       }  
   
       dataConnect = new SqlDataAdapter("SELECT * FROM Employees", sc);  
       dataConnect.Fill(employeesTable, "Employees");  
   
       // Now bind MaskedTextBox to appropriate field. Note that we must create the Binding objects  
       // before adding them to the control - otherwise, we won't get a Format event on the
       // initial load.
       try  
       {  
           currentBinding = new Binding("Text", employeesTable, "Employees.FirstName");  
           firstName.DataBindings.Add(currentBinding);  
   
           currentBinding = new Binding("Text", employeesTable, "Employees.LastName");  
           lastName.DataBindings.Add(currentBinding);  
   
           phoneBinding =new Binding("Text", employeesTable, "Employees.HomePhone");  
           // We must add the event handlers before we bind, or the Format event will not get called  
           // for the first record.  
           phoneBinding.Format += new ConvertEventHandler(phoneBinding_Format);  
           phoneBinding.Parse += new ConvertEventHandler(phoneBinding_Parse);  
           phoneMask.DataBindings.Add(phoneBinding);  
       }  
       catch (Exception ex)  
       {  
           MessageBox.Show(ex.Message);  
           return;  
       }  
   }  
   

7. Agregue controladores de eventos para los eventos Format y Parse a fin de combinar y separar los campos PhoneNumber y Extension del objeto DataSet enlazado.

   C#

   private void phoneBinding_Format(Object sender, ConvertEventArgs e)  
   {  
       String ext;  
   
       DataRowView currentRow = (DataRowView)BindingContext[employeesTable, "Employees"].Current;  
       if (currentRow["Extension"] == null)
       {  
           ext = "";  
       } else
       {  
           ext = currentRow["Extension"].ToString();  
       }  
   
       e.Value = e.Value.ToString().Trim() + " x" + ext;  
   }  
   
   private void phoneBinding_Parse(Object sender, ConvertEventArgs e)  
   {  
       String phoneNumberAndExt = e.Value.ToString();  
   
       int extIndex = phoneNumberAndExt.IndexOf("x");  
       String ext = phoneNumberAndExt.Substring(extIndex).Trim();  
       String phoneNumber = phoneNumberAndExt.Substring(0, extIndex).Trim();  
   
       //Get the current binding object, and set the new extension manually.
       DataRowView currentRow = (DataRowView)BindingContext[employeesTable, "Employees"].Current;  
       // Remove the "x" from the extension.  
       currentRow["Extension"] = ext.Substring(1);  
   
       //Return the phone number.  
       e.Value = phoneNumber;  
   }  
   

8. Agregue dos controles Button al formulario. Asígneles los nombres previousButton y nextButton. Haga doble clic en cada botón para agregar un controlador de eventos Click y rellene los controladores de eventos como se muestra en el ejemplo de código siguiente.

   C#

   private void previousButton_Click(object sender, EventArgs e)  
   {  
       BindingContext[employeesTable, "Employees"].Position = BindingContext[employeesTable, "Employees"].Position - 1;  
   }  
   
   private void nextButton_Click(object sender, EventArgs e)  
   {  
       BindingContext[employeesTable, "Employees"].Position = BindingContext[employeesTable, "Employees"].Position + 1;  
   }  
   

9. Ejecute el ejemplo. Edite los datos y use los botones Anterior y Siguiente para ver que los datos se conservan correctamente en el objeto DataSet.

Ejemplo

El ejemplo de código siguiente es la lista de código completa que resulta de completar el procedimiento anterior.

C#

#region Using directives

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Windows.Forms;
using System.Data.SqlClient;

#endregion

namespace MaskedTextBoxDataCSharp
{
    partial class Form1 : Form
    {
        Binding currentBinding, phoneBinding;
        DataSet employeesTable = new DataSet();
        SqlConnection sc;
        SqlDataAdapter dataConnect;

        public Form1()
        {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e)
        {
            DoMaskBinding();
        }

        private void DoMaskBinding()
        {
            try
            {
                sc = new SqlConnection("Data Source=localhost;Initial Catalog=NORTHWIND;Integrated Security=SSPI");
                sc.Open();
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);
                return;
            }

            dataConnect = new SqlDataAdapter("SELECT * FROM Employees", sc);
            dataConnect.Fill(employeesTable, "Employees");

            // Now bind MaskedTextBox to appropriate field. Note that we must create the Binding objects
            // before adding them to the control - otherwise, we won't get a Format event on the
            // initial load.
            try
            {
                currentBinding = new Binding("Text", employeesTable, "Employees.FirstName");
                firstName.DataBindings.Add(currentBinding);

                currentBinding = new Binding("Text", employeesTable, "Employees.LastName");
                lastName.DataBindings.Add(currentBinding);

                phoneBinding =new Binding("Text", employeesTable, "Employees.HomePhone");
                // We must add the event handlers before we bind, or the Format event will not get called
                // for the first record.
                phoneBinding.Format += new ConvertEventHandler(phoneBinding_Format);
                phoneBinding.Parse += new ConvertEventHandler(phoneBinding_Parse);
                phoneMask.DataBindings.Add(phoneBinding);
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);
                return;
            }
        }

        private void phoneBinding_Format(Object sender, ConvertEventArgs e)
        {
            String ext;

            DataRowView currentRow = (DataRowView)BindingContext[employeesTable, "Employees"].Current;
            if (currentRow["Extension"] == null)
            {
                ext = "";
            } else
            {
                ext = currentRow["Extension"].ToString();
            }

            e.Value = e.Value.ToString().Trim() + " x" + ext;
        }

        private void phoneBinding_Parse(Object sender, ConvertEventArgs e)
        {
            String phoneNumberAndExt = e.Value.ToString();

            int extIndex = phoneNumberAndExt.IndexOf("x");
            String ext = phoneNumberAndExt.Substring(extIndex).Trim();
            String phoneNumber = phoneNumberAndExt.Substring(0, extIndex).Trim();

            //Get the current binding object, and set the new extension manually.
            DataRowView currentRow = (DataRowView)BindingContext[employeesTable, "Employees"].Current;
            // Remove the "x" from the extension.
            currentRow["Extension"] = ext.Substring(1);

            //Return the phone number.
            e.Value = phoneNumber;
        }

        private void previousButton_Click(object sender, EventArgs e)
        {
            BindingContext[employeesTable, "Employees"].Position = BindingContext[employeesTable, "Employees"].Position - 1;
        }

        private void nextButton_Click(object sender, EventArgs e)
        {
            BindingContext[employeesTable, "Employees"].Position = BindingContext[employeesTable, "Employees"].Position + 1;
        }
    }
}

Compilar el código

• Cree un proyecto de Visual C# o Visual Basic.

• Agregue los controles TextBox y MaskedTextBox al formulario, como se describe en el procedimiento anterior.

• Abra el archivo de código fuente para el formulario predeterminado del proyecto.

• Reemplace el código fuente de este archivo por el código que aparece en la sección "Código" anterior.

• Realice la compilación de la aplicación.

Vea también

• Tutorial: Trabajar con el control MaskedTextBox