VB.NET类项目中Clipboard对象无法使用的问题求助

问题核心 #

你碰到的问题本质是类库项目默认不包含WinForms/WPF相关的剪贴板API依赖，且不同.NET框架下的配置逻辑有区别：

• .NET Framework类库：需手动添加WinForms引用，还要处理线程模型限制
• .NET Core/.NET 5+类库：WinForms的剪贴板API需要额外安装NuGet包，或改用WPF的剪贴板API

分框架解决步骤 #

1. .NET Framework 类项目 #

• 右键项目 → 选择添加引用 → 在程序集标签里找到System.Windows.Forms并勾选，点击确定。
• 注意：剪贴板是COM组件，必须在STA线程中调用，类库默认线程是MTA，直接调用会报错，修改代码如下：

Dim clipText As String = String.Empty
Dim staThread As New Thread(Sub()
                                If Clipboard.ContainsText() Then
                                    clipText = Clipboard.GetText()
                                End If
                            End Sub)
staThread.SetApartmentState(ApartmentState.STA)
staThread.Start()
staThread.Join()

2. .NET Core/.NET 5+ 类项目 #

方案一：使用WPF剪贴板API（推荐）

• 右键项目 → 选择添加引用 → 点击浏览，找到并添加PresentationCore.dll和WindowsBase.dll（通常在C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App\[你的框架版本号]路径下）
• 代码示例：

Imports System.Windows

Dim clipText As String = String.Empty
If Clipboard.ContainsText() Then
    clipText = Clipboard.GetText()
End If

同样要确保调用代码处于STA线程中。

方案二：使用WinForms剪贴板API

• 打开NuGet包管理器，搜索并安装System.Windows.Forms包
• 之后就可以用System.Windows.Forms.Clipboard.GetText()调用，但同样需要STA线程环境。

常见错误排查 #

• 不要在非STA线程调用剪贴板API：直接在类库的默认线程调用会抛出线程模型不兼容的异常
• .NET Core/.NET 5+中仅添加引用没用：必须安装对应的NuGet包，框架才会加载相关依赖

内容的提问来源于stack exchange，提问作者Utsab Subedi