BindingSource.DataSource BindingSource.DataSource BindingSource.DataSource BindingSource.DataSource Property

Definición

Obtiene o establece el origen de datos con el que está enlazado el conector.Gets or sets the data source that the connector binds to.

public:
 property System::Object ^ DataSource { System::Object ^ get(); void set(System::Object ^ value); };
public object DataSource { get; set; }
member this.DataSource : obj with get, set
Public Property DataSource As Object

Valor de propiedad

Un Object que actúa como un origen de datos.An Object that acts as a data source. De manera predeterminada, es null.The default is null.

Ejemplos

En el ejemplo de código siguiente se asigna a una lista de clientes para la DataSource de un BindingSource componente.The following code example assigns a list of customers to the DataSource of a BindingSource component. Este ejemplo de código forma parte de un ejemplo más extenso incluido en Cómo: Provocar notificaciones de cambios mediante el método ResetItem de BindingSource.This code example is part of a larger example provided at How to: Raise Change Notifications Using the BindingSource ResetItem Method.

void Form1_Load( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   // Create and populate the list of DemoCustomer objects
   // which will supply data to the DataGridView.
   List< DemoCustomer^ >^ customerList = gcnew List< DemoCustomer^ >;
   customerList->Add( DemoCustomer::CreateNewCustomer() );
   customerList->Add( DemoCustomer::CreateNewCustomer() );
   customerList->Add( DemoCustomer::CreateNewCustomer() );
   
   // Bind the list to the BindingSource.
   this->customersBindingSource->DataSource = customerList;
   
   // Attach the BindingSource to the DataGridView.
   this->customersDataGridView->DataSource =
      this->customersBindingSource;
}
private void Form1_Load(System.Object sender, System.EventArgs e)
{
    // Create and populate the list of DemoCustomer objects
    // which will supply data to the DataGridView.
    List<DemoCustomer> customerList = new List<DemoCustomer>();
    customerList.Add(DemoCustomer.CreateNewCustomer());
    customerList.Add(DemoCustomer.CreateNewCustomer());
    customerList.Add(DemoCustomer.CreateNewCustomer());

    // Bind the list to the BindingSource.
    this.customersBindingSource.DataSource = customerList;

    
    // Attach the BindingSource to the DataGridView.
    this.customersDataGridView.DataSource = 
        this.customersBindingSource;
}
Private Sub Form1_Load(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Me.Load
    ' Create and populate the list of DemoCustomer objects
    ' which will supply data to the DataGridView.
    Dim customerList As List(Of DemoCustomer) = _
    New List(Of DemoCustomer)
    customerList.Add(DemoCustomer.CreateNewCustomer())
    customerList.Add(DemoCustomer.CreateNewCustomer())
    customerList.Add(DemoCustomer.CreateNewCustomer())

    ' Bind the list to the BindingSource.
    Me.customersBindingSource.DataSource = customerList

    ' Attach the BindingSource to the DataGridView.
    Me.customersDataGridView.DataSource = Me.customersBindingSource
End Sub

Comentarios

El DataSource propiedad puede establecerse en un número de orígenes de datos, incluidos tipos, objetos y listas de tipos.The DataSource property can be set to a number of data sources, including types, objects, and lists of types. El origen de datos resultante se expondrá como una lista.The resulting data source will be exposed as a list. La siguiente tabla muestra algunos de los orígenes de datos comunes y la evaluación de la lista resultante.The following table shows some of the common data sources and the resulting list evaluation.

Propiedad de origen de datosDataSource property Resultados de la listaList results
null Un valor vacío IBindingList de objetos.An empty IBindingList of objects. Agregar un elemento, Establece la lista para el tipo del elemento agregado.Adding an item sets the list to the type of the added item.
null con DataMember establecidonull with DataMember set No compatible, provoca ArgumentException.Not supported, raises ArgumentException.
Tipo no de lista o un objeto de tipo "T"Non-list type or object of type "T" Vacía IBindingList de tipo "T".Empty IBindingList of type "T".
Instancia de matrizArray instance IBindingList que contiene los elementos de matriz.IBindingList containing the array elements.
IEnumerable InstanciaIEnumerable instance Un IBindingList que contiene el IEnumerable elementos.An IBindingList containing the IEnumerable items.
"T" de la instancia que contiene el tipo de listaList instance containing type "T" IBindingList instancia de tipo "T".IBindingList instance containing type "T".

Además, DataSource se puede establecer en otros tipos de lista como IListSource y ITypedList y BindingSource controlará adecuadamente.In addition, DataSource can be set to other list types such as IListSource and ITypedList and the BindingSource will handle them appropriately. En este caso, el tipo contenido en la lista debe tener un constructor predeterminado.In this case, the type contained in the list should have a default constructor.

Al establecer un origen de datos, si la referencia proporcionada contiene más de una lista o tabla, debe establecer el DataMember propiedad en una cadena que especifica la lista para enlazar a.When setting a data source, if the supplied reference contains more than one list or table, you must set the DataMember property to a string that specifies the list to bind to. Configuración de esta propiedad provoca la DataSourceChanged eventos.Setting this property raises the DataSourceChanged event.

Nota

Si realiza cambios en el DataSource valor de propiedad, debe hacerlo en el subproceso de interfaz (IU) del usuario para asegurarse de que la interfaz de usuario refleja los cambios.If you make any changes to the DataSource property value, you should do so on the user interface (UI) thread to ensure that the UI reflects the changes.

El DataSource es la propiedad predeterminada para el BindingSource clase.The DataSource property is the default property for the BindingSource class.

Se aplica a

Consulte también: