ValidationConstraints Enumeración

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Define constantes que informan al método ValidateChildren(ValidationConstraints) sobre cómo debería validar los controles secundarios de un contenedor.

Esta enumeración admite una combinación bit a bit de sus valores de miembro.

C#

[System.Flags]
public enum ValidationConstraints

Herencia

Object

ValueType

Enum

ValidationConstraints

Atributos

FlagsAttribute

Campos

Nombre	Valor	Description
Enabled	2	Valida los controles secundarios cuya propiedad Enabled está establecida en true.
ImmediateChildren	16	Valida los controles secundarios que se hospedan directamente en el contenedor. No valida ninguno de los elementos secundarios de estos controles secundarios. Por ejemplo, si tiene un objeto Form que contiene un control UserControl personalizado y este control UserControl contiene a su vez un control Button, al utilizar ImmediateChildren, se desencadenará el evento Validating del control UserControl, pero no el evento Validating del control Button.
None	0	Valida todos los controles secundarios y todos los elementos secundarios de estos controles secundarios, sin tener en cuenta los valores de sus propiedades.
Selectable	1	Valida los controles secundarios que se pueden seleccionar.
TabStop	8	Valida los controles secundarios que tienen un conjunto de valores TabStop, lo que significa que el usuario puede navegar al control utilizando la tecla TAB.
Visible	4	Valida los controles secundarios cuya propiedad Visible está establecida en true.

Ejemplos

El ejemplo de código siguiente solo hará que el Validating evento se genere para elementos secundarios inmediatos del formulario cuya Enabled propiedad sea true.

C#

using System;
using System.Collections.Generic;
using System.Text;
using System.Drawing;
using System.Windows.Forms;

namespace ValidateChildrenWithConstraints
{
    class Form1 : Form
    {
        public static void Main(string[] args)
        {
            Application.EnableVisualStyles();
            Application.Run(new Form1());
        }

        private Form1()
        {
            this.Load += new EventHandler(Form1_Load);
        }

        void Form1_Load(object sender, EventArgs e)
        {
            // Create controls on form.
            TextBox textBox1, textBox2, textBox3;
            FlowLayoutPanel flowPanel1;
            TextBox subTextBox1;
            Button button1;

            this.Size = new Size(500, 300);
            this.AutoValidate = AutoValidate.Disable;

            textBox1 = new TextBox();
            textBox1.Location = new Point(20, 20);
            textBox1.Size = new Size(75, textBox1.Size.Height);
            textBox1.CausesValidation = true;
            textBox1.Validating += new System.ComponentModel.CancelEventHandler(textBox1_Validating);
            this.Controls.Add(textBox1);

            textBox2 = new TextBox();
            textBox2.Location = new Point(105, 20);
            textBox2.Size = new Size(75, textBox2.Size.Height);
            textBox2.CausesValidation = true;
            textBox2.Validating += new System.ComponentModel.CancelEventHandler(textBox2_Validating);
            this.Controls.Add(textBox2);

            textBox3 = new TextBox();
            textBox3.Location = new Point(190, 20);
            textBox3.Size = new Size(75, textBox3.Size.Height);
            textBox3.Enabled = false;
            textBox3.CausesValidation = true;
            textBox3.Validating += new System.ComponentModel.CancelEventHandler(textBox3_Validating);
            this.Controls.Add(textBox3);

            button1 = new Button();
            button1.Text = "Click";
            button1.Location = new Point(270, 20);
            button1.Click += new EventHandler(button1_Click);
            this.Controls.Add(button1);

            flowPanel1 = new FlowLayoutPanel();
            flowPanel1.Size = new Size(400, 100);
            flowPanel1.Dock = DockStyle.Bottom;
            subTextBox1 = new TextBox();
            subTextBox1.CausesValidation = true;
            subTextBox1.Validating += new System.ComponentModel.CancelEventHandler(subTextBox1_Validating);
            flowPanel1.Controls.Add(subTextBox1);
            this.Controls.Add(flowPanel1);
        }

        void subTextBox1_Validating(object sender, System.ComponentModel.CancelEventArgs e)
        {
            MessageBox.Show("subTextBox1 Validating!");
        }

        void textBox1_Validating(object sender, System.ComponentModel.CancelEventArgs e)
        {
            MessageBox.Show("textBox1 Validating!");
        }

        void textBox2_Validating(object sender, System.ComponentModel.CancelEventArgs e)
        {
            MessageBox.Show("textBox2 Validating!");
        }

        void textBox3_Validating(object sender, System.ComponentModel.CancelEventArgs e)
        {
            MessageBox.Show("textBox3 Validating!");
        }

        void button1_Click(object sender, EventArgs e)
        {
            this.ValidateChildren(ValidationConstraints.ImmediateChildren | ValidationConstraints.Enabled);
        }
    }
}

Comentarios

De forma predeterminada, ValidateChildren validará todos los controles habilitados en un contenedor, como un formulario. Use esta enumeración para restringir los tipos de controles cuyo Validating evento se genera.

Puede combinar estos valores enumerados junto con una operación OR bit a bit. La combinación de parámetros con un operador OR bit a bit producirá una operación AND lógica. Por ejemplo, la llamada ValidateChildren(ValidationConstraints.ImmediateChildren | ValidationConstraints.Enabled) solo generará el Validating evento en los controles que son elementos secundarios inmediatos del contenedor Y están habilitados.

Si no especifica ImmediateChildren al llamar a ValidateChildren, el método requerirá que valide todos los controles secundarios de la jerarquía de controles.

Se aplica a

Consulte también

• Validación de los datos proporcionados por el usuario en Windows Forms (Windows Forms)