匯出 (0) 列印
全部展開

BindingSource.DataSource 屬性

注意:這個屬性是 .NET Framework 2.0 版的新功能。

取得或設定此連結器所繫結至的資料來源。

命名空間: System.Windows.Forms
組件: System.Windows.Forms (在 system.windows.forms.dll 中)

public Object DataSource { get; set; }
/** @property */
public Object get_DataSource ()

/** @property */
public void set_DataSource (Object value)

public function get DataSource () : Object

public function set DataSource (value : Object)

屬性值

當做資料來源的 Object。預設值為 Null 參照 (即 Visual Basic 中的 Nothing)。

DataSource 屬性可以設為一些資料來源,包括型別、物件和型別清單。所產生的資料來源將會公開為清單。下表顯示一些通用的資料來源和產生的清單評估。

DataSource 屬性

列出結果

Null 參照 (即 Visual Basic 中的 Nothing)

空的物件 IBindingList。藉由加入項目即可將清單設為已加入之項目的型別。

Null 參照 (即 Visual Basic 中的 Nothing),已設定 DataMember

不支援,引發 ArgumentException

非清單型別或型別 "T" 的物件

空的型別 "T" IBindingList

陣列執行個體

包含陣列元素的 IBindingList

IEnumerable 執行個體

包含 IEnumerable 項目的 IBindingList

包含型別 "T" 的清單執行個體

包含型別 "T" 的 IBindingList 執行個體。

此外,DataSource 也可以設為其他清單型別 (例如 IListSourceITypedList),而且 BindingSource 將會適當地加以處理。在此情況下,包含在清單中的型別應該有預設的建構函式。

當設定資料來源時,如果提供的參考包含一個以上的清單或資料表,您必須將 DataMember 屬性設為一個字串,此字串可指定要繫結至其中的清單。設定這個屬性會引發 DataSourceChanged 事件。

DataSource 屬性是 BindingSource 類別的預設屬性。

下列程式碼範例會將客戶清單指派給 BindingSource 元件的 DataSource。這個程式碼範例是 HOW TO:使用 BindingSource ResetItem 方法引發變更通知中完整範例的一部分。

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;
}

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊,請參閱系統需求一節的內容。

.NET Framework

支援版本:2.0

.NET Compact Framework

支援版本:2.0

社群新增項目

新增
顯示:
© 2014 Microsoft