DataGrid.DataSource Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta l'origine dati per la quale la griglia visualizza i dati.

C#

public object DataSource { get; set; }

Valore della proprietà

Object

Oggetto che funge da origine dati.

Esempio

Nell'esempio di codice seguente viene illustrato come impostare DataSourcee, quando necessario, per DataMemberassociare un System.Windows.Forms.DataGrid oggetto a e DataView a .DataSet L'esempio mostra anche come restituire origini dati da System.Windows.Forms.DataGrid.

C#

private void BindToDataView(DataGrid myGrid){
    // Create a DataView using the DataTable.
    DataTable myTable = new DataTable("Suppliers");
    // Insert code to create and populate columns.
    DataView myDataView = new DataView(myTable);
    myGrid.DataSource = myDataView;
 }
 private void BindToDataSet(DataGrid myGrid){
    // Create a DataSet.
    DataSet myDataSet = new DataSet("myDataSet");
    // Insert code to populate DataSet with several tables.
    myGrid.DataSource = myDataSet;
    // Use the DataMember property to specify the DataTable.
    myGrid.DataMember = "Suppliers";
 }
 private DataView GetDataViewFromDataSource(){
    // Create a DataTable variable, and set it to the DataSource.
    DataView myDataView;
    myDataView = (DataView) dataGrid1.DataSource;
    return myDataView;
 }
 private DataSet GetDataSetFromDataSource(){
    // Create a DataSet variable, and set it to the DataSource.
    DataSet myDataSet;
    myDataSet = (DataSet) dataGrid1.DataSource;
    return myDataSet;
 }

Commenti

In fase di esecuzione, usare il SetDataBinding metodo per impostare le DataSource proprietà e DataMember .

Le origini dati seguenti sono valide:

• Elemento DataTable

• Elemento DataView

• Elemento DataSet

• Elemento DataViewManager

• Qualsiasi componente che implementa l'interfaccia IListSource

• Qualsiasi componente che implementa l'interfaccia IList

Per altre informazioni sulle origini dati, vedere panoramica della Binding classe.

Se il DataSource riferimento contiene più tabelle, è necessario impostare la DataMember proprietà una stringa che specifica la tabella a cui eseguire l'associazione. Ad esempio, se è DataSource un oggetto o DataViewManager che contiene tre tabelle denominate Customers, Orderse OrderDetails, è necessario specificare la tabella a cui eseguire DataSet l'associazione.

Se si imposta su DataSource un oggetto che non implementa l'interfaccia IList o un oggetto IListSource , la griglia genererà un'eccezione.

È possibile creare una griglia che consente agli utenti di modificare i dati, ma impedisce loro di aggiungere nuove righe usando come DataView origine dati e impostando la AddNew proprietà su false.

Per associare l'oggetto DataGrid a una matrice fortemente tipizzata di oggetti, il tipo di oggetto deve contenere proprietà pubbliche. Per creare un DataGridTableStyle oggetto che visualizza la matrice, impostare la DataGridTableStyle.MappingName proprietà su typename dove typename viene sostituito dal nome del tipo di oggetto. Si noti anche che la MappingName proprietà fa distinzione tra maiuscole e minuscole. Il nome del tipo deve corrispondere esattamente. Per un esempio, vedere la MappingName proprietà .

È anche possibile associare l'oggetto DataGrid a un oggetto ArrayList. Una funzionalità di ArrayList è che può contenere oggetti di più tipi, ma può DataGrid essere associato solo a tale elenco quando tutti gli elementi dell'elenco sono dello stesso tipo del primo elemento. Ciò significa che tutti gli oggetti devono essere dello stesso tipo oppure devono ereditare dalla stessa classe del primo elemento dell'elenco. Ad esempio, se il primo elemento di un elenco è , Controlil secondo elemento può essere un oggetto TextBox (che eredita da Control). Se, d'altra parte, il primo elemento è un TextBoxoggetto , il secondo oggetto non può essere un oggetto Control. Inoltre, deve ArrayList avere elementi al suo interno quando è associato. Un valore vuoto ArrayList comporterà una griglia vuota. Inoltre, gli oggetti in ArrayList devono contenere proprietà pubbliche. Quando si esegue l'associazione a un ArrayListoggetto , impostare l'oggetto MappingNameDataGridTableStyle di su "ArrayList" (il nome del tipo).

Si applica a

Vedi anche

• DataMember
• DataSet
• DataViewManager
• DataView