2018年2月28日 星期三

如何 Microsoft SQL Server Management Studio 17 使用匯出資料庫的綱要 Schema

今天是 228 ,放假一天,所以,來研究一下,如何把資料庫的綱要 Schema 匯出,修改一些內容,最後想要產生一個新的資料庫。
理所當然,我就打開 Visual Studio 2017,並且切換到 SQL Server 物件總管,不過,當我使用滑鼠右鍵點選項要匯出的資料庫時候,從彈出功能表中,卻沒有看到任何可以匯出資料庫綱要的選項。
SQL Server 物件總管
這個時候,只好參考這份文件 下載 SQL Server Managemen這個時候,只好參考這份文件 ,下載 下載 SQL Server Management Studio 17.5 並且安裝到我的電腦上;當安裝完成之後,我這裡需要重新開機,因此,在電腦重新開機之後,我就啟動了 Microsoft SQL Server Management Studio
現在,可以從電腦中找到 Microsoft SQL Server Management Studio ,執行這個應用程式,我們可以在 [Connect to Server] 對話窗中,在 [Server name] 的欄位中,輸入 (localdb)\MSSQLLocalDB 這個字串,這樣,我們就可以連線到本機的 LocalDB。
Microsoft SQL Server Management Studio
在最左方的 [Object Explorer] 視窗中,請展開 [Databases] 節點,您就可以看到這台機器上的 Local DB 現在有哪些資料庫存在,使用滑鼠右擊您想要產生資料庫綱要的資料庫。
接下來,我們可以從彈出功能表,依序選擇 [Tasks] > [Generate Scripts] 選項
Microsoft SQL Server Management Studio
此時,您會看到 [Generate and Publish Scripts] 對話窗出現,請在第一個對話窗畫面 [Introduction] 上,點選 [Next] 按鈕。
Generate and Publish Scripts
在 [Choose Objects] 畫面中,我們一樣使用預設值,點選 [Next] 按鈕。
Generate and Publish Scripts
最後,在 [Set Scripting Options] 畫面中,可以依照您的需要,將這個資料庫 Schema 匯出到您期望的目的地與儲存格式,點選 [Next] 按鈕。
Generate and Publish Scripts
這樣,您就成功取得了這個資料庫綱要定義 SQL 指令了。

2017年11月11日 星期六

.NET Core 與 .NET Framework 在 GC 釋放物件的不同處理方式

在這裡,我們將會比較 .NET Core 與 .NET Framework 中的 CLR 對於 GC 的處理運作差異點。我們會針對這兩個 .NET 平台的 Debug / Release 模式下,跑同樣的測試程式,看看會有甚麼樣的結果。

可以追蹤該別現在多少物件正在使用中

我們首先建立這個 CountObject 類別,這個類別有個靜態屬性 TotalObjects,這個屬性會當該類別的建構函式被呼叫的時候(也就是,用戶端有使用 new 運算子要建立一個新的物件),就會把這個靜態屬性 TotalObjects加一,表示,現在該類別在 CLR 中,有一個物件生成了。
而當 CLR (通用語言執行階段) 進行 GC (記憶體回收程序) 過程中,若發現到有物件沒有被任何物件或者變數參考使用到,此時,GC 就會進行該物件的記憶體回收工作;而由於我們在這個類別中,有加入解構函式 ( ~CountObject() )的宣告,因此,當有物件要被回收的時候,該類別的解構函式就會被呼叫到,而在解構函式內,每被呼叫一次,就會自動將靜態屬性 TotalObjects減一,表示該這個類別在 CLR 中的物件又減少了一個。
public class CountObject
{
    /// <summary>
    /// 記錄下現在記憶體中,總共存在這多少個物件
    /// </summary>
    private static int _TotalObjects;

    public static int TotalObjects
    {
        get { return _TotalObjects; }
        set { _TotalObjects = value; }
    }

    string ObjectName;

    public CountObject()
    {
        // 若有該類別的物件產生,則計數器會加一
        CountObject.TotalObjects += 1;
        Console.WriteLine($"現在總共有 {CountObject.TotalObjects} 物件");
    }

    public CountObject(string objectName) : this()
    {
        Console.WriteLine($"有新的物件要產生 {objectName}");
        ObjectName = objectName;
    }

    ~CountObject()
    {
        Console.WriteLine($"有物件要回收 {ObjectName}");
        // 若有物件被回收,則該計數器會減一
        CountObject.TotalObjects -= 1;
    }
}

測試步驟

接下來的測試動作,將會分成

建立六個物件,並且執行 GC,看看剩下多少物件

我們首先呼叫 new 運算子,建立四個 CountObject 類別物件,不過,這四個物件,是沒有指定給任何物件變數(也就是,只要 GC 一執行,這四個物件一定會被回收的)。
接下來,建立兩個 CountObject 類別物件,但是,這裡將會指定到兩個變數中,也就是,這兩個物件將會被參考使用中。
接著,我們將會強制執行 GC 運行,並且等候一段時間,讓沒有被參考到的物件,可以順利被回收(想要了解這方面的進階資訊,請參考 GC 的運作模式相關文件)。
最後,我們將會顯示出靜態屬性 CountObject.TotalObjects 的值,看看現在還有多少物件存在於記憶體中。
Console.WriteLine("現在要產生六個物件");
new CountObject("物件1");
new CountObject("物件2");
new CountObject("物件3");
new CountObject("物件4");
var fooObject = new CountObject("物件5");
var fooTempObject = new CountObject("物件6");
Console.WriteLine($"Total Objects is {CountObject.TotalObjects}");
Console.WriteLine("Press any key for continuing...");
Console.ReadKey();

// 進行記憶體回收工作
Console.WriteLine("進行記憶體回收工作");
GC.Collect(2, GCCollectionMode.Forced);

// 將要休息三秒鐘,讓背景記憶體回收程序,可以有足夠的時間,進行記憶體回收
Console.WriteLine("將要休息三秒鐘,讓背景記憶體回收程序,可以有足夠的時間,進行記憶體回收");
Thread.Sleep(3000);
Console.WriteLine($"Total Objects is {CountObject.TotalObjects}");
Console.WriteLine("Press any key for continuing...");
Console.ReadKey();

將其中一個物件變數設定為 null,並且執行 GC,看看剩下多少物件

在這個測試程序中,將會把 fooTempObject 物件變數設定為 null,也就是原先該變數指向的物件,現在就沒有任何人正在參考與使用中,另外一個物件,是有 fooObject 變數指向它。
此時,我們將會強制執行 GC 運行,並且等候一段時間,讓沒有被參考到的物件,可以順利被回收(想要了解這方面的進階資訊,請參考 GC 的運作模式相關文件)。
最後,我們將會顯示出靜態屬性 CountObject.TotalObjects 的值,看看現在還有多少物件存在於記憶體中。
Console.WriteLine("將其中一個物件變數 fooTempObject,設為空值 null,因此,該變數 fooTempObject 所指向的物件,將會被記憶體回收");
fooTempObject = null;
// 進行記憶體回收工作
Console.WriteLine("進行記憶體回收工作");
GC.Collect(2, GCCollectionMode.Forced);

// 將要休息三秒鐘,讓背景記憶體回收程序,可以有足夠的時間,進行記憶體回收
Console.WriteLine("將要休息三秒鐘,讓背景記憶體回收程序,可以有足夠的時間,進行記憶體回收");
Thread.Sleep(3000);
Console.WriteLine($"Total Objects is {CountObject.TotalObjects}");
Console.WriteLine("Press any key for continuing...");
Console.ReadKey();

在 .NET Core 平台下進行測試 (Debug 模式)

建立六個物件,並且執行 GC,看看剩下多少物件

輸出結果
現在要產生六個物件
現在總共有 1 物件
有新的物件要產生 物件1
現在總共有 2 物件
有新的物件要產生 物件2
現在總共有 3 物件
有新的物件要產生 物件3
現在總共有 4 物件
有新的物件要產生 物件4
現在總共有 5 物件
有新的物件要產生 物件5
現在總共有 6 物件
有新的物件要產生 物件6
Total Objects is 6
Press any key for continuing...
進行記憶體回收工作
將要休息三秒鐘,讓背景記憶體回收程序,可以有足夠的時間,進行記憶體回收
Total Objects is 6
Press any key for continuing...

將其中一個物件變數設定為 null,並且執行 GC,看看剩下多少物件

輸出結果
將其中一個物件變數 fooTempObject,設為空值 null,因此,該變數 fooTempObject 所指向的物件,將會被記憶體回收
進行記憶體回收工作
將要休息三秒鐘,讓背景記憶體回收程序,可以有足夠的時間,進行記憶體回收
Total Objects is 6
Press any key for continuing...

在 .NET Core 平台下進行測試 (Release 模式)

建立六個物件,並且執行 GC,看看剩下多少物件

輸出結果
現在要產生六個物件
現在總共有 1 物件
有新的物件要產生 物件1
現在總共有 2 物件
有新的物件要產生 物件2
現在總共有 3 物件
有新的物件要產生 物件3
現在總共有 4 物件
有新的物件要產生 物件4
現在總共有 5 物件
有新的物件要產生 物件5
現在總共有 6 物件
有新的物件要產生 物件6
Total Objects is 6
Press any key for continuing...
進行記憶體回收工作
將要休息三秒鐘,讓背景記憶體回收程序,可以有足夠的時間,進行記憶體回收
有物件要回收 物件6
有物件要回收 物件5
有物件要回收 物件4
有物件要回收 物件3
有物件要回收 物件2
有物件要回收 物件1
Total Objects is 0
Press any key for continuing...

將其中一個物件變數設定為 null,並且執行 GC,看看剩下多少物件

輸出結果
將其中一個物件變數 fooTempObject,設為空值 null,因此,該變數 fooTempObject 所指向的物件,將會被記憶體回收
進行記憶體回收工作
將要休息三秒鐘,讓背景記憶體回收程序,可以有足夠的時間,進行記憶體回收
Total Objects is 0
Press any key for continuing...

在 .NET Framework 平台下進行測試 (Debug 模式)

建立六個物件,並且執行 GC,看看剩下多少物件

輸出結果
現在要產生六個物件
現在總共有 1 物件
有新的物件要產生 物件1
現在總共有 2 物件
有新的物件要產生 物件2
現在總共有 3 物件
有新的物件要產生 物件3
現在總共有 4 物件
有新的物件要產生 物件4
現在總共有 5 物件
有新的物件要產生 物件5
現在總共有 6 物件
有新的物件要產生 物件6
Total Objects is 6
Press any key for continuing...
進行記憶體回收工作
將要休息三秒鐘,讓背景記憶體回收程序,可以有足夠的時間,進行記憶體回收
有物件要回收 物件4
有物件要回收 物件3
有物件要回收 物件2
有物件要回收 物件1
Total Objects is 2
Press any key for continuing...

將其中一個物件變數設定為 null,並且執行 GC,看看剩下多少物件

輸出結果
將其中一個物件變數 fooTempObject,設為空值 null,因此,該變數 fooTempObject 所指向的物件,將會被記憶體回收
進行記憶體回收工作
將要休息三秒鐘,讓背景記憶體回收程序,可以有足夠的時間,進行記憶體回收
有物件要回收 物件6
Total Objects is 1
Press any key for continuing...

在 .NET Framework 平台下進行測試 (Release 模式)

建立六個物件,並且執行 GC,看看剩下多少物件

輸出結果
現在要產生六個物件
現在總共有 1 物件
有新的物件要產生 物件1
現在總共有 2 物件
有新的物件要產生 物件2
現在總共有 3 物件
有新的物件要產生 物件3
現在總共有 4 物件
有新的物件要產生 物件4
現在總共有 5 物件
有新的物件要產生 物件5
現在總共有 6 物件
有新的物件要產生 物件6
Total Objects is 6
Press any key for continuing...
進行記憶體回收工作
將要休息三秒鐘,讓背景記憶體回收程序,可以有足夠的時間,進行記憶體回收
有物件要回收 物件6
有物件要回收 物件5
有物件要回收 物件4
有物件要回收 物件3
有物件要回收 物件2
有物件要回收 物件1
Total Objects is 0
Press any key for continuing...

將其中一個物件變數設定為 null,並且執行 GC,看看剩下多少物件

輸出結果
將其中一個物件變數 fooTempObject,設為空值 null,因此,該變數 fooTempObject 所指向的物件,將會被記憶體回收
進行記憶體回收工作
將要休息三秒鐘,讓背景記憶體回收程序,可以有足夠的時間,進行記憶體回收
Total Objects is 0
Press any key for continuing...

差異比較

在 Debug 模式下,在第一階段的時候
  • .NET Core
    並不會回收任何沒有被參考到的物件
  • .NET Framework
    會將沒有被參考到到的物件,自動回收
在 Relase 模式下,這兩個 .NET Core 與 .NET Framework 平台的運作方式都一樣。

測試總管於 VS2017 15.4.3 版本下, .NET Framework 之單元測試運作不正常

今日原本要繼續進行未完成的單元測試專案,發現到我的測試總管無法正常運作,也就是無法顯示出已經建立好的單元測試清單項目。
我這裡的 Visual Studio 2017 本版是 15.4.3
在底下,我將分別針對 .NET Core 與 .NET Framework 的單元測試專案,做個比較

.NET Core 的單元測試專案

首先,選擇 [檔案] > [新增] > [專案] > [.NET Core] > [單元測試專案 (.NET Core)],建立起該 .NET Core 用的單元測試專案
建立.NET Core單元測試
打開 [測試總管] 視窗
滑鼠右擊該專案節點,選擇 [建置]
在建置完成之後,可以從測試總管視窗中,看到所有的單元測試項目之測試結果
建立.NET Core單元測試

.NET Framework 的單元測試專案

首先,選擇 [檔案] > [新增] > [專案] > [.NET Core] > [單元測試專案 (.NET Framework)],建立起該 .NET Framework 用的單元測試專案
建立.NETFramework單元測試專案
打開 [測試總管] 視窗
滑鼠右擊該專案節點,選擇 [建置]
在建置完成之後,卻無法從測試總管視窗中,看到所有的單元測試項目之測試結果
測試總管.NETFramework

使用別的 Visual Studio 2017 版本進行測試

在這裡,我開啟另外一台電腦上的 Visual Studio 2017 ,這台電腦上的 VS2017 版本是 15.3.3
單元測試地當時VS2017版本
我將上述關於 .NET Framwork 單元測試專案的建立、建置過程,重新全部都做一次,發現到如下圖,這就是我之前操作測試總管所可以看到的正常結果。在這裡,我都是把 [Live Unit Testing] 這個選項都是關閉的。
在這個版本中的即時單元測試功能表中,有個 [重新清理] 選項,這個選項在我的 VS2017 15.4.3 版本中,是看不到的。
正常之單元測試畫面
由於我可以在測試總管中看到這些單元測試項目,因此,我可以針對不同單元測試項目,進行除錯檢測。
因為在 VS2017 15.4.3 版本看不到這些單元測試項目,因此,我也就無法進行單元測試的除錯了。
正常的單元測試除錯

最後找的解決方案,那就是將這個目錄刪除掉,就正常了

C:\Users\%username%\AppData\Local\Temp\VisualStudioTestExplorerExtensions

2017年10月30日 星期一

C# HttpClient WebAPI : 18. 套用 ProgressMessageHandler ,訂閱請求與回應的資料傳輸事件

在前面的練習中,我們有做到當要知道 HttpClient 下載一個大檔案的時候,我們可以做到這個檔案的下載處理進度;可是,當我們需要做到檔案上傳或者是多個檔案一次性的上傳或者下載、又或者當資料封裝的內容過多、雖然傳輸與接收內容不多,但是網路速度可能會過慢的情況下,我們還是期望能夠知道 HttpClient 進行 請求 Request 與 回應 Response 的當時處理進度,我們需要有這樣的事件可以訂閱,以便我們可以針對觸發這些事件之後,進行相關的反應動作。
最快速又方便的解決方案,就是使用剛剛提到的 
C# HttpClient WebAPI : 17. 有趣的 HttpClient 管道,自訂 HttpMessage Handler
 Http 訊息處理器來實現這個需求


了解更多關於 [HttpClient Class] 的使用方式
了解更多關於 [使用 async 和 await 進行非同步程式設計] 的使用方式


套用 ProgressMessageHandler ,訂閱請求與回應的資料傳輸事件

在這裡,我們需要使用 ProgressMessageHandler 類別來幫我們做到這樣工作,這裡類別有這兩個事件:HttpReceiveProgress / HttpSendProgress,分別表示當 HttpClient 進行請求與回應網路存取行為的時候,就會適時觸發這兩個事件,此時,用戶端就可以根據這樣的觸發事件行為,做出適當的處理。
在我們這個練習中,我們將訂閱者的回應事件方法,透過委派的方式,傳送到我們要使用 HttpClient 方法內,並且,加入到訂閱事件內。
在這裡,您也可以學會如何將委派方法,傳送到別的方法內,並且加入成為事件訂閱者,這樣的程式設計技巧。
為了要使用 ProgressMessageHandler 類別,我們需要在專案內加入 System.Net.Http.Formatting.Extension 這個 NuGet 套件
我們先宣告了一個 HttpProgressDelegate 委派類別,與兩個訂閱事件函示,這兩個函示將會分別表示當 HttpClient 進行網路存取行為的時候,將會用到的 CallBack 方法,為了簡化展示,我們僅僅列印出訊息文字到螢幕上。
在這裡,我們先宣告了一個 HttpProgressDelegate 委派類別
delegate void HttpProgressDelegate(object request, HttpProgressEventArgs e);
我們也設計兩個方法,這兩個方法將會以傳入到上傳圖片與下載圖片的方法內,並且會加入到 ProgressMessageHandler.HttpReceiveProgress 與 ProgressMessageHandler.HttpSendProgress 事件內,這樣,一旦有任何符合條件的事件發生了,就會觸發這些訂閱事件方法。
private static void Program_HttpSendProgress(object sender, HttpProgressEventArgs e)
{
    Console.WriteLine($"Send : {e.ProgressPercentage}");
}

private static void Program_HttpReceiveProgress(object sender, HttpProgressEventArgs e)
{
    Console.WriteLine($"Receive : {e.ProgressPercentage}");
}
最後,我們會在上傳與下載的方法內,建立 ProgressMessageHandler 類別物件,接著,設定 Http 訊息處理器的管道連結,綁定相關事件。
ProgressMessageHandler progressMessageHandler = new ProgressMessageHandler();
progressMessageHandler.InnerHandler = handler;
progressMessageHandler.HttpReceiveProgress += new EventHandler<HttpProgressEventArgs>(onHttpResponseProgress);
progressMessageHandler.HttpSendProgress += new EventHandler<HttpProgressEventArgs>(onHttpRequestProgress);

using (HttpClient client = new HttpClient(progressMessageHandler))

進行測試

在程式進入點函式,我們直接呼叫 HttpGetAsync 這個非同步方法。
static async Task Main(string[] args)
{

    //HttpReceiveProgress += Program_HttpReceiveProgress;
    //HttpSendProgress += Program_HttpSendProgress; ;

    Console.WriteLine($"上傳圖片且有進度回報");
    await UploadImageAsync("vulcan.png", Program_HttpSendProgress, Program_HttpReceiveProgress);
    Console.WriteLine($"Press any key to Exist...{Environment.NewLine}");
    Console.ReadKey();

    Console.WriteLine($"下載圖片且有進度回報");
    await DownloadImageAsync("vulcan.png", Program_HttpSendProgress, Program_HttpReceiveProgress);
    Console.WriteLine($"Press any key to Exist...{Environment.NewLine}");
    Console.ReadKey();
}

執行結果

這個測試將會輸出底下內容
上傳圖片且有進度回報
Send : 0
Send : 0
Send : 2
Send : 5
Send : 7
Send : 10
Send : 12
Send : 15
Send : 17
Send : 20
Send : 23
Send : 25
Send : 28
Send : 30
Send : 33
Send : 35
Send : 38
Send : 40
Send : 43
Send : 46
Send : 48
Send : 51
Send : 53
Send : 56
Send : 58
Send : 61
Send : 63
Send : 66
Send : 68
Send : 71
Send : 74
Send : 76
Send : 79
Send : 81
Send : 84
Send : 86
Send : 89
Send : 91
Send : 94
Send : 97
Send : 99
Send : 99
Send : 100
Receive : 0
Press any key to Exist...

 下載圖片且有進度回報
Receive : 2
Receive : 3
Receive : 5
Receive : 7
Receive : 9
Receive : 11
Receive : 14
Receive : 17
Receive : 19
Receive : 20
Receive : 22
Receive : 23
Receive : 26
Receive : 28
Receive : 31
Receive : 33
Receive : 36
Receive : 39
Receive : 41
Receive : 43
Receive : 46
Receive : 47
Receive : 49
Receive : 52
Receive : 54
Receive : 57
Receive : 59
Receive : 62
Receive : 64
Receive : 67
Receive : 70
Receive : 72
Receive : 75
Receive : 77
Receive : 80
Receive : 82
Receive : 84
Receive : 86
Receive : 88
Receive : 90
Receive : 93
Receive : 95
Receive : 98
Receive : 100
Press any key to Exist...

相關文章索引

C# HttpClient WebAPI 系列文章索引


了解更多關於 [HttpClient Class] 的使用方式
了解更多關於 [使用 async 和 await 進行非同步程式設計] 的使用方式


關於 Xamarin 在台灣的學習技術資源

Xamarin 實驗室 粉絲團
歡迎加入 Xamarin 實驗室 粉絲團,在這裡,將會經常性的貼出各種關於 Xamarin / Visual Studio / .NET 的相關消息、文章、技術開發等文件,讓您可以隨時掌握第一手的 Xamarin 方面消息。
Xamarin.Forms @ Taiwan
歡迎加入 Xamarin.Forms @ Taiwan,這是台灣的 Xamarin User Group,若您有任何關於 Xamarin / Visual Studio / .NET 上的問題,都可以在這裡來與各方高手來進行討論、交流。
Xamarin 實驗室 部落格
Xamarin 實驗室 部落格 是作者本身的部落格,這個部落格將會專注於 Xamarin 之跨平台 (Android / iOS / UWP) 方面的各類開技術探討、研究與分享的文章,最重要的是,它是全繁體中文。
Xamarin.Forms 系列課程
Xamarin.Forms 系列課程 想要快速進入到 Xamarin.Forms 的開發領域,學會各種 Xamarin.Forms 跨平台開發技術,例如:MVVM、Prism、Data Binding、各種 頁面 Page / 版面配置 Layout / 控制項 Control 的用法等等,千萬不要錯過這些 Xamarin.Forms 課程