ListControl.DataSource Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

ListControl.cs

Obtiene o establece el origen de datos de este objeto ListControl.

C#

public object? DataSource { get; set; }

Valor de propiedad

Object

Objeto que implementa las interfaces IList o IListSource, por ejemplo, un DataSet o una Array. De manera predeterminada, es null.

Excepciones

ArgumentException

El valor asignado no implementa las interfaces IList o IListSource.

Ejemplos

El ejemplo de código siguiente es una aplicación completa que muestra cómo se pueden usar DataSourcelos miembros , DisplayMember, ValueMembery SelectedValue de la ListControl clase como se implementa en la ListBox clase . En el ejemplo se carga un ArrayList y el cuadro de lista. Cuando el usuario selecciona un elemento en el cuadro de lista, el valor seleccionado se usa para devolver los datos asociados al elemento seleccionado.

C#

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

namespace MyListControlSample
{
    public class ListBoxSample3 : Form
    {
        private ListBox ListBox1 = new ListBox();
        private Label label1 = new Label();
        private TextBox textBox1 = new TextBox();

        [STAThread]
        static void Main()
        {
            Application.Run(new ListBoxSample3());
        }

        public ListBoxSample3()
        {
            this.ClientSize = new Size(307, 206);
            this.Text = "ListBox Sample3";

            ListBox1.Location = new Point(54, 16);
            ListBox1.Name = "ListBox1";
            ListBox1.Size = new Size(240, 130);

            label1.Location = new Point(14, 150);
            label1.Name = "label1";
            label1.Size = new Size(40, 24);
            label1.Text = "Value";

            textBox1.Location = new Point(54, 150);
            textBox1.Name = "textBox1";
            textBox1.Size = new Size(240, 24);
            
            this.Controls.AddRange(new Control[] { ListBox1, label1, textBox1 });

            // Populate the list box using an array as DataSource.
            ArrayList USStates = new ArrayList();
            USStates.Add(new USState("Alabama", "AL"));
            USStates.Add(new USState("Washington", "WA"));
            USStates.Add(new USState("West Virginia", "WV"));
            USStates.Add(new USState("Wisconsin", "WI"));
            USStates.Add(new USState("Wyoming", "WY"));
            ListBox1.DataSource = USStates;

            // Set the long name as the property to be displayed and the short
            // name as the value to be returned when a row is selected.  Here
            // these are properties; if we were binding to a database table or
            // query these could be column names.
            ListBox1.DisplayMember = "LongName";
            ListBox1.ValueMember = "ShortName";

            // Bind the SelectedValueChanged event to our handler for it.
            ListBox1.SelectedValueChanged += 
                new EventHandler(ListBox1_SelectedValueChanged);

            // Ensure the form opens with no rows selected.
            ListBox1.ClearSelected();
        }

        private void InitializeComponent()
        {
        }

        private void ListBox1_SelectedValueChanged(object sender, EventArgs e)
        {
            if (ListBox1.SelectedIndex != -1)
            {
                textBox1.Text = ListBox1.SelectedValue.ToString();
                // If we also wanted to get the displayed text we could use
                // the SelectedItem item property:
                // string s = ((USState)ListBox1.SelectedItem).LongName;
            }
        }
    }

    public class USState
    {
        private string myShortName;
        private string myLongName;

        public USState(string strLongName, string strShortName)
        {

            this.myShortName = strShortName;
            this.myLongName = strLongName;
        }

        public string ShortName
        {
            get
            {
                return myShortName;
            }
        }

        public string LongName
        {

            get
            {
                return myLongName;
            }
        }
    }
}

Comentarios

Hay dos maneras de rellenar los ComboBox controles y ListBox .

Por ejemplo, puede agregar objetos a ComboBox mediante el Add método . También puede agregar objetos a ComboBox mediante las DataSourcepropiedades , DisplayMembery ValueMember para rellenar .ComboBox

Cuando se establece la DataSource propiedad , un usuario no puede modificar la colección de elementos.

Si establecer la DataSource propiedad hace que el origen de datos cambie, se genera el DataSourceChanged evento . Si establecer esta propiedad hace que el miembro de datos cambie, se genera el DisplayMemberChanged evento .

Cuando se establece DataSource en null, DisplayMember se establece en una cadena vacía ("").

Se aplica a