C# 使用Dll的几种方法举例

使用 DLL（动态链接库）是 C# 开发中常见的任务之一。DLL 文件包含可以在运行时加载的代码和数据，允许程序共享功能和资源，降低程序的内存占用并促进代码的复用。本篇文章将深入探讨 C# 中使用 DLL 的多种方法，并提供相关代码示例。

1. 什么是 DLL

动态链接库（DLL）是一种包含可供多个程序同时使用的代码和数据的文件。它是在程序运行期间按需被加载进内存的，这意味着它们可以被动态链接和动态调用。这种机制不仅节约了内存，还促进了代码的复用和版本控制。

2. 在 C# 中使用 DLL 的动机

使用 DLL 的动机主要包括以下几个方面：

• 代码复用：将通用功能封装成 DLL 供多个项目使用。
• 减少应用程序大小：通过引用共享的库，而不是将所有代码包含在每个应用程序中。
• 模块化开发：使复杂的软件系统更易于管理和维护。
• 跨语言调用：从非托管代码（如 C/C++）中调用函数。

3. 通过 Visual Studio 引用 DLL

在 Visual Studio 中引用 DLL 是使用托管程序集最简单的方法。

创建和引用 DLL

1. 创建 DLL 项目：

   • 打开 Visual Studio，创建一个新的 C# 类库项目。

   • 编写你的功能代码，如以下简单的数学库：

     namespace MathLibrary
     {
         public class Calculator
         {
             public int Add(int a, int b)
             {
                 return a + b;
             }
     
             public int Subtract(int a, int b)
             {
                 return a - b;
             }
         }
     }
     

2. 编译并生成 DLL。在解决方案资源管理器中，右键单击项目并选择“生成”选项。

3. 在其他项目中引用该 DLL：

   • 在需要使用该 DLL 的项目中右键点击“引用”，选择“添加引用”。
   • 在“浏览”选项卡下找到生成的 DLL 文件并添加。

4. 使用 DLL 中的类：

   using MathLibrary;
   
   class Program
   {
       static void Main()
       {
           Calculator calc = new Calculator();
           Console.WriteLine($"Add: {calc.Add(10, 5)}");
           Console.WriteLine($"Subtract: {calc.Subtract(10, 5)}");
       }
   }
   

4. 使用 P/Invoke 调用非托管代码

Platform Invocation Services (P/Invoke) 提供了一种从 C# 调用非托管代码（如 C/C++）的方式。这个功能对于使用操作系统提供的 API 或者遗留的 C/C++ 库特别有用。

示例：调用 Windows API

假设我们需要调用 Windows API 中的 MessageBox 函数。

1. 声明函数：

   using System;
   using System.Runtime.InteropServices;
   
   class Program
   {
       [DllImport("user32.dll", CharSet = CharSet.Unicode)]
       public static extern int MessageBox(IntPtr hWnd, string text, string caption, int options);
   
       static void Main()
       {
           MessageBox(IntPtr.Zero, "Hello, World!", "My Box", 0);
       }
   }
   

2. 关键点解析：

   • 使用 DllImport 属性指示这是一个从非托管 DLL 调用的函数。
   • CharSet 被设置为 Unicode 以处理字符编码。

5. 使用 COM 对象

在 C# 中使用 COM 对象，需要通过运行时可调用包装器（RCW）来实现。Visual Studio 可以自动生成 RCW。

示例：使用 Microsoft Excel COM 对象

1. 添加引用：

   • 在项目中选择“添加引用”，找到“COM”选项卡。
   • 添加“Microsoft Excel 16.0 Object Library”。

2. 使用 Excel COM 对象：

   using Excel = Microsoft.Office.Interop.Excel;
   
   class Program
   {
       static void Main()
       {
           Excel.Application xlApp = new Excel.Application();
           xlApp.Visible = true;
   
           Excel.Workbook workbook = xlApp.Workbooks.Add();
           Excel.Worksheet worksheet = (Excel.Worksheet)workbook.Worksheets[1];
           worksheet.Cells[1, 1] = "Hello, Excel!";
   
           workbook.SaveAs("Sample.xlsx");
           workbook.Close();
           xlApp.Quit();
       }
   }
   

3. 注意事项：

   • 使用完 COM 对象后，要调用 Quit() 方法并释放对象。这可以通过 Marshal.ReleaseComObject 来实现以避免内存泄露。

6. 使用反射加载 DLL

反射提供了在运行时动态加载和使用程序集的能力。这对于需要在程序执行时创建对象或调用方法的场景特别有用。

示例：动态加载 DLL

1. 动态加载和调用方法：

   using System;
   using System.Reflection;
   
   class Program
   {
       static void Main()
       {
           // 加载 DLL
           Assembly assembly = Assembly.LoadFrom("MathLibrary.dll");
   
           // 获取 Calculator 类型
           Type calculatorType = assembly.GetType("MathLibrary.Calculator");
   
           // 创建 Calculator 实例
           object calculatorInstance = Activator.CreateInstance(calculatorType);
   
           // 获取 Add 方法
           MethodInfo addMethod = calculatorType.GetMethod("Add");
   
           // 调用 Add 方法
           object result = addMethod.Invoke(calculatorInstance, new object[] { 10, 5 });
   
           Console.WriteLine($"Result of Add: {result}");
       }
   }
   

2. 反射的优缺点：

   • 优点：灵活，可以在运行时决定加载和调用哪一段代码。
   • 缺点：性能开销较大，且在代码结构发生变化时可能导致运行时错误。

7. 实践示例与代码解析

让我们通过一个实际的项目来整理使用不同方式加载 DLL 的步骤。假设我们要开发一个图像处理程序，其核心功能由一个复杂的 C++ 库实现，而我们希望在 C# 中调用这个库。

C++ DLL 创建

以下是一个简单的 C++ 动态链接库示例，提供了图像转灰度的功能：

// ImageLibrary.cpp
#include "ImageLibrary.h"

extern "C" __declspec(dllexport) void ToGrayscale(unsigned char* image, int width, int height)
{
    for (int i = 0; i < width * height * 3; i += 3)
    {
        unsigned char gray = (unsigned char)(0.299 * image[i] + 0.587 * image[i + 1] + 0.114 * image[i + 2]);
        image[i] = image[i + 1] = image[i + 2] = gray;
    }
}

C# 调用 P/Invoke

在 C# 程序中调用上面的 C++ 函数：

using System;
using System.Drawing;
using System.Drawing.Imaging;
using System.IO;
using System.Runtime.InteropServices;

class Program
{
    [DllImport("ImageLibrary.dll", CallingConvention = CallingConvention.Cdecl)]
    public static extern void ToGrayscale(byte[] image, int width, int height);

    static void Main()
    {
        string inputImagePath = "input.jpg";
        string outputImagePath = "output.jpg";

        Bitmap bitmap = new Bitmap(inputImagePath);
        Rectangle rect = new Rectangle(0, 0, bitmap.Width, bitmap.Height);
        BitmapData bmpData = bitmap.LockBits(rect, ImageLockMode.ReadWrite, bitmap.PixelFormat);

        int bytes = Math.Abs(bmpData.Stride) * bitmap.Height;
        byte[] rgbValues = new byte[bytes];
        IntPtr ptr = bmpData.Scan0;

        Marshal.Copy(ptr, rgbValues, 0, bytes);

        ToGrayscale(rgbValues, bitmap.Width, bitmap.Height);

        Marshal.Copy(rgbValues, 0, ptr, bytes);
        bitmap.UnlockBits(bmpData);
        bitmap.Save(outputImagePath);

        Console.WriteLine("Image converted to grayscale and saved as " + outputImagePath);
    }
}

8. 常见问题与解决方案

• 无法加载 DLL：

  • 确保 DLL 文件位于应用程序的运行目录中。
  • 检查 DLL 的依赖项是否都已正确安装。

• 调用函数失败：

  • 检查 P/Invoke 声明和实际 DLL 函数签名的一致性。
  • 确保数据类型之间的转换是正确的，如 int、string 到非托管类型的映射。

• 内存泄露：

  • 确保所有非托管资源都已正确释放，特别是在处理 COM 对象时。

9. 性能优化与注意事项

• 减少不必要的调用：频繁的 DLL 调用可能会导致性能问题，应尽量批量处理数据。
• 尽量使用托管代码：对于简单功能，优先考虑使用 C# 实现，以避免不必要的复杂性和错误。
• 缓存方法信息：在使用反射时，缓存好需要调用的方法和属性信息，以降低性能开销。

10. 总结

C# 使用 DLL 提供了灵活的代码重用和功能扩展的途径。从直接引用托管程序集，到通过 P/Invoke 调用非托管代码，再到使用 COM 对象和反射加载 DLL，每种方式都有其独特的应用场景和挑战。在实际开发中，选择合适的技术需要综合考虑项目的特性、性能要求和维护成本。通过深入理解这些技术实现的方法和注意事项，可以更好地在 C# 项目中运用 DLL 来实现复杂功能。

print("拥抱新技术才是王道！")

关注我，不迷路，共学习，同进步

关注我，不迷路，共学习，同进步