ASP.net/C#中如何調用動態鏈接庫DLL

動態鏈接庫（也稱爲DLL，即爲“Dynamic Link Library”的縮寫）是Microsoft Windows最重要的組成要素之一，打開Windows系統文件夾，你會發現文件夾中有很多DLL文件，Windows就是將一些主要的系統功能以DLL模塊的形式實現。 
動態鏈接庫是不能直接執行的，也不能接收消息，它只是一個獨立的文件，其中包含能被程序或其它DLL調用來完成一定操作的函數(方法。注：C#中一般稱爲“方法”)，但這些函數不是執行程序本身的一部分，而是根據進程的需要按需載入，此時才能發揮作用。
DLL只有在應用程序需要時才被系統加載到進程的虛擬空間中，成爲調用進程的一部分，此時該DLL也只能被該進程的線程訪問，它的句柄可以被調用進程所使用，而調用進程的句柄也可以被該DLL所使用。在內存中，一個DLL只有一個實例，且它的編制與具體的編程語言和編譯器都沒有關係，所以可以通過DLL來實現混合語言編程。DLL函數中的代碼所創建的任何對象（包括變量）都歸調用它的線程或進程所有。
下面列出了當程序使用 DLL 時提供的一些優點：[1]
1)        使用較少的資源
當多個程序使用同一個函數庫時，DLL 可以減少在磁盤和物理內存中加載的代碼的重複量。這不僅可以大大影響在前臺運行的程序，而且可以大大影響其他在 Windows 操作系統上運行的程序。 
2)        推廣模塊式體系結構
DLL 有助於促進模塊式程序的開發。這可以幫助您開發要求提供多個語言版本的大型程序或要求具有模塊式體系結構的程序。模塊式程序的一個示例是具有多個可以在運行時動態加載的模塊的計帳程序。 
3)        簡化部署和安裝
當 DLL 中的函數需要更新或修復時，部署和安裝 DLL 不要求重新建立程序與該 DLL 的鏈接。此外，如果多個程序使用同一個 DLL，那麼多個程序都將從該更新或修復中獲益。當您使用定期更新或修復的第三方 DLL 時，此問題可能會更頻繁地出現。 
每種編程語言調用DLL的方法都不盡相同，在此只對用C#調用DLL的方法進行介紹。首先,您需要了解什麼是託管,什麼是非託管。一般可以認爲：非託管代碼主要是基於win 32平臺開發的DLL，activeX的組件，託管代碼是基於.net平臺開發的。如果您想深入瞭解託管與非託管的關係與區別，及它們的運行機制，請您自行查找資料，本文件在此不作討論。 
(一)     調用DLL中的非託管函數一般方法
首先，應該在C#語言源程序中聲明外部方法，其基本形式是：
[DLLImport(“DLL文件”)]
修飾符 extern 返回變量類型 方法名稱 （參數列表）
其中：
DLL文件：包含定義外部方法的庫文件。
修飾符： 訪問修飾符，除了abstract以外在聲明方法時可以使用的修飾符。
返回變量類型：在DLL文件中你需調用方法的返回變量類型。
方法名稱：在DLL文件中你需調用方法的名稱。
參數列表：在DLL文件中你需調用方法的列表。
注意：需要在程序聲明中使用System.Runtime.InteropServices命名空間。
      DllImport只能放置在方法聲明上。
DLL文件必須位於程序當前目錄或系統定義的查詢路徑中（即：系統環境變量中Path所設置的路徑）。
返回變量類型、方法名稱、參數列表一定要與DLL文件中的定義相一致。
若要使用其它函數名，可以使用EntryPoint屬性設置，如：
[DllImport("user32.dll", EntryPoint="MessageBoxA")]
static extern int MsgBox(int hWnd, string msg, string caption, int type);
其它可選的 DllImportAttribute 屬性：阿
CharSet 指示用在入口點中的字符集，如：CharSet=CharSet.Ansi；
SetLastError 指示方法是否保留 Win32"上一錯誤"，如：SetLastError=true；
ExactSpelling 指示 EntryPoint 是否必須與指示的入口點的拼寫完全匹配，如：ExactSpelling=false；
PreserveSig指示方法的簽名應當被保留還是被轉換， 如：PreserveSig=true；
CallingConvention指示入口點的調用約定， 如：CallingConvention=CallingConvention.Winapi；
此外，關於“數據封送處理”及“封送數字和邏輯標量”請參閱其它一些文章[2]。
C#例子：

1.       啓動VS.NET，新建一個項目，項目名稱爲“Tzb”，模板爲“Windows 應用程序”。
2.       在“工具箱”的“ Windows 窗體”項中雙擊“Button”項，向“Form1”窗體中添加一個按鈕。
3.       改變按鈕的屬性：Name爲 “B1”，Text爲 “用DllImport調用DLL彈出提示框”，並將按鈕B1調整到適當大小，移到適當位置。
4.       在類視圖中雙擊“Form1”，打開“Form1．cs”代碼視圖，在“namespace Tzb”上面輸入“using System.Runtime.InteropServices;”，以導入該命名空間。
5.       在“Form1．cs［設計］”視圖中雙擊按鈕B1，在“B1_Click”方法上面使用關鍵字 static 和 extern 聲明方法“MsgBox”，將 DllImport 屬性附加到該方法，這裏我們要使用的是“user32．dll”中的“MessageBoxA”函數，具體代碼如下：
[DllImport("user32.dll", EntryPoint="MessageBoxA")]
static extern int MsgBox(int hWnd, string msg, string caption, int type);

然後在“B1_Click”方法體內添加如下代碼，以調用方法“MsgBox”：
MsgBox(0," 這就是用 DllImport 調用 DLL 彈出的提示框哦！ "," 挑戰杯 ",0x30);
6.       按“F5”運行該程序，並點擊按鈕B1，便彈出如下提示框：

7.代碼如下：

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using System.Runtime.InteropServices;

namespace WindowsFormsApplication1
{

    public partial class Form1 : Form
    {
        [DllImport("user32.dll", EntryPoint = "MessageBoxA")]
        static extern int MsgBox2(int hWnd, string msg, string caption, int type);
        public Form1()
        {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e)
        {

        }

        
        private void button1_Click(object sender, EventArgs e)
        {
            MsgBox2(0, " 這就是用 DllImport 調用 DLL 彈出的提示框哦！ ", " 挑戰杯 ", 0x30);
        }

        private void button2_Click(object sender, EventArgs e)
        {
            MsgBox2(0, " 這就是用 DllImport 調用 DLL 彈出的提示框哦222222f！ ", " 222222 ", 0x30);

        }
    }
}

(二)     動態裝載、調用DLL中的非託管函數
在上面已經說明了如何用DllImport調用DLL中的非託管函數，但是這個是全局的函數，假若DLL中的非託管函數有一個靜態變量S，每次調用這個函數的時候，靜態變量S就自動加1。結果，當需要重新計數時，就不能得出想要的結果。下面將用例子說明：
1.        DLL的創建
1)        啓動Visual C++ 6.0；
2)        新建一個“Win32 Dynamic-Link Library”工程，工程名稱爲“Count”；
3)        在“Dll kind”選擇界面中選擇“A simple dll project”；
4)        打開Count.cpp，添加如下代碼：
// 導出函數，使用“ _stdcall ” 標準調用
extern "C" _declspec(dllexport)int _stdcall count(int init);
int _stdcall count(int init)
{//count 函數，使用參數 init 初始化靜態的整形變量 S ，並使 S 自加 1 後返回該值
static int S=init;
S++;
return S;
}

5)        按“F7”進行編譯，得到Count.dll（在工程目錄下的Debug文件夾中）。
2.         用DllImport調用DLL中的count函數
1)        打開項目“Tzb”，向“Form1”窗體中添加一個按鈕。
2)        改變按鈕的屬性：Name爲 “B2”，Text爲 “用DllImport調用DLL中count函數”，並將按鈕B1調整到適當大小，移到適當位置。
3)        打開“Form1．cs”代碼視圖，使用關鍵字 static 和 extern 聲明方法“count”，並使其具有來自 Count.dll 的導出函數count的實現，代碼如下：

[DllImport("Count.dll")]
static extern int count(int init);

4)        在“Form1．cs［設計］”視圖中雙擊按鈕B2，在“B2_Click”方法體內添加如下代碼：
MessageBox.Show(" 用 DllImport 調用 DLL 中的 count 函數， n 傳入的實參爲 0 ，得到的結果是： "+count(0).ToString()," 挑戰杯 ");
MessageBox.Show(" 用 DllImport 調用 DLL 中的 count 函數， n 傳入的實參爲 10 ，得到的結果是： "+count(10).ToString()+"n 結果可不是想要的 11 哦！！！ "," 挑戰杯 ");
MessageBox.Show(" 所得結果表明： n 用 DllImport 調用 DLL 中的非託管 n 函數是全局的、靜態的函數！！！ "," 挑戰杯 ");
5)        把Count.dll複製到項目“Tzb”的binDebug文件夾中，按“F5”運行該程序，並點擊按鈕B2，便彈出如下三個提示框：

  
第1個提示框顯示的是調用“count(0)”的結果，第2個提示框顯示的是調用“count(10)”的結果，由所得結果可以證明“用DllImport調用DLL中的非託管函數是全局的、靜態的函數”。所以，有時候並不能達到我們目的，因此我們需要使用下面所介紹的方法：C#動態調用DLL中的函數。
  
3.        C#動態調用DLL中的函數
因爲C#中使用DllImport是不能像動態load/unload assembly那樣，所以只能藉助API函數了。在kernel32.dll中，與動態庫調用有關的函數包括[3]：
①LoadLibrary（或MFC 的AfxLoadLibrary），裝載動態庫。
②GetProcAddress，獲取要引入的函數，將符號名或標識號轉換爲DLL內部地址。
③FreeLibrary（或MFC的AfxFreeLibrary），釋放動態鏈接庫。
它們的原型分別是：
HMODULE LoadLibrary(LPCTSTR lpFileName);
FARPROC GetProcAddress(HMODULE hModule, LPCWSTR lpProcName);
BOOL FreeLibrary(HMODULE hModule);
現在，我們可以用IntPtr hModule=LoadLibrary(“Count.dll”);來獲得Dll的句柄,用IntPtr farProc=GetProcAddress(hModule,”_count@4”);來獲得函數的入口地址。
但是，知道函數的入口地址後，怎樣調用這個函數呢？因爲在C#中是沒有函數指針的，沒有像C++那樣的函數指針調用方式來調用函數，所以我們得藉助其它方法。經過研究，發現我們可以通過結合使用System.Reflection.Emit及System.Reflection.Assembly裏的類和函數達到我們的目的。爲了以後使用方便及實現代碼的複用，我們可以編寫一個類。
1)        dld類的編寫：
1.       打開項目“Tzb”，打開類視圖，右擊“Tzb”，選擇“添加”-->“類”，類名設置爲“dld”，即dynamic loading dll 的每個單詞的開頭字母。
2.       添加所需的命名空間及聲明參數傳遞方式枚舉：
using System.Runtime.InteropServices; // 用 DllImport 需用此 命名空間
using System.Reflection; // 使用 Assembly 類需用此 命名空間
using System.Reflection.Emit; // 使用 ILGenerator 需用此 命名空間

          在“public class dld”上面添加如下代碼聲明參數傳遞方式枚舉：
/// <summary>
/// 參數傳遞方式枚舉 ,ByValue 表示值傳遞 ,ByRef 表示址傳遞
/// </summary>
public enum ModePass
{
ByValue = 0x0001,
ByRef = 0x0002
}
3.       聲明LoadLibrary、GetProcAddress、FreeLibrary及私有變量hModule和farProc：
/// <summary>
/// 原型是 :HMODULE LoadLibrary(LPCTSTR lpFileName);
/// </summary>
/// <param name="lpFileName">DLL 文件名 </param>
/// <returns> 函數庫模塊的句柄 </returns>
[DllImport("kernel32.dll")]
static extern IntPtr LoadLibrary(string lpFileName);
/// <summary>
/// 原型是 : FARPROC GetProcAddress(HMODULE hModule, LPCWSTR lpProcName);
/// </summary>
/// <param name="hModule"> 包含需調用函數的函數庫模塊的句柄 </param>
/// <param name="lpProcName"> 調用函數的名稱 </param>
/// <returns> 函數指針 </returns>
[DllImport("kernel32.dll")]
static extern IntPtr GetProcAddress(IntPtr hModule, string lpProcName);
/// <summary>
/// 原型是 : BOOL FreeLibrary(HMODULE hModule);
/// </summary>
/// <param name="hModule"> 需釋放的函數庫模塊的句柄 </param>
/// <returns> 是否已釋放指定的 Dll</returns>
[DllImport("kernel32",EntryPoint="FreeLibrary",SetLastError=true)]
static extern bool FreeLibrary(IntPtr hModule);
/// <summary>
/// Loadlibrary 返回的函數庫模塊的句柄
/// </summary>
private IntPtr hModule=IntPtr.Zero;
/// <summary>
/// GetProcAddress 返回的函數指針
/// </summary>
private IntPtr farProc=IntPtr.Zero;
4.       添加LoadDll方法，併爲了調用時方便，重載了這個方法：

/// <summary>
/// 裝載 Dll
/// </summary>
/// <param name="lpFileName">DLL 文件名 </param>
public void LoadDll(string lpFileName)
{
hModule=LoadLibrary(lpFileName);
if(hModule==IntPtr.Zero)
throw(new Exception(" 沒有找到 :"+lpFileName+"." ));
}
          若已有已裝載Dll的句柄，可以使用LoadDll方法的第二個版本：
public void LoadDll(IntPtr HMODULE)
{
if(HMODULE==IntPtr.Zero)
throw(new Exception(" 所傳入的函數庫模塊的句柄 HMODULE 爲空 ." ));
hModule=HMODULE;
}
5.       添加LoadFun方法，併爲了調用時方便，也重載了這個方法，方法的具體代碼及註釋如下：
/// <summary>
/// 獲得函數指針
/// </summary>
/// <param name="lpProcName"> 調用函數的名稱 </param>
public void LoadFun(string lpProcName)
{ // 若函數庫模塊的句柄爲空，則拋出異常
if(hModule==IntPtr.Zero)
throw(new Exception(" 函數庫模塊的句柄爲空 , 請確保已進行 LoadDll 操作 !"));
// 取得函數指針
farProc = GetProcAddress(hModule,lpProcName);
// 若函數指針，則拋出異常
if(farProc==IntPtr.Zero)
throw(new Exception(" 沒有找到 :"+lpProcName+" 這個函數的入口點 "));
}
/// <summary>
/// 獲得函數指針
/// </summary>
/// <param name="lpFileName"> 包含需調用函數的 DLL 文件名 </param>
/// <param name="lpProcName"> 調用函數的名稱 </param>
public void LoadFun(string lpFileName,string lpProcName)
{ // 取得函數庫模塊的句柄
hModule=LoadLibrary(lpFileName);
// 若函數庫模塊的句柄爲空，則拋出異常
if(hModule==IntPtr.Zero)
throw(new Exception(" 沒有找到 :"+lpFileName+"." ));
// 取得函數指針
farProc = GetProcAddress(hModule,lpProcName);
// 若函數指針，則拋出異常
if(farProc==IntPtr.Zero)
throw(new Exception(" 沒有找到 :"+lpProcName+" 這個函數的入口點 "));
}
6.       添加UnLoadDll及Invoke方法，Invoke方法也進行了重載：
/// <summary>
/// 卸載 Dll
/// </summary>
public void UnLoadDll()
{
FreeLibrary(hModule);
hModule=IntPtr.Zero;
farProc=IntPtr.Zero;
}

 

 

asp.NET 如何生成DLL文件，並調用

發表日期：2009-12-3

新浪微博QQ空間QQ微博百度搜藏騰訊朋友QQ收藏百度空間人人網開心網

 

使用csc命令將.cs文件編譯成.dll的過程

很多時候,我們需要將.cs文件單獨編譯成.dll文件, 操作如下:

打開命令窗口->輸入cmd到控制檯->cd C:\WINDOWS\Microsoft.NET\Framework\v1.1.4322

轉到vs.net安裝的該目錄下->執行csc命令csc /target:library File.cs->在該目錄下產生一個對應名字的.dll文件(前提:把.cs文件放到C:\WINDOWS\Microsoft.NET\Framework\v1.1.4322目錄下)

csc命令的方式很多,請參考以下

譯 File.cs 以產生 File.exe

csc File.cs 編譯 File.cs 以產生 File.dll

csc /target:library File.cs 編譯 File.cs 並創建 My.exe

csc /out:My.exe File.cs 通過使用優化和定義 DEBUG 符號，編譯當前目錄中所有的 C# 文件。輸出爲 File2.exe

csc /define:DEBUG /optimize /out:File2.exe *.cs 編譯當前目錄中所有的 C# 文件，以產生 File2.dll 的調試版本。不顯示任何徽標和警告

csc /target:library /out:File2.dll /warn:0 /nologo /debug *.cs 將當前目錄中所有的 C# 文件編譯爲 Something.xyz（一個 DLL）

csc /target:library /out:Something.xyz *.cs 編譯 File.cs 以產生 File.dll

csc /target:library File.cs這個就是我們使用最多的一個命令，其實可以簡單的寫成csc /t:library File.cs，另外的一個寫法是 csc /out:mycodebehind.dll /t:library mycodebehind.cs，這個可以自己指定輸出的文件名。

csc /out:mycodebehind.dll /t:library mycodebehind.cs mycodebehind2.cs，這個的作用是把兩個cs文件裝到一個.dll文件裏

舉例(摘於網絡)

一、 動態鏈接庫

        什麼是動態鏈接庫？DLL三個字母對於你來說一定很熟悉吧，它是Dynamic Link Library 的縮寫形式，動態鏈接庫 (DLL) 是作爲共享函數庫的可執行文件。動態鏈接提供了一種方法，使進程可以調用不屬於其可執行代碼的函數。函數的可執行代碼位於一個 DLL 中，該 DLL 包含一個或多個已被編譯、鏈接並與使用它們的進程分開存儲的函數。DLL 還有助於共享數據和資源。多個應用程序可同時訪問內存中單個 DLL 副本的內容。

　　和大多數程序員一樣，你一定很使用過DLL吧。也曾感受到它的帶給你程序設計和編碼上的好錯吧今天我想和大家探討一個主題：如何在C#創建和調用DLL(動態鏈接庫), 其實在很大意義上而講，DLL讓我更靈活的組織編寫我們的應用程序，作爲軟件設計者，可一個根據它來達到很高的代碼重用效果。下面我來介紹一下在C#中如何創建和調用DLL。

二、準備工作

　　我們需要對我們接下來要做的事情做個簡單的介紹，在本文我們將利用C#語言創建一個名爲 MyDLL.DLL的動態鏈接庫，在這個動態鏈接庫文件中我們將提供兩個功能一個是對兩個參數交換他們的值，另一個功能是求兩個參數的最大公約數。然後創建一個應用程序使用這個DLL。運行並輸出結果。

三、創建DLL

讓我們創建以下三個C#代碼文件：

1、 MySwap.cs



}

using System;

namespace MyMethods

{

     public class SwapClass

     {

          public static bool Swap(ref long i,ref long j)

          {

               i = i+j;

               j = i-j;

               i = i-j;

               return true;

           }

       }

}

2、MyMaxCD.cs

using System;

namespace MyMethods

{

     public class MaxCDClass

     {

          public static long MaxCD(long i, long j)

          {

               long a,b,temp;

               if(i>j)

               {

                    a = i;

                    b = j;

               }

               else

               {

                    b = i;

                    a = j;

               }

               temp = a % b;

               while(temp!=0)

               {

                    a = b;

                    b = temp;

                    temp = a % b;

               }

               return b;

            }

       }

}

　需要注意的是：我們在製作這兩個文件的時候可以用Visual Studio.NET或者其他的文本編輯器，就算是記事本也可以。這兩個文件雖然不在同一個文件裏面，但是他們是屬於同一個namespace（名稱空間）這對以後我們使用這兩個方法提供了方便。當然他們也可以屬於不同的名稱空間，這是完全可以的，但只是在我們應用他們的時候就需要引用兩個不同的名稱空間，所以作者建議還是寫在一個名稱空間下面比較好。

　　接下來的任務是把這兩個cs文件變成我們需要的DLL文件。方法是這樣的：在安裝了Microsoft.NET Framework的操作系統上，我們可以在Windows所在目錄下找到Microsoft.NET目錄。在這個目錄下面提供了C#的編譯器，CSC.EXE運行：csc /target:library /out:MyDLL.DLL MySwap.cs MyMaxCD.cs，完成後可在本目錄下面找到我們剛纔生成的MyDLL.DLL文件/target:library 編譯器選項通知編譯器輸出 DLL 文件而不是 EXE 文件。後跟文件名的 /out 編譯器選項用於指定 DLL 文件名。如果/out後面不跟文件名編譯器使用第一個文件 (MySwap.cs) 作爲 DLL 文件名。生成的文件爲MySwap.DLL文件。

　　OK!我們創建動態鏈接庫文件的任務完成了，現在是我們享受勞動成果的時候了，下面我將介紹如何使用我們所創建的動態鏈接庫文件。   四、使用DLL   我們簡單寫一個小程序來測試一下我們剛纔寫的兩個方法是否正確，好吧，跟我來：

MyClient.cs

using System;

using MyMethods; //這裏我們引用剛纔定義的名稱空間，如果剛纔的兩個文件我們寫在兩個不同的名稱空間

class MyClient

{

     public static void Main(string[] args)

     {

         if (args.Length != 2)

         {

              Console.WriteLine("Usage: MyClient <num1> <num2>");

              return;

         }

          long num1 = long.Parse(args[0]);

          long num2 = long.Parse(args[1]);

          SwapClass.Swap(ref num1,ref num2);

　　 // 請注意，文件開頭的 using 指令使您得以在編譯時使用未限定的類名來引用 DLL 方法

          Console.WriteLine("The result of swap is num1 = {0} and num2 ={1}",num1, num2);

          long maxcd = MaxCDClass.MaxCD(num1,num2);

          Console.WriteLine("The MaxCD of {0} and {1} is {2}",num1, num2, maxcd);

     }

}

若要生成可執行文件 MyClient.exe，請使用以下命令行：

csc /out:MyClient.exe /reference:MyDLL.DLL MyClient.cs

/out 編譯器選項通知編譯器輸出 EXE 文件並且指定輸出文件名 (MyClient.exe)。/reference 編譯器選項指定該程序所引用的 DLL 文件。

五、執行

若要運行程序，請輸入 EXE 文件的名稱，文件名的後面跟兩個數字，例如：MyClient 123 456

六、輸出

The result of swap is num1 = 456 and num2 = 123

The MaxCD of 456 and 123 is 3

七、小結

動態鏈接具有下列優點：

　　１、節省內存和減少交換操作。很多進程可以同時使用一個 DLL，在內存中共享該 DLL 的一個副本。相反，對於每個用靜態鏈接庫生成的應用程序，Windows 必須在內存中加載庫代碼的一個副本。

　　２、節省磁盤空間。許多應用程序可在磁盤上共享 DLL 的一個副本。相反，每個用靜態鏈接庫生成的應用程序均具有作爲單獨的副本鏈接到其可執行圖像中的庫代碼。 　　　　３、升級到 DLL 更爲容易。DLL 中的函數更改時，只要函數的參數和返回值沒有更改，就不需重新編譯或重新鏈接使用它們的應用程序。相反，靜態鏈接的對象代碼要求在函數更改時重新鏈接應用程序。

　　４、提供售後支持。例如，可修改顯示器驅動程序 DLL 以支持當初交付應用程序時不可用的顯示器。

　　５、支持多語言程序。只要程序遵循函數的調用約定，用不同編程語言編寫的程序就可以調用相同的 DLL 函數。程序與 DLL 函數在下列方面必須是兼容的：函數期望其參數被推送到堆棧上的順序，是函數還是應用程序負責清理堆棧，以及寄存器中是否傳遞了任何參數。

　　６、提供了擴展 MFC 庫類的機制。可以從現有 MFC 類派生類，並將它們放到 MFC 擴展 DLL 中供 MFC 應用程序使用。

　　７、使國際版本的創建輕鬆完成。通過將資源放到 DLL 中，創建應用程序的國際版本變得容易得多。可將用於應用程序的每個語言版本的字符串放到單獨的 DLL 資源文件中，並使不同的語言版本加載合適的資源。

　　使用 DLL 的一個潛在缺點是應用程序不是獨立的；它取決於是否存在單獨的 DLL 模塊。