ClipboardProxy 类

定义

命名空间:

Microsoft.VisualBasic.MyServices

程序集:

Microsoft.VisualBasic.Forms.dll

Source:

ClipboardProxy.vb

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

public ref class ClipboardProxy

public class ClipboardProxy

type ClipboardProxy = class

Public Class ClipboardProxy

继承

Object

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)	确定剪贴板上是否存在文本。
GetAudioStream()	从剪贴板检索音频流。
GetData(String)	已过时. 从剪贴板检索采用自定义格式的数据。
GetDataObject()	以 .. 的形式 IDataObject从剪贴板检索数据。
GetFileDropList()	从剪贴板检索表示文件名的字符串集合。
GetImage()	从剪贴板检索图像。
GetText()	从剪贴板检索文本。
GetText(TextDataFormat)	从剪贴板检索文本。
SetAudio(Byte[])	将音频数据写入剪贴板。
SetAudio(Stream)	将音频数据写入剪贴板。
SetData(String, Object)	将数据以自定义格式写入剪贴板。
SetDataAsJson<T>(String, T)	提供用于操作剪贴板的方法。
SetDataObject(DataObject)	将 a DataObject 写入剪贴板。
SetFileDropList(StringCollection)	将表示文件路径的字符串集合写入剪贴板。
SetImage(Image)	将图像写入剪贴板。
SetText(String, TextDataFormat)	将文本写入剪贴板。
SetText(String)	将文本写入剪贴板。
TryGetData<T>(String, Func<TypeName,Type>, T)	提供用于操作剪贴板的方法。
TryGetData<T>(String, T)	提供用于操作剪贴板的方法。

另请参阅

• Computer
• Clipboard
• 对象 （Visual Basic）