萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# extern 修飾符完整指南:平台呼叫 (P/Invoke)、外部組件別名與實戰範例

核心用途

  1. 宣告外部非受控實作方法:配合 [DllImport] 呼叫 C/C++ DLL、Windows API、COM 元件。
  2. 外部組件別名:解決專案參考同一組件不同版本的衝突。

一、平台呼叫 (P/Invoke) 完整範例

using System;
using System.Runtime.InteropServices;

public class WinMM {
    // 1. 宣告外部方法:static extern + DllImport
    [DllImport("winmm.dll", EntryPoint = "PlaySound",
               SetLastError = true, CharSet = CharSet.Auto)]
    public static extern bool PlaySound(string pszSound, IntPtr hmod, PlaySoundFlags fdwSound);

    // 2. 定義旗標列舉 (對應 C++ DWORD)
    [Flags]
    public enum PlaySoundFlags : uint {
        SND_SYNC = 0x0000,  // 同步播放
        SND_ASYNC = 0x0001, // 非同步
        SND_NODEFAULT = 0x0002,
        SND_LOOP = 0x0008,
        SND_FILENAME = 0x00020000 // pszSound 為檔案路徑
    }

    // 3. 使用範例
    public static void PlayWav(string path) {
        if (!PlaySound(path, IntPtr.Zero, PlaySoundFlags.SND_SYNC | PlaySoundFlags.SND_FILENAME)) {
            int err = Marshal.GetLastWin32Error();
            throw new System.ComponentModel.Win32Exception(err, "PlaySound 失敗");
        }
    }
}

// 呼叫
WinMM.PlayWav(@"C:\Windows\Media\chord.wav");

關鍵屬性解析

屬性/修飾詞說明
extern告訴編譯器方法在外部實作 (非 CIL),不可省略。
staticP/Invoke 方法必須為 static,因無 this 指標。
DllImport指定 DLL 檔名、進入點、字元集、呼叫慣例、SetLastError 等。
CharSetAnsi/Unicode/Auto 決定字串封送字元編碼。
CallingConvention預設 Winapi (Windows 上為 StdCall),C++ DLL 常用 Cdecl。
MarshalAs參數/回傳值封送細節 (如 LPArray、BStr、CustomMarshaler)。
In/Out/InOut指定資料流向,優化封送效能。

二、外部組件別名

專案同時參考 Lib.v1.dll 與 Lib.v2.dll (兩者類型名稱相同) 時:

  1. 專案屬性 → 參考 → 選取組件 → 「別名」欄位設定 (如 v1, v2)。
  2. 程式碼頂端宣告:
    extern alias v1;
    extern alias v2;
  3. 使用時:
    v1::Namespace.ClassA obj1 = new v1::Namespace.ClassA();
    v2::Namespace.ClassA obj2 = new v2::Namespace.ClassA();

常見陷阱與最佳實務

  1. 字串封送:預設 CharSet.Auto 在 Windows 上為 Unicode (UTF-16),C++ char* 需指定 CharSet.Ansi 或手動 Marshal.StringToHGlobalAnsi。
  2. 結構體配置:[StructLayout(LayoutKind.Sequential, Pack=1)] 對齊需與 C++ #pragma pack 一致。
  3. 記憶體釋放:非受控配置的記憶體 (如 CoTaskMemAlloc) 需對應 Marshal.FreeCoTaskMem,或定義 SafeHandle 衍生類封裝。
  4. 32/64 位元:IntPtr 對應原生指標大小,避免用 int 接收指標。
  5. 例外處理:非受控例外不會跨越邊界,需檢查回傳值/GetLastError/HRESULT。

結語

extern 是 C# 連結非受控世界的橋樑。掌握 DllImport 完整屬性、封送規則、記憶體管理與組件別名機制,能安全、高效地整合 C/C++ 庫、系統 API 與多版本組件。

copyright © 萬盛學電腦網 all rights reserved