ClipboardProxy 类

定义

提供用于操作剪贴板的方法。

public ref class ClipboardProxy
public class ClipboardProxy
type ClipboardProxy = class
Public Class ClipboardProxy
继承
ClipboardProxy

示例

本示例将剪贴板中的文本读入字符串 textOnClipboard中。

Dim textOnClipboard As String = My.Computer.Clipboard.GetText()

如果剪贴板上没有文本,此示例将失败。

注解

即使在应用程序关闭后,移动或复制到剪贴板的项目也会保留。

剪贴板上的数据可以采用任何数据格式,也称为剪贴板格式。 有关要与剪贴板一起使用的预定义格式的列表,请参阅 DataFormats。 将项移动到剪贴板或复制到剪贴板时,将清除其他格式的项目。 若要保留其他格式,请使用 DataObject,这会复制当前剪贴板上现有的所有内容,包括从其他应用程序粘贴的项目。 以多种格式将数据放置在剪贴板上,以最大程度地提高目标应用程序(你可能不知道的格式要求)可以成功检索数据的可能性。

由于所有Windows应用程序共享系统剪贴板,因此切换到其他应用程序时,内容可能会更改。

类必须可序列化,才能将其放在剪贴板上。 有关详细信息,请参阅 Serialization - C#Serialization - Visual Basic

远程访问剪贴板时,除非访问线程以 STA(单线程单元)模式运行,否则将引发 a ThreadStateException 。 若要解决此问题,请设置为 ThreadApartmentStateSTA. 有关详细信息,请参阅 STAThreadAttribute

有关详细信息,请参阅 将数据存储到剪贴板并从剪贴板读取

按项目类型提供可用性

项目类型 可用的
Windows 应用程序 Yes
类库 Yes
控制台应用程序 Yes
Windows 控件库 Yes
Web 控件库
Windows 服务 Yes
网站

方法

名称 说明
Clear()

清除剪贴板。

ContainsAudio()

指示剪贴板是否包含音频数据。

ContainsData(String)

指示剪贴板是否包含指定自定义格式的数据。

ContainsFileDropList()

返回一个 Boolean 指示剪贴板是否包含文件下拉列表。

ContainsImage()

返回一个 Boolean 指示图像是否存储在剪贴板上。

ContainsText()

确定剪贴板上是否存在文本。

ContainsText(TextDataFormat)

确定剪贴板上是否存在文本。

Equals(Object)

确定指定的对象是否等于当前对象。

(继承自 Object)
GetAudioStream()

从剪贴板检索音频流。

GetData(String)
已过时.

从剪贴板检索采用自定义格式的数据。

GetDataObject()

以 .. 的形式 IDataObject从剪贴板检索数据。

GetFileDropList()

从剪贴板检索表示文件名的字符串集合。

GetHashCode()

用作默认哈希函数。

(继承自 Object)
GetImage()

从剪贴板检索图像。

GetText()

从剪贴板检索文本。

GetText(TextDataFormat)

从剪贴板检索文本。

GetType()

获取当前实例的 Type

(继承自 Object)
MemberwiseClone()

创建当前 Object的浅表副本。

(继承自 Object)
SetAudio(Byte[])

将音频数据写入剪贴板。

SetAudio(Stream)

将音频数据写入剪贴板。

SetData(String, Object)

将数据以自定义格式写入剪贴板。

SetDataAsJson<T>(String, T)

提供用于操作剪贴板的方法。

SetDataObject(DataObject)

将 a DataObject 写入剪贴板。

SetFileDropList(StringCollection)

将表示文件路径的字符串集合写入剪贴板。

SetImage(Image)

将图像写入剪贴板。

SetText(String, TextDataFormat)

将文本写入剪贴板。

SetText(String)

将文本写入剪贴板。

ToString()

返回一个表示当前对象的字符串。

(继承自 Object)
TryGetData<T>(String, Func<TypeName,Type>, T)

提供用于操作剪贴板的方法。

TryGetData<T>(String, T)

提供用于操作剪贴板的方法。

适用于

另请参阅