ClipboardProxy 类

定义

命名空间:

Microsoft.VisualBasic.MyServices

程序集:

Microsoft.VisualBasic.Forms.dll

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

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 应用程序都共享系统剪贴板，因此当你切换到另一个应用程序时，内容可能会更改。

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

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

有关详细信息，请参阅将数据存储到剪贴板以及从剪贴板读取数据。

可用性（按项目类型）

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

方法

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)	将自定义格式的数据写入剪贴板。
SetDataObject(DataObject)	将 DataObject 写入剪贴板。
SetFileDropList(StringCollection)	将表示文件路径的字符串的集合写入剪贴板。
SetImage(Image)	将图像写入剪贴板。
SetText(String)	将文本写入剪贴板。
SetText(String, TextDataFormat)	将文本写入剪贴板。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• Computer
• Clipboard
• 对象 (Visual Basic)