讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

AniShort
AniShort

AI短剧协同制作平台

c# 如何操作剪贴板

陌静大大_9215

陌静大大_9215

发布时间:2026-02-27 10:06:10

|

706人浏览过

|

来源于php中文网

原创

Clipboard.SetText 会抛出 ThreadStateException 异常,因其要求调用线程为 STA 模式;控制台程序需加 [STAThread] 特性,WPF/WinForms 需确保在 UI 线程调用;富文本需用 SetData 指定 DataFormats.Html 或 Rtf;读取前应先用 ContainsText() 判断;跨进程操作受权限、延迟和沙盒限制。

c# 如何操作剪贴板

Clipboard.SetText 会抛异常?检查线程模型

在 WinForms 或 WPF 之外的上下文(比如控制台程序、后台线程、ASP.NET 后端)调用 Clipboard.SetText 会直接抛出 System.Threading.ThreadStateException,因为剪贴板 API 要求调用线程必须是 STA(Single-Threaded Apartment)模式。

  • WinForms 主线程默认是 STA,可直接用
  • WPF 主线程也是 STA,但需确保在 UI 线程调用(例如用 Dispatcher.Invoke)
  • 控制台程序默认是 MTA,必须显式标记为 STA:在 Main 方法上加 [STAThread] 特性
[STAThread]
static void Main(string[] args)
{
    Clipboard.SetText("hello");
}

复制富文本或 HTML 内容要用 SetData

Clipboard.SetText 只写入纯文本格式(DataFormats.Text),如果想粘贴到 Word、Outlook 或浏览器中保留样式,得用 Clipboard.SetData 并指定格式。

  • HTML 内容用 DataFormats.Html,注意需包含标准 HTML 包装结构(如 ...)
  • RTF 用 DataFormats.Rtf,内容需是合法 RTF 字符串(以 {\rtf1... 开头)
  • 自定义对象(如 MyDataClass)需实现序列化,并用 typeof(MyDataClass) 作为格式名
string html = @"<html><body><b>Bold</b> and <i>italic</i></body></html>";
Clipboard.SetData(DataFormats.Html, html);

读取剪贴板前先判断格式是否存在

直接调用 Clipboard.GetText() 在剪贴板为空或不含文本时会返回空字符串,但无法区分“真为空”还是“有其他格式(如图片)但无文本”。更安全的做法是先用 Clipboard.ContainsText() 或 Clipboard.ContainsData(...) 检查。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • ContainsText() 等价于 ContainsData(DataFormats.Text)
  • 读取图片用 Clipboard.GetImage(),但该方法在无图像时返回 null,不抛异常
  • 读取自定义格式必须用 Clipboard.GetData(...),并手动转换类型
if (Clipboard.ContainsText())
{
    string text = Clipboard.GetText();
    Console.WriteLine(text);
}

跨进程剪贴板操作要注意权限和延迟

在某些沙盒环境(如 Windows AppContainer 应用、部分企业策略锁定的系统)中,剪贴板访问可能被限制;另外,Clipboard.Clear() 或连续多次 SetXXX 调用后,其他进程可能短暂读不到最新内容——这是 Windows 剪贴板消息队列同步机制导致的,不是 .NET Bug。

  • 避免在循环里高频写剪贴板,每次调用间隔建议 ≥ 50ms
  • 敏感应用(如密码管理器)应主动调用 Clipboard.Clear() 清除残留内容
  • WPF 中若从非 UI 线程读写,必须通过 Application.Current.Dispatcher.Invoke 封装

最常被忽略的是:即使代码没报错,剪贴板内容也可能没真正生效——尤其在远程桌面或虚拟机中,需确认宿主机剪贴板共享已启用且未被策略禁用。

热门AI工具

更多
墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

549

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1698

2024.03.01

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1898

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

3084

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6324

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

6389

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

7934

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

12194

2024.04.29

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn