2018年3月2日 星期五

BackgroundWorker 的使用

專案需求:一支常駐程式可以撈資料
想法大概是:一個 Timer 定期檢查、一個 ProgressBar 顯示進度、一個 backgroundworker 避免影響使用者、一個 NotifyIcon 可以出現桌面的右下角
程式寫法大致上是:

新增一個 Form,在上面放一個 ProgressBar
然後拉一個 Timer
一個 BackgroundWorker,並設定 WorkerReportsProgress = true,才可以修改 ProgressBar 的進度 然後在初始化後設定 form 的位置
public Form1()
{
    InitializeComponent();

    // 縮小視窗,以觸發 notifyIcon (不直接觸發是為了保留之後若要點擊縮小的 Icon 時可以恢復視窗)
    this.WindowState = FormWindowState.Minimized;
    this.TopLevel = true;
    this.screenWidth = Screen.PrimaryScreen.Bounds.Width;
    this.screenHeight = Screen.PrimaryScreen.Bounds.Height;
    //this.Location = new Point(screenWidth - Width - 5, screenHeight);

    //設定視窗位置在右下角最高可以顯示的位置, 工具列上方
    this.stopHightLocation = Screen.PrimaryScreen.Bounds.Height - (Screen.PrimaryScreen.Bounds.Height - Screen.PrimaryScreen.WorkingArea.Height + this.Height);
    this.Location = new Point(screenWidth - Width - 5, stopHightLocation);
}
在 BackgroundWorker (Name 設為 bw) 的事件上分別寫上
void bw_DoWork(object sender, DoWorkEventArgs e)
{
    object myParameter = e.Argument; // myParameter 是帶過來要用的參數
    // 開始執行要很久的動作
    ...(略)
    // 結束
}
void bw_ProgressChanged(object sender, ProgressChangedEventArgs e)
{
    // 把視窗叫起來讓使用者看到進度條
    if (this.WindowState == FormWindowState.Minimized)
    {
        this.Show();    // 顯示視窗
        this.WindowState = FormWindowState.Normal;
    }
    // 修改進度條的進度
    progressBar1.Value = e.ProgressPercentage;
    // 以文字的方式顯示進度條的百分比
    label2.Text = string.Format("{0:f0}%", (progressBar1.Value / Convert.ToDouble(progressBar1.Maximum)) * 100);
}
void bw_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
{
    this.WindowState = FormWindowState.Minimized;   // 隱藏視窗
    timer1.Enabled = true;  // 工作完成了,再次啟用 timer1
}
再來在 form load 事件內啟用 timer1
private void timer1_Tick(object sender, EventArgs e)
{
    // 如果背景程式忙碌中,就停止這次的背景
    if (bw.IsBusy)
        return;

    timer1.Enabled = false;  // 然後將 timer 停用

    // 這邊可以收集要的參數
    // 若收集參數也很耗時,則可以另開一個backgroundworker來做,然後在backgroundworker_completed事件內執行主要的忙碌工作
    // 或是將收集參數的工作也被到bw裡面,但此時可能不單純只顯示progressbar,可能還需要顯示進度的內容說明

    // 然後呼叫backgroundworker 執行 (可以加判斷是否真的需要呼叫背景程式,減少觸發次數)
    if (myParameter != null)
        bw.RunWorkerAsync(myParameter); 
}
後來看到另一篇文章寫到,原來也可以在 BackgroundWorker_Completed 事件中,再次執行耗時的工作即可,減少使用一個 timer 元件,
把timer1_Tick()事件用另一個function 包起來,然後稍微修改一下
void PrepareToRunWorkerAsync()
{
    // 如果背景程式忙碌中,就停止這次的背景
    if (bw.IsBusy)
        return;

    // 這邊可以收集要的參數
    // 若收集參數也很耗時,則可以另開一個backgroundworker來做,然後在backgroundworker_completed事件內執行主要的忙碌工作
    // 或是將收集參數的工作也被到bw裡面,但此時可能不單純只顯示progressbar,可能還需要顯示進度的內容說明

    // 然後呼叫backgroundworker 執行
    bw.RunWorkerAsync(myParameter); 
}
然後在 Form1() 建構式中直接執行上述的 function
public Form1()
{
    InitializeComponent();

    // 縮小視窗,以觸發 notifyIcon (不直接觸發是為了保留之後若要點擊縮小的 Icon 時可以恢復視窗)
    this.WindowState = FormWindowState.Minimized;
    this.TopLevel = true;
    this.screenWidth = Screen.PrimaryScreen.Bounds.Width;
    this.screenHeight = Screen.PrimaryScreen.Bounds.Height;
    //this.Location = new Point(screenWidth - Width - 5, screenHeight);

    //設定視窗位置在右下角最高可以顯示的位置, 工具列上方
    this.stopHightLocation = Screen.PrimaryScreen.Bounds.Height - (Screen.PrimaryScreen.Bounds.Height - Screen.PrimaryScreen.WorkingArea.Height + this.Height);
    this.Location = new Point(screenWidth - Width - 5, stopHightLocation);

    PrepareToRunWorkerAsync();
}
修改一下 BackgroundWorker_Completed 事件
void bw_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
{
    this.WindowState = FormWindowState.Minimized;   // 隱藏視窗
    // 若使用者沒有下取消命令,則在Completed 事件下再次執行耗時的工作
    if (e.Cancelled == false)
        PrepareToRunWorkerAsync();

}
當然上述做法需再搭配一個啟動耗時工作的事件,不然一但取消後,就只有重開執行檔一途了
void buttonStart(object sender, EventArgs e)
{
    PrepareToRunWorkerAsync();
}
參考:C# 使用 BackgroundWorker 背景執行

2018年2月23日 星期五

動態控制 ContextMenuStrip 不出現

通常在按下滑鼠右鍵要出現選單時,都會用到 ContextMenuStrip 這個控制項,使用方式如下:
1.從工具箱點兩下 ContextMenuStrip,產生 contextMenuStrip1
2.點擊該 contextMenuStrip1,可以編輯清單內容
3.選擇 contextMenuStrip1 要出現在哪個控制項,在該控制項的 ContextMenuStrip 屬性上選擇 contextMenuStrip1 

但是當要動態控制 contextMenuStrip1 要不要出現時,
無法寫成
// 假設 contextMenuStrip1 要出現在 treeView1 的右鍵時
treeView1.ContextMenuStrip = "";
只能在 contextMenuStrip1.Opening 事件上動手腳
boolean bContextMenuStripVisible = false; // 指定是否顯示 ContextMenuStrip
private void contextMenuStrip1_Opening(object sender, CancelEventArgs e)
{
    if (bContextMenuStripVisible == false)
    {               
          e.Cancel = true;
    }
}

2018年2月22日 星期四

TableLayoutPanel 內的控制項的 Dock 屬性無法完全作用

TableLayoutPanel 是可以讓控制項排列整理的一個控制項(有點繞舌) 因專案需要,在 TableLayoutPanel 內塞了幾種控制項(Label、TextBox、ListBox)

然後把TableLayoutPanel 內的控制項的 Dock 屬性設定為 Fill,塞滿格子

有沒有發現
TextBox 的 Dock 設為 Fill 後,沒完全 Work?
原來是因為 TextBox 的 MultiLine 是 False 的關係,因為只能有一行字,當然無法撐開控制項的高度,所以修改的方式有兩種,視需求選擇使用
1. 改變字型大小
2. 把 MultiLine 設為 True

ListBox 的 Dock 設為 Fill 後,沒完全 Work?
原來 ListBox 有一個屬性 IntegralHeight(表示清單是否可以只包含完整的項目),意思應該是指 ListBox 的高度不足以顯示完整的 Item 時,只會展開到完整顯示的 Item 的高度,所以只要將 IntegralHeight 設為 False,就可以達到 Dock=Fill 的完整效果了

如果要將控制項完全貼合 TableLayoutPanel,則調整內部的各控制項的 Margin 屬性即可

2018年2月9日 星期五

NChar 與 Char 的差別

簡言之

NChar 是以位元組(2個位元)的方式儲存資料(NVarChar 亦同)
Char 是以位元的方式儲存資料(VarChar 亦同)

說明:
位元組:可以儲存半型字 或 全型字
位元:僅可以儲存半型字

有點雙人床與單人床的概念
雙人床:可以睡 1 個人或是 2 個人
單人床:僅可以睡 1 個人

所以當你要存的資料
只包含 英文、數字,即半型字,可以用 Char 即可
只包含 中文,即全型字,也可以用 Char 但記得長度要開 2 倍,或是直接用 NChar,長度就不用開到 2 倍

舉例:
以下語法會出現 字串或二進位資料會被截斷 的訊息
因為資料"五"是一個全型字,而欄位Char(1)僅能存一個半型字
declare @MyTable Table (ColName Char(1))
insert into @MyTable Values ('五')
改用 NChar
-- 改用 NChar
declare @MyTable Table (ColName NChar(1))
insert into @MyTable Values ('五')
或是改成 2 倍長度
--改成 2 倍長度 Char(2)
declare @MyTable Table (ColName Char(2))
insert into @MyTable Values ('五')
就OK了

若是 中文、英文、數字夾雜,那就看個人喜愛了



另外提供兩個SQL函數(Len、DataLength),可以幫助釐清上面的差別
將語法改成如下:
將欄位長度改成 3
-- 在 Char 的情況下
declare @MyTable Table (ColName Char(3))
insert into @MyTable Values ('五')
select *, Len(ColName), DATALENGTH(ColName) from @MyTable
-- 結果:
-- Len(ColName) = 1,即資料的字元數
-- DATALENGTH(ColName) = 3,即欄位的位元數
-- 在 NChar 的情況下
declare @MyTable Table (ColName NChar(3))
insert into @MyTable Values ('五')
select *, Len(ColName), DATALENGTH(ColName) from @MyTable
-- 結果:
-- Len(ColName) = 1,即資料的字元數
-- DATALENGTH(ColName) = 6,即欄位的位元數

再來,將資料內容修改一下(儲存一個全型字和一個半型字)
-- 在 Char 的情況下
declare @MyTable Table (ColName Char(3))
insert into @MyTable Values ('五5')
select *, Len(ColName), DATALENGTH(ColName) from @MyTable
-- 結果:
-- Len(ColName) = 2,即資料的字元數
-- DATALENGTH(ColName) = 3,即欄位的位元數
-- 在 NChar 的情況下
declare @MyTable Table (ColName NChar(3))
insert into @MyTable Values ('五5')
select *, Len(ColName), DATALENGTH(ColName) from @MyTable
-- 結果:
-- Len(ColName) = 2,即資料的字元數
-- DATALENGTH(ColName) = 6,即欄位的位元數

2018年1月19日 星期五

還原TreeView 的展開狀態

例:
 
如果在 A 下的 C 下加入 D,如果只是在 TreeView 上改變顯示,那麼要遍歷整個 Tree,找出所有的 C (B 下有一個 C)之後,改變畫面,雖然可以這樣做,但程式碼上似乎複雜了點
所以改變思路,在 C 下加入 D 之後,重新綁定 TreeView 的資料。

但是重新綁定 TreeView 之後,TreeView 會收合到剩下第一層,使用者就要重新展開之後,再往下加入其他子項目,這點其實很麻煩。

所以在重新綁定前先記錄下目前 TreeView 的展開狀態,綁定之後再還原展開狀態,程式碼加下

設定兩個全域變數
private Dictionary<string, bool> NodesStatus = new Dictionary<string, bool>();  // 記錄展開狀態
private string SelectNodeFullPath = ""; // 記錄選擇到的節點

記錄展開狀態
/// <summary>
/// 記錄展開狀態
/// </summary>
/// <param name="nodes"></param>
private void GetTreeNodesStatus(TreeNodeCollection nodes)
{
 foreach (TreeNode node in nodes)
 {
  if (node.IsExpanded)
  {
   NodesStatus[node.FullPath] = true;
  }
  else
  {
   NodesStatus.Remove(node.FullPath);
  }

  if (node.IsSelected)
  {
   SelectNodeFullPath = node.FullPath;
  }
  GetTreeNodesStatus(node.Nodes);
 }
}

還原展開狀態
/// <summary>
/// 還原展開狀態
/// </summary>
/// <param name="nodes"></param>
private void SetTreeNodesStatus(TreeNodeCollection nodes)
{
 foreach (TreeNode node in nodes)
 {
  if (NodesStatus.ContainsKey(node.FullPath))
  {
   node.Expand();
  }

  if (node.FullPath == SelectNodeFullPath)
  {
   treeView1.SelectedNode = node;
  }

  SetTreeNodesStatus(node.Nodes);
 }
}

使用方式
// 對treeView1做了某些操作之後(例如加入子選項)
GetTreeNodesStatus(treeView1.Nodes);
BindTreeViewData(); // 綁定TreeView
SetTreeNodesStatus(treeView1.Nodes);

2018年1月17日 星期三

C# Window Form - 動態指定Form尺寸

如果想要動態控制 Form 的尺寸,做法會先指定以某個控制項(或原點)做為基準,指定控制項的位置後,確定最右下角的那個控制項之後,才能決定 Form 的尺寸。

比方右下角有一個 Button(button1),指定的 Form 的語法會是
this.Height = button1.Top + button1.Height;
this.Width = button1.Left + button1.Width;
但這樣加完的結果是看不到,因為 Form 的最上方有一條標題列,要再加上這標題列的高度才行,所以改成
this.Height = button1.Top + button1.Height + iControlSpacer + (this.Height-this.ClientSize.Height);
this.Width = button1.Left + button1.Width + iControlSpacer + (this.Width - this.ClientSize.Width);
其中 this.Height-this.ClientSize.Height 是標題列高度的計算方式,
iControlSpacer  是控制項之間的間隔

2017年9月30日 星期六

Google Cloud Platform 探索經驗 (5) - 將 Google Storage 中的檔案當網站

雖然 Google 有提供部落格 Blogger 可以使用,網路上也有教學將個人部落格改成公司網站使用,但畢竟是部落格的使用方式,在設計上難免會困難度較大。

所以 Google Cloud Platform 有另一個工具 - Storage 可以將寫好的網頁或檔案放在裡面(個人覺得類似於 Google 文件),可以公開連結給需要的人,就變成像是網站的感覺。

接下來就將個人的經驗寫下來供參考

【網站檔案設定】
步驟一:當然要先有 Google Cloud Platform (以下簡稱 GCP)的權限
步驟二:到 GCP 的控制台,展開左邊 ≡ 符號,然後點選 Storage

步驟三:建立 BUKET (此 BUKET 的名稱要和你的網域名稱相同)
步驟四:點選剛才建立 BUKET ,然後將 首頁 和 錯誤頁 的網頁上傳

步驟五:在 BUKET 清單頁找到剛才建立的 BUKET 右邊會有一個 (三個黑點)的符號,點下去之後選擇 "編輯網站設定",將首頁和錯誤頁設好

步驟六:此時點選 BUKET 下的 index.html 的 公開連結,就可以看到網站的首頁了,但是此時網址還是你 Google Storage 的樣子,所以接下來要到你的網域申請的網站上設定DNS對應到的網址。


【網域申請與設定】-這邊是以免費網域申請(https://my.freenom.com/)為範例

步驟一:進入官網後,找到 SERVICE 下的 Register a New Domain,將想要的網域名稱打進去之後,按下 Check Availability,確認看看是否可用和所需費用,選擇清單中想要的那一個,按下 Get it now,然後按下上面的 checkout 後,選擇要用的區間(既然有 12 個月免費可以選,哪有不選的道理),選擇之後按下 Continue,在左下角填入你的 Email Address(這會用來確認並啟用),並按下 Verify My Email Address,然後到你的信箱去點確認連結。

步驟二:點下確認信中的連結後,會要你填寫一些資料(好像全部都是必填),然後勾選I have read and agree to the Terms & Conditions,然後按下 Complete Order,完成申請。

步驟三:完成申請後,要將 Google Storage 和 DNS 做連結,所以找到官網上的 Services 下的 My Domains,選擇剛才申請的 Domain 的 Manage Domain,再點選 Manage Freenom DNS 來設定關聯。


步驟四:先跳到 Google 的 Cloud Storage 文件(Hosting a Static Website)來看一下如何做確認,這邊說明要到你的DNS申請的地方做的設定,但設定前需要先做一下確認,所以先跳到Google 網站網理員中心,網頁告訴你驗證的方法。


步驟五:到Google 網站網理員中心 ,按下新增資源,輸入要驗證的網域後按下繼續
,選擇 其他方法 > 網域名稱供應商 > 其他,選擇下方的 新增 CNAME 紀錄
這是要填入步驟三中的設定,供確認用

步驟六:我們將【網域申請與設定】步驟一申請的那個網域填入上列相對資訊,按下 Save Change,
然後再回到步驟五的地方按下下方的"驗證",(驗證可能不會馬上生效,需要幾分鐘時間後,才會生效),如果驗證過了,表示你是該網域的擁有者。就會在你的資源清單中看到剛才的資源了


步驟七:開始瀏覽器,在網址列打上你設定的網域,就可以看到和 Google Storage 中一樣的網頁內容了 (如同【網站檔案設定】中的步驟六)