BindingSource.DataSource Propiedad

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

Objeto Object que funciona como origen de datos.An Object that acts as a data source. De manera predeterminada, es null.The default is null.

Ejemplos

En el ejemplo DataSource de código siguiente se asigna una lista de clientes al 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 grande proporcionado en cómo: Genere notificaciones de cambios mediante el métodoResetItem 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

La DataSource propiedad se puede establecer en una serie de orígenes de datos, incluidos los 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. En la tabla siguiente se muestran 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 DataSourceDataSource property Resultados de la listaList results
null Un objeto IBindingList vacío de objetos.An empty IBindingList of objects. Al agregar un elemento, se establece la lista en el tipo del elemento agregado.Adding an item sets the list to the type of the added item.
nullwith DataMember setnull with DataMember set No se admite, ArgumentExceptiongenera.Not supported, raises ArgumentException.
Tipo no de lista u objeto de tipo "T"Non-list type or object of type "T" Vacío IBindingList de tipo "T".Empty IBindingList of type "T".
Instancia de matrizArray instance IBindingListque contiene los elementos de la matriz.IBindingList containing the array elements.
Instancia de IEnumerableIEnumerable instance Que contiene los IEnumerableelementos. IBindingListAn IBindingList containing the IEnumerable items.
Instancia de lista que contiene el tipo "T"List instance containing type "T" IBindingListinstancia de que contiene el tipo "T".IBindingList instance containing type "T".

Además, DataSource se puede establecer en otros tipos IListSource de lista como y ITypedList y el 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 sin parámetros.In this case, the type contained in the list should have a parameterless constructor.

Al establecer un origen de datos, si la referencia proporcionada contiene más de una lista o tabla, debe establecer la DataMember propiedad en una cadena que especifique la lista a la que se va a enlazar.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. Al establecer esta propiedad, DataSourceChanged se genera el evento.Setting this property raises the DataSourceChanged event.

Nota

Si realiza cambios en el valor de DataSource la propiedad, debe hacerlo en el subproceso de la interfaz de usuario (UI) 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.

La DataSource propiedad es la propiedad predeterminada de la BindingSource clase.The DataSource property is the default property for the BindingSource class.

Se aplica a

Consulte también: