CYQ.Data 輕量資料層之路 使用篇三曲 MAction 取值賦值(十四)

上一篇：CYQ.Data 輕量資料層之路 使用篇二曲 MAction 資料查詢(十三）

 

內容概要

本篇繼續上一篇內容，本節介紹所有取值與賦值的相關操作。
1：原生：像操作Row一樣
2：擴充：對UI操作 GetFrom與SetTo
3：擴充：非UI操作 Get與Set

 

代碼共同部分提前說明，我們假設以通過以下方法查詢完一行資料

MAction action = new MAction(TableNames.Users);
if (action.Fill("UserName='路過秋天'"))
 {
     //這裡是今天要說的取值與賦值操作
       action.Close();
 }

 

 

一：原生操作

1：擷取行資料

MDataRow row=action.Data;

2：通過欄位取值

string username = row["UserName"].Value;
//有枚舉時
string username = row[Users.UserName].Value;

3：通過索引取值

string userName = row[1].Value;

 

二：擴充 UI操作

說明：控制項ID遵守起名約定：三個字母首碼+欄位名稱

例如TextBox控制項ID為：txtUserName
則為txt(首碼)+UserName(資料庫欄位名稱）

 

1：GetFrom 從控制項中取值設定到行中

方法原型：
public void GetFrom(Control ct)
public void GetFrom(Control ct, object value)

樣本1：

action.GetFrom(txtUserName);
//等同於
action.Data["UserName"].Value=txtUserName.Text;

樣本2：

action.GetFrom(txtUserName, "路過秋天");
//等同於
action.Data["UserName"].Value="路過秋天";

 

2：SetTo 將行中的資料設定到控制項中

方法原形：
public void SetTo(Control ct)
public void SetTo(Control ct, object value)
public void SetTo(Control ct, object value, bool isControlEnabled)

樣本1：

action.SetTo(txtUserName);
//等同於：
txtUserName.Text=action.Data["UserName"].Value.ToString();

樣本2：

action.SetTo(txtUserName,"路過秋天");
//等同於
txtUserName.Text="路過秋天";

樣本3：

action.SetTo(txtUserName,null,false);
//等同於：
txtUserName.Text=action.Data["UserName"].Value.ToString();
txtUserName.Enabled=false;

 

三：擴充：非UI操作

1：Get 從行中擷取資料

原生方法：public T Get<T>(object key)

樣本1：

string userName = action.Get<string>("UserName");
string userName = action.Get<string>(Users.UserName);//有枚舉時
//等同於
string userName = action.Data["UserName"].Value.ToString();

 

2：Set 從變數中設定值到行中

原生方法：public void Set(object key,object value)

樣本1：

action.Set("UserName", "路過秋天");
//等同於：
action.Data["UserName"].Value = "路過秋天";

 

結言：

通過本節說明，應該能掌握對於單行資料的基礎操作。
對於下節使用說明：內容及名稱仍未定。