Visual Studio

開發環境簡介

Visual Studio 是由微軟開發的一個整合式開發環境（IDE），支援多種程式語言如 C++、C#、VB.NET、Python、JavaScript 等。適用於開發桌面應用程式、網站、雲端服務及行動應用程式。

主要功能

• 程式碼編輯器具備語法高亮、自動完成與即時錯誤提示
• 強大的偵錯工具，可逐行執行程式與檢查變數狀態
• 內建 Git 整合，方便進行版本控制
• 支援單元測試與測試管理
• 提供多種模組與擴充功能以支援各種開發需求

版本區別

• Community：免費版本，適合個人開發者、學生與小型團隊
• Professional：付費版本，適用於中小型企業
• Enterprise：功能最完整，針對大型開發團隊與企業

平台支援

Visual Studio 支援 Windows 作業系統，另有 Visual Studio for Mac，專為 macOS 設計。

常見用途

• 開發 Windows 桌面應用程式（如 WinForms、WPF）
• 開發 ASP.NET 網站與 API
• 使用 Xamarin 或 .NET MAUI 開發行動應用程式
• 撰寫遊戲（結合 Unity 引擎）
• 開發 Azure 雲端服務與應用

Visual Studio 的語法格式化

1. 自動格式化代碼

2. 啟用自動格式化

3. 修改格式化設定

4. 使用編碼樣式設定檔

   [*.cs]
   indent_style = space
   indent_size = 4
   

5. 安裝擴展工具

6. 快速修正格式問題

7. 總結

.NET SDK 版本

檢查已安裝的 .NET SDK

您可以透過命令列工具檢查電腦上安裝的 .NET SDK 版本：

dotnet --list-sdks

若出現類似下列結果，表示已安裝的 SDK 版本：

8.0.100 [C:\Program Files\dotnet\sdk]
9.0.100-preview.3.24172.9 [C:\Program Files\dotnet\sdk]

如果未出現您想使用的版本，表示該版本尚未安裝。

下載與安裝 .NET SDK

1. 前往 .NET 官方下載頁面
2. 選擇對應版本（例如 .NET 9）與作業系統平台（Windows、macOS、Linux）
3. 下載並執行安裝程式

在 Visual Studio 中開啟命令提示字元

1. 開啟 Visual Studio
2. 選單列點選：工具 > 命令列 > 開發人員命令提示字元
3. 將會開啟一個已設定好開發環境路徑的命令提示字元視窗，可直接使用 dotnet 命令

若未看到此選項，您也可以使用 Windows 的開始選單搜尋「Developer Command Prompt for VS」開啟。

使用 Visual Studio 的內建終端機（2022 起支援）

1. 在 Visual Studio 中點選：檢視 > 終端機 或使用快速鍵 Ctrl + `
2. 選擇終端機類型（例如 PowerShell 或 CMD）
3. 可直接輸入 dotnet 命令檢查或操作 SDK

C# 語言

語言特色

• 由 Microsoft 開發，屬於 .NET 平台主要語言。
• 支援物件導向 (OOP)、泛型 (Generics)、LINQ、非同步程式 (async/await)。
• 跨平台：可透過 .NET 6/7/8 在 Windows、Linux、macOS 執行。

基本範例

using System;

class Program {
    static void Main() {
        string name = "世界";
        Console.WriteLine($"哈囉, {name}!");
    }
}

常見應用領域

• 桌面應用：Windows Forms, WPF
• 網頁開發：ASP.NET Core (MVC, Blazor, Web API)
• 行動應用：.NET MAUI, Xamarin
• 遊戲開發：Unity 使用 C# 為主要腳本語言
• 企業應用：ERP、CRM 等系統

進階功能

• Lambda 運算式：(x, y) => x + y
• LINQ 查詢：var q = list.Where(x => x > 10);
• 非同步：await Task.Delay(1000);
• Nullable 參考型別：強化空值安全性。
• Record 型別：用於不可變資料模型。

CS8618 非Nullable未初始化

警告內容

CS8618 意思是：在建構函式結束時，非 Nullable 的屬性沒有被初始化，因此 C# 編譯器警告它可能會是 null。

範例問題

public class Product {
    public string Name { get; set; }  // 警告 CS8618
}

解決方式

方法一：在建構函式中賦值（推薦）

public class Product {
    public string Name { get; set; }

    public Product(string name) {
        Name = name;
    }
}

方法二：給屬性預設值

public class Product {
    public string Name { get; set; } = string.Empty;
}

方法三：允許 Null

public class Product {
    public string? Name { get; set; }
}

→ 適用於 Name 合理允許為 null 的情況。

方法四：使用 required 修飾元（C# 11+ 支援）

public class Product {
    public required string Name { get; set; }
}

// 呼叫端必須初始化
var p = new Product { Name = "手機" }; // OK

建議

• 若屬性邏輯上絕對不能為 null：用 建構函式 或 required。
• 若允許 null：改成 string?。
• 若只是避免警告但沒有業務需求：給 預設值（如 string.Empty）。

.NET 程式

將 float 轉成字串避免科學記號

問題說明

System::String^ tmpStr = "Value: " + someFloat;

解決方式

範例程式

using namespace System;

float value = 123456.789f;

// 方法1：String::Format
String^ tmpStr1 = String::Format("Value: {0:F2}", value); // F2 表示小數點後 2 位
Console::WriteLine(tmpStr1);

// 方法2：ToString 搭配格式
String^ tmpStr2 = "Value: " + value.ToString("F2");
Console::WriteLine(tmpStr2);

// 方法3：更多位數
String^ tmpStr3 = "Value: " + value.ToString("F6");
Console::WriteLine(tmpStr3);

格式化代碼說明

• F2：固定小數點格式，小數點後 2 位
• F6：固定小數點格式，小數點後 6 位
• 若需根據需求動態設定小數位，可用 F{位數}

使用 .NET C++ 取得目錄中最新的檔案

簡介

在 .NET C++ 中，可以使用 System::IO 命名空間提供的功能來操作檔案與目錄。 取得目錄中最新的檔案，可以透過讀取所有檔案資訊並比較最後修改日期實現。

範例程式碼

以下是一個完整的範例，展示如何取得指定目錄中最新的檔案：

#include "stdafx.h"
#include <iostream>
#include <cliext/vector>
#include <System.IO>

using namespace System;
using namespace System::IO;
using namespace cliext;

int main()
{
    try
    {
        // 指定目錄路徑
        String^ directoryPath = "C:\\Your\\Directory\\Path";

        // 檢查目錄是否存在
        if (!Directory::Exists(directoryPath))
        {
            Console::WriteLine("目錄不存在: {0}", directoryPath);
            return -1;
        }

        // 取得目錄中的所有檔案
        array^ files = Directory::GetFiles(directoryPath);

        // 如果目錄中沒有檔案
        if (files->Length == 0)
        {
            Console::WriteLine("目錄中沒有檔案。");
            return 0;
        }

        // 找到最新的檔案
        String^ newestFile = nullptr;
        DateTime newestTime = DateTime::MinValue;

        for each (String^ file in files)
        {
            // 取得檔案的最後修改時間
            DateTime lastWriteTime = File::GetLastWriteTime(file);

            // 比較時間並更新最新檔案資訊
            if (lastWriteTime > newestTime)
            {
                newestTime = lastWriteTime;
                newestFile = file;
            }
        }

        // 輸出最新檔案資訊
        Console::WriteLine("最新檔案: {0}", newestFile);
        Console::WriteLine("最後修改時間: {0}", newestTime);
    }
    catch (Exception^ ex)
    {
        Console::WriteLine("發生錯誤: {0}", ex->Message);
    }

    return 0;
}

程式碼解說

• 取得檔案清單：使用 Directory::GetFiles 方法獲取指定目錄中的所有檔案路徑。
• 取得最後修改時間：使用 File::GetLastWriteTime 方法取得每個檔案的最後修改時間。
• 比較時間：將每個檔案的修改時間與當前最新時間進行比較，更新最新檔案的資訊。
• 錯誤處理：使用 try-catch 區塊捕獲潛在的異常，例如目錄不存在或無法存取。

應用場景

• 檔案管理系統：快速找到最新上傳或修改的檔案。
• 日誌分析：自動選擇最新的日誌檔案進行處理。
• 備份檢查：確保最近備份的檔案符合預期。

注意事項

• 確保目錄存在，否則需提前處理或提示用戶。
• 如果目錄中包含大量檔案，效能可能受到影響，可考慮額外優化。
• 權限問題：執行程式的用戶必須具備訪問目錄和檔案的權限。

.NET: System.Reflection

// 定義一個簡單的範例類別
public class SampleClass {
    public string SayHello(string name) {
        return $"Hello, {name}!";
    }
}

// 使用 Reflection 來動態調用方法
using System;
using System.Reflection;

class Program {
    static void Main() {
        // 創建 SampleClass 類別的實例
        Type sampleType = typeof(SampleClass);
        object sampleInstance = Activator.CreateInstance(sampleType);

        // 獲取 SayHello 方法資訊
        MethodInfo methodInfo = sampleType.GetMethod("SayHello");

        // 動態調用 SayHello 方法
        object result = methodInfo.Invoke(sampleInstance, new object[] { "World" });
        Console.WriteLine(result); // 輸出: Hello, World!
    }
}
        

System::Management::ManagementClass

用途

System::Management::ManagementClass 是 .NET Framework 中提供用於操作 Windows Management Instrumentation (WMI) 的類別之一。它允許開發者讀取、操作和管理系統資訊，例如硬體、作業系統、網路設定等。

命名空間

System::Management 是位於 System.Management.dll 中的命名空間，使用此功能需先加入參考。

常見用途

• 列出所有網路卡設定（Win32_NetworkAdapterConfiguration）
• 取得 CPU 或記憶體資訊
• 查詢服務、進程、磁碟、BIOS 等資訊

簡單範例

// C++/CLI 寫法
using namespace System;
using namespace System::Management;

int main() {
    try {
        ManagementClass^ mc = gcnew ManagementClass("Win32_OperatingSystem");
        for each (ManagementObject^ mo in mc->GetInstances()) {
            Console::WriteLine("OS 名稱: {0}", mo["Caption"]);
        }
    }
    catch (Exception^ ex) {
        Console::WriteLine("錯誤: {0}", ex->Message);
    }
    return 0;
}

常見錯誤與排除

• 需要在專案中加入對 System.Management.dll 的參考。
• 使用者執行程式時需要有足夠權限（某些 WMI 查詢需要管理員權限）。
• WMI 查詢字串拼寫錯誤可能導致 ManagementException。

相關類別

• ManagementObject
• ManagementObjectSearcher
• ManagementBaseObject

修復 Win32_NetworkAdapterConfiguration 發生 Invalid class 錯誤

錯誤代碼說明

• WMI 類別未註冊
• WMI 儲存庫受損
• 系統精簡或有組件缺失

解決步驟

net stop winmgmt
winmgmt /resetrepository
net start winmgmt

說明

• net stop winmgmt：停止 WMI 管理服務
• winmgmt /resetrepository：重建 WMI 儲存庫，修復損壞的類別資訊
• net start winmgmt：重新啟動 WMI 管理服務

修復後驗證

Get-WmiObject Win32_NetworkAdapterConfiguration

1. 按 Win + R，輸入 wbemtest
2. 點選「Connect」，輸入 root\cimv2 並連線
3. 點選「Query」，輸入 SELECT * FROM Win32_NetworkAdapterConfiguration

補充建議

• 請以系統管理員身分執行命令提示字元
• 若常發生 WMI 問題，可使用 DISM /Online /Cleanup-Image /RestoreHealth 修復系統映像
• 重設儲存庫前請關閉相關依賴服務，並避免正在使用 WMI 的程式

.NET 程式在 Chromebook 上執行方法

1. 使用 Chromebook 的 Linux 支援執行 .NET

大多數現代 Chromebook 支援透過 Crostini 專案來運行 Linux 應用程式。

1. 啟用 Linux 功能：
   • 進入 設定 > 進階 > 開發人員 > 啟用 Linux (Beta)。
2. 安裝 .NET SDK：
   • 打開 Linux 終端機，依照 Microsoft 官方網站的指引安裝。
   • 例如：

     sudo apt update
     sudo apt install -y dotnet-sdk-7.0

3. 在終端機中編譯並執行 .NET 應用程式。

2. 使用雲端開發環境

無需在本地安裝任何軟體，即可在 Chromebook 上使用雲端平台運行 .NET 程式。

• 推薦選項：
  • GitHub Codespaces
  • Visual Studio Code for Web
  • Replit

3. 使用 Docker 容器運行 .NET

Chromebook 支援使用容器運行應用程式，您可以透過 Docker 啟動 .NET 環境。

1. 在 Linux 環境中安裝 Docker。
2. 下載 .NET 容器映像檔：

   docker pull mcr.microsoft.com/dotnet/runtime:7.0

3. 在容器內運行您的 .NET 程式。

4. 使用跨平台支援功能

從 .NET 6 開始，應用程式可以跨多平台運行，包括 Linux。將您的應用程式編譯為跨平台格式並部署至 Chromebook。

1. 在任何機器上編譯您的應用程式：

   dotnet publish -c Release -r linux-x64 --self-contained

2. 將編譯好的檔案傳輸到 Chromebook，使用附帶的運行時執行。

注意事項

• 效能：在低階 Chromebook 上執行 .NET 應用程式可能會較慢。
• 相依性：若應用程式依賴於 Windows 特定 API，可能無法正常運行。
• 機型支援：請確認您的 Chromebook 支援 Linux 或虛擬化功能。

.NET UI 程式設計

主要技術

• Windows Forms (WinForms)：較早期的 UI 框架，簡單易學，適合中小型桌面應用。
• WPF (Windows Presentation Foundation)：支援資料繫結、樣式、動畫與 XAML 語法，適合大型桌面應用。
• UWP (Universal Windows Platform)：針對 Windows 10/11 平台設計，可運行於 PC、平板、Xbox 等裝置。
• MAUI (.NET Multi-platform App UI)：支援跨平台（Windows、Android、iOS、macOS）的 UI 開發，是 Xamarin.Forms 的進化版。
• Blazor (Web UI)：用 C# 寫前端 Web UI，可執行在瀏覽器（WebAssembly）或伺服器端。

簡單 WinForms 範例

using System;
using System.Windows.Forms;

public class MyForm : Form {
    public MyForm() {
        Button btn = new Button();
        btn.Text = "點我";
        btn.Click += (s, e) => MessageBox.Show("你點了按鈕！");
        Controls.Add(btn);
    }

    [STAThread]
    static void Main() {
        Application.EnableVisualStyles();
        Application.Run(new MyForm());
    }
}

簡單 WPF 範例 (XAML + C#)

// MainWindow.xaml
<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        Title="WPF 範例" Height="200" Width="300">
    <StackPanel>
        <Button Content="點我" Click="Button_Click"/>
    </StackPanel>
</Window>

// MainWindow.xaml.cs
private void Button_Click(object sender, RoutedEventArgs e) {
    MessageBox.Show("你點了按鈕！");
}

簡單 MAUI 範例

// MainPage.xaml
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             x:Class="MyApp.MainPage">
    <VerticalStackLayout Spacing="25" Padding="30">
        <Button Text="點我" Clicked="OnButtonClicked"/>
    </VerticalStackLayout>
</ContentPage>

// MainPage.xaml.cs
private void OnButtonClicked(object sender, EventArgs e) {
    await DisplayAlert("通知", "你點了按鈕！", "OK");
}

UI 技術選擇建議

.NET 遍歷子控制項以批量修改屬性

以下範例展示了如何使用 Controls->GetEnumerator() 方法來逐一遍歷 .NET 表單中的所有子控制項並批量修改其屬性。

範例程式碼：

using System;
using System.Drawing;
using System.Windows.Forms;

public class FormExample : Form
{
    public FormExample()
    {
        // 初始化一些控制項
        Button button1 = new Button { Text = "Button 1", Location = new Point(10, 10) };
        TextBox textBox1 = new TextBox { Location = new Point(10, 50) };
        
        Controls.Add(button1);
        Controls.Add(textBox1);

        // 使用 GetEnumerator() 遍歷並修改控制項屬性
        ModifyControls();
    }

    private void ModifyControls()
    {
        var enumerator = Controls.GetEnumerator();
        
        while (enumerator.MoveNext())
        {
            Control control = (Control)enumerator.Current;

            // 設定範例：將所有控制項的背景色設為淺藍
            control.BackColor = Color.LightBlue;
            
            // 若控制項為 TextBox，將其設為不可編輯
            if (control is TextBox)
            {
                control.Enabled = false;
            }
        }
    }
    
    // 啟動應用程式
    public static void Main()
    {
        Application.Run(new FormExample());
    }
}

說明

**GetEnumerator()**: 利用 `Controls.GetEnumerator()` 方法來取得控制項的列舉器，這樣可以遍歷所有子控制項。

**條件修改**: 在 `while` 迴圈中，對每個 `Control` 物件進行屬性修改，例如將背景色設為淺藍，並根據控制項類型進行特定修改，如將 `TextBox` 設為不可編輯。

**用途**: 這種方法在需要批量修改屬性時非常有效，比如調整 UI 風格或在特定情況下禁用多個控制項。

執行效果

執行後，所有控制項的背景色會變成淺藍色，且所有 `TextBox` 控制項將被設為不可編輯。

.NET StackTrace中取得 Message m 的內容

問題背景

當堆疊追蹤中出現以下錯誤訊息時，開發者可能需要檢查 Message 物件的內容：

   at ....MainForm.Dispose(Boolean A_0)
   at System.Windows.Forms.Form.WmClose(Message& m)
   at System.Windows.Forms.NativeWindow.Callback(IntPtr hWnd, Int32 msg, IntPtr wparam, IntPtr lparam)
   ...
    

此時需要透過覆寫或檢測 WndProc 方法中的 Message m 來檢查其詳細資訊。

解決方法

以下提供幾種方法來檢查或記錄 Message 物件的內容。

1. 覆寫 WndProc 方法

如果可以存取表單或控制項的原始碼，建議覆寫 WndProc 方法，直接記錄或檢查 Message m 的內容。

protected override void WndProc(ref Message m)
{
    try
    {
        // 記錄 Message 的內容
        Console.WriteLine($"Message Details: hWnd={m.HWnd}, Msg={m.Msg}, WParam={m.WParam}, LParam={m.LParam}");
        base.WndProc(ref m);
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Exception: {ex}");
        throw; // 保持原有例外行為
    }
}

    

這段程式碼會在每次接收到訊息時記錄相關資訊，並允許開發者進一步分析。

2. 在 Dispose 方法中加入例外處理

如果錯誤發生在 Dispose 方法中，可以在方法內加入例外處理來檢查相關資訊。

protected override void Dispose(bool disposing)
{
    try
    {
        if (disposing)
        {
            // 釋放資源
        }
        base.Dispose(disposing);
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Exception in Dispose: {ex}");
        throw;
    }
}

    

這樣可以確保在釋放資源時不會忽略重要的錯誤資訊。

3. 使用全域例外處理

如果無法確定錯誤發生的位置，可以透過全域例外處理來記錄堆疊追蹤和相關資訊。

AppDomain.CurrentDomain.UnhandledException += (sender, args) =>
{
    Exception ex = (Exception)args.ExceptionObject;
    Console.WriteLine($"Unhandled Exception: {ex}");
    Environment.Exit(1);
};

    

4. 使用 Debug 工具檢查 Message

可以使用 Visual Studio 將斷點設置在 WndProc 或 Dispose 方法中，並檢查 Message 物件的內容。

Message 物件的關鍵屬性

• HWnd：接收訊息的視窗句柄。
• Msg：訊息的 ID。
• WParam：附加訊息資訊（字參數）。
• LParam：附加訊息資訊（長參數）。

注意事項

• 覆寫 WndProc 或修改程式碼需小心，避免影響現有行為。
• 如果 Message 的座標或 ID 不固定，可考慮加入條件判斷來篩選需要的訊息。
• 查閱 [Windows Messages 文件](https://learn.microsoft.com/en-us/windows/win32/winmsg/about-messages-and-message-queues) 以了解訊息 ID 的用途。

覆寫 Form.WmClose(Message& m) 在 .NET C++

問題背景

在 .NET C++/CLI 中，WmClose(Message& m) 是 System.Windows.Forms.Form 的內部保護方法，無法直接覆寫。不過，可以透過覆寫 WndProc 方法來攔截並處理 WM_CLOSE 訊息，以達到類似覆寫 WmClose 的效果。

完整範例

#include <Windows.h>
#include <System.Windows.Forms.h>

using namespace System;
using namespace System::Windows::Forms;

public ref class CustomForm : public Form
{
protected:
    // 模擬 WmClose 行為的覆寫
    void WmClose(Message% m)
    {
        // 在這裡加入自定義的 WM_CLOSE 行為
        if (MessageBox::Show("確定要關閉視窗嗎？", "確認", MessageBoxButtons::YesNo) == DialogResult::Yes)
        {
            // 繼續調用基底行為以進行正常關閉
            this->Form::WndProc(m);
        }
        else
        {
            // 阻止關閉視窗
            return;
        }
    }

    // 覆寫 WndProc，攔截 WM_CLOSE 訊息並調用 WmClose
    virtual void WndProc(Message% m) override
    {
        const int WM_CLOSE = 0x0010;

        if (m.Msg == WM_CLOSE)
        {
            WmClose(m); // 調用自定義的 WmClose 方法
        }
        else
        {
            // 處理其他訊息
            Form::WndProc(m);
        }
    }
};

[STAThread]
int main(array<String^>^ args)
{
    Application::EnableVisualStyles();
    Application::SetCompatibleTextRenderingDefault(false);

    CustomForm^ form = gcnew CustomForm();
    form->Text = "覆寫 WmClose 行為範例";
    Application::Run(form);

    return 0;
}

    

程式碼解釋

1. WmClose 方法

模擬覆寫 WmClose 方法，在這裡自定義視窗關閉的行為。透過確認對話框詢問使用者是否要關閉視窗。

2. 覆寫 WndProc

覆寫 WndProc 方法來攔截 WM_CLOSE 訊息，並將其委派給自定義的 WmClose 方法。

3. 繼續處理其他訊息

在沒有攔截 WM_CLOSE 的情況下，調用基底類別的 WndProc 方法處理其他訊息。

注意事項

• WmClose 方法僅是模擬覆寫，實際上是透過攔截訊息進行處理。
• 調用 Form::WndProc 以確保基底行為正常運作。
• 請務必正確處理訊息以避免影響其他功能。

System::Windows::Forms::Control::InvokeRequired

用途說明

完整範例：設定 PictureBox 圖片

using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;

ref class ImageHelper {
public:
    static void SetImageSafe(PictureBox^ pPictureBox, Bitmap^ b) {
        if (pPictureBox == nullptr)
            return;

        if (pPictureBox->InvokeRequired) {
            // 使用 MethodInvoker 呼叫同一函式，但於 UI 執行緒執行
            pPictureBox->Invoke(
                gcnew MethodInvoker(gcnew Action(ImageHelper::InvokeCallback), 
                gcnew Tuple(pPictureBox, b))
            );
        } else {
            ApplyImage(pPictureBox, b);
        }
    }

private:
    // 封送的函式代理
    static void InvokeCallback(Object^ state) {
        Tuple^ args = static_cast^>(state);
        ApplyImage(args->Item1, args->Item2);
    }

    // 實際執行設定圖片邏輯
    static void ApplyImage(PictureBox^ pPictureBox, Bitmap^ b) {
        try {
            if (b != nullptr) {
                if (pPictureBox->Image != nullptr)
                    delete pPictureBox->Image;
                pPictureBox->Image = b;
            }
        }
        catch (System::Exception^ ex) {
            Console::WriteLine("設定圖片失敗: " + ex->Message);
        }
    }
};

重點整理

• InvokeRequired 只能用於繼承 Control 的物件（如 PictureBox）。
• 若為 true，代表目前執行緒不是 UI 執行緒，必須用 Invoke。
• 使用 Tuple 封裝多參數並傳入靜態代理函式處理。
• 使用 try-catch 捕捉例外避免程式崩潰。

保護 pPictureBox->Image = b 避免程式崩潰

可能發生崩潰的原因

• 嘗試從非 UI 執行緒存取 UI 控件
• 圖片物件 b 為 nullptr 或已被釋放
• 先前的圖片未釋放，導致 GDI 資源耗盡

安全設定圖片的建議作法

using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;

void SetImageSafe(PictureBox^ pPictureBox, Bitmap^ b) {
    if (pPictureBox->InvokeRequired) {
        pPictureBox->Invoke(gcnew MethodInvoker(
            gcnew EventHandler(nullptr, &SetImageInvoker)
        ), gcnew array { pPictureBox, b });
    } else {
        SetImageInternal(pPictureBox, b);
    }
}

void SetImageInvoker(Object^ sender, EventArgs^ e) {
    // 不使用此版本，可忽略，保留為完整形式參考
}

void SetImageInternal(PictureBox^ pPictureBox, Bitmap^ b) {
    try {
        if (b != nullptr) {
            if (pPictureBox->Image != nullptr)
                delete pPictureBox->Image;

            pPictureBox->Image = b;
        }
    }
    catch (System::Exception^ ex) {
        Console::WriteLine("設定圖片失敗: " + ex->Message);
    }
}

簡化版本（建議使用匿名委派）

using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;

void SafeAssignImage(PictureBox^ pPictureBox, Bitmap^ b) {
    if (pPictureBox->InvokeRequired) {
        pPictureBox->Invoke(gcnew MethodInvoker(gcnew delegate {
            try {
                if (b != nullptr) {
                    if (pPictureBox->Image != nullptr)
                        delete pPictureBox->Image;
                    pPictureBox->Image = b;
                }
            } catch (System::Exception^ ex) {
                Console::WriteLine("設定圖片失敗: " + ex->Message);
            }
        }));
    } else {
        try {
            if (b != nullptr) {
                if (pPictureBox->Image != nullptr)
                    delete pPictureBox->Image;
                pPictureBox->Image = b;
            }
        } catch (System::Exception^ ex) {
            Console::WriteLine("設定圖片失敗: " + ex->Message);
        }
    }
}

補充說明

• gcnew MethodInvoker(...) 必須是合法的委派，不支援 C++11 lambda（如 [=]()）語法。
• 若要傳參數，可用 BeginInvoke 搭配 Object^ 陣列並解析。
• 釋放先前的 Image 是關鍵步驟，避免 GDI 資源不足。

以 Blazor 建立統一語言的前端開發環境

什麼是 Blazor？

Blazor 是由微軟推出的前端框架，允許開發者使用 C# 和 Razor 語法來建立互動式 Web 應用程式，無需使用 JavaScript，即可在瀏覽器中執行 C# 程式碼。

開發者效益

• 使用熟悉的 C# 與 .NET 技術堆疊進行全端開發
• 共用後端與前端的程式庫與商業邏輯
• 降低學習曲線，提升開發效率

Blazor 模式

• Blazor Server：使用 SignalR 維持與伺服器的連線，由伺服器處理 UI 邏輯
• Blazor WebAssembly：將 C# 程式碼編譯成 WebAssembly，在瀏覽器端執行

與 .NET 的整合

Blazor 無縫整合 ASP.NET Core，可與現有的 .NET 應用程式結合，並支援依賴注入、路由、元件架構等功能。

部署方式

• 可部署為獨立的靜態網站
• 或整合於 ASP.NET Core 專案中發佈
• 支援 Azure、GitHub Pages、Docker 等多種環境

小結

對於以 .NET 為主要技術的開發者而言，Blazor 提供了與 Node.js 統一 JavaScript 語言相對應的解決方案，使前後端都能使用 C#，建立一致性更高的開發體驗。

使用 .NET MAUI 建立跨平台應用

什麼是 .NET MAUI？

.NET MAUI（Multi-platform App UI）是微軟推出的跨平台應用框架，可使用 C# 和 XAML 撰寫一次程式碼，部署到 Windows、Android、iOS 甚至 macOS。

開發者效益

• 統一使用 C# 開發前後端與 UI
• 共用商業邏輯、資料模型與服務
• 簡化多平台維護與開發流程

支援的平台

• 桌面：Windows（WinUI）、macOS（MacCatalyst）
• 行動：Android、iOS
• Web（搭配 Blazor）：可結合 Blazor 建構混合式 Web App

Blazor Hybrid 模式

可使用 .NET MAUI 的 Blazor Hybrid 模式，在原生應用中嵌入 Web UI，讓開發者用 Razor 組件開發跨平台使用者介面，仍可存取原生 API。

整合與部署

• 與 .NET 7 / .NET 8 完整整合，使用 Visual Studio 提供強大設計與除錯工具
• 部署至 Microsoft Store、Google Play 或直接發佈安裝檔
• 支援 DevOps 與 CI/CD 流程整合

小結

.NET MAUI 是目前最完整的 .NET 跨平台解決方案，可結合 Blazor 達成 Web、桌面與行動平台的統一應用開發，提供給 .NET 開發者一個語言與技術一致的全端體驗。

ASP.NET Core 與 .NET MAUI 的比較

定位

• ASP.NET Core：用於開發跨平台的伺服器端 Web 應用程式與 API。
• .NET MAUI：用於開發跨平台的用戶端應用程式（桌面與行動裝置）。

支援平台

• ASP.NET Core：Windows、Linux、macOS 上的伺服器環境，輸出為網頁或 API。
• .NET MAUI：Android、iOS、Windows、macOS，用於建立原生 GUI 應用。

開發語言

• 兩者皆使用 C# 與 .NET 平台。

UI 與互動

• ASP.NET Core：透過 Razor Pages、MVC、Blazor 等方式輸出 HTML/CSS/JS，依賴瀏覽器呈現。
• .NET MAUI：使用 XAML 或 C# 建立跨平台原生 UI，直接呈現在行動裝置或桌面。

適用場景

• ASP.NET Core：企業級 Web 系統、後端 API、雲端應用。
• .NET MAUI：跨平台 App、行動應用、桌面應用。

整合性

.NET MAUI 可透過 API 呼叫與 ASP.NET Core 建立的後端服務整合，形成完整的「前端 App + 後端 API」架構。

總結

ASP.NET Core 解決「後端服務」與「Web 應用」問題，.NET MAUI 則專注在「用戶端跨平台 App」。兩者並不互斥，反而常搭配使用，構成完整解決方案。

簡單的 .NET MAUI 應用範例

建立基本的 .NET MAUI 應用

以下是一個使用 .NET MAUI 建立的跨平台應用程式範例，這個應用在畫面上顯示一個按鈕，點擊後會更新文字計數。

主要檔案：MainPage.xaml

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MauiApp.MainPage">

    <VerticalStackLayout Spacing="25" Padding="30">
        <Label x:Name="counterLabel"
               Text="你尚未點擊按鈕"
               FontSize="24"
               HorizontalOptions="Center" />

        <Button Text="點我"
                Clicked="OnCounterClicked"
                HorizontalOptions="Center" />
    </VerticalStackLayout>
</ContentPage>

後端程式碼：MainPage.xaml.cs

namespace MauiApp;

public partial class MainPage : ContentPage
{
    int count = 0;

    public MainPage()
    {
        InitializeComponent();
    }

    private void OnCounterClicked(object sender, EventArgs e)
    {
        count++;
        counterLabel.Text = $"你已經點擊了 {count} 次";
    }
}

執行方式

• 在 Visual Studio 中選擇目標平台（Windows / Android / iOS）
• 點擊執行，即可看到跨平台 UI

小結

這個簡單的範例展示了 .NET MAUI 的跨平台能力，開發者只需撰寫一次 XAML 與 C# 程式碼，即可同時在多個平台運作。

在 Visual Studio 中建立 .NET MAUI 專案

步驟一：安裝必要工具

• 下載並安裝 Visual Studio 2022 17.3 以上版本 或 Visual Studio 2022 for Mac
• 安裝時選擇「.NET MAUI（多平台應用 UI 開發）」工作負載

步驟二：建立新的 MAUI 專案

1. 開啟 Visual Studio
2. 點選「建立新專案」
3. 搜尋並選擇「.NET MAUI App」範本
4. 按「下一步」，輸入專案名稱與位置
5. 點選「建立」完成專案初始化

步驟三：了解專案結構

• MainPage.xaml：定義 UI 介面（使用 XAML）
• MainPage.xaml.cs：後端程式碼（C#）處理事件
• MauiProgram.cs：應用程式啟動與服務註冊點
• Platforms 資料夾：各平台的原生設定（Android、iOS、Windows、MacCatalyst）

步驟四：執行應用程式

• 在 Visual Studio 的工具列中選擇平台目標（例如 Windows、Android 模擬器）
• 點擊「執行」按鈕，應用將在對應平台啟動

補充說明

• 開發 Android 應用需要安裝 Android SDK 和模擬器
• iOS 需使用 Mac 並連接 Xcode

小結

使用 Visual Studio 建立 .NET MAUI 專案只需幾個步驟，且能一套程式碼同時部署到多個平台，是現代 C# 全端開發者的理想選擇。

MainPage.xaml 實例與解釋

範例：MainPage.xaml

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MyMauiApp.MainPage">

    <VerticalStackLayout Spacing="25" Padding="30"
                         VerticalOptions="Center">

        <Label 
            Text="歡迎使用 .NET MAUI！" 
            SemanticProperties.HeadingLevel="Level1"
            FontSize="32"
            HorizontalOptions="Center" />

        <Button 
            x:Name="counterBtn"
            Text="點我！" 
            Clicked="OnCounterClicked"
            HorizontalOptions="Center" />

    </VerticalStackLayout>

</ContentPage>

對應的 MainPage.xaml.cs

using System;
namespace MyMauiApp;

public partial class MainPage : ContentPage
{
    int count = 0;

    public MainPage()
    {
        InitializeComponent();
    }

    private void OnCounterClicked(object sender, EventArgs e)
    {
        count++;
        counterBtn.Text = $"你已經點了 {count} 次";
    }
}

元件說明

• <ContentPage>：MAUI 中代表一個頁面的基本類型，類似於一個畫面或視窗。
• <VerticalStackLayout>：垂直堆疊容器，讓內部元素依序由上往下排列。可設定 Spacing（間距）與 Padding（內距）。
• <Label>：顯示靜態文字的控制項。這裡設定了大字體與置中對齊。
• <Button>：按鈕控制項，設定 x:Name 以供 C# 後端存取，Clicked 屬性指定點擊事件處理方法。

C# 程式碼說明

• InitializeComponent()：初始化 XAML 中定義的 UI 結構。
• OnCounterClicked：點擊事件的處理方法，每點一次按鈕就更新按鈕文字。
• counterBtn.Text：透過 XAML 中指定的名稱來控制該按鈕的屬性。

結果效果

執行後，畫面中央會顯示一個歡迎訊息與一個按鈕。每次點擊按鈕，按鈕上的文字就會更新為「你已經點了 X 次」。

MauiProgram.cs 實例與解釋

範例：MauiProgram.cs

using Microsoft.Extensions.Logging;

namespace MyMauiApp;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        
        builder
            .UseMauiApp() // 指定應用程式的進入點
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
                fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
            });

#if DEBUG
        builder.Logging.AddDebug();
#endif

        return builder.Build();
    }
}

功能說明

• public static MauiApp CreateMauiApp()：這是整個應用程式的入口方法之一，負責組裝與回傳一個可執行的 MauiApp 實例。
• MauiApp.CreateBuilder()：建立應用程式的建構器（Builder），用來設定應用的基本行為與服務。
• UseMauiApp<App>()：指定應用程式的主類別（通常為 App.xaml.cs 中的 App 類別），這會是應用程式的根組件。
• ConfigureFonts()：註冊字型檔案，使其在應用中可用。左邊是實體檔名，右邊是代稱，XAML 或 C# 可透過代稱使用字型。
• #if DEBUG ... #endif：在除錯模式下新增除錯輸出記錄器（Logger），方便偵錯用。
• builder.Build()：根據上方的設定產生最終應用實例。

常見擴充

• 註冊服務（DI）：

  builder.Services.AddSingleton<MainPage>();

  這樣可讓 MainPage 使用依賴注入方式載入，例如在 App 類中使用 serviceProvider.GetService<MainPage>()。
• 註冊 ViewModel 或其他類別：

  builder.Services.AddTransient<MyViewModel>();
  builder.Services.AddSingleton<IMyService, MyService>();
      

總結

MauiProgram.cs 就像 ASP.NET Core 的 Startup.cs 或 Program.cs，是應用啟動與服務註冊的主要設定中心。開發大型 MAUI 應用時，擴充此檔案來加入 DI、日誌、組件設定等是非常常見的做法。

email: [email protected]

T:0000

資訊與搜尋 | 回dev首頁
email: Yan Sa [email protected] Line: 阿央
電話: 02-27566655 ,03-5924828

阿央
泱泱科技
捷昱科技泱泱企業