My.Computer.Clipboard.GetText 方法

更新：2007 年 11 月

从剪贴板检索文本。

' Usage
Dim value As String = My.Computer.Clipboard.GetText()
Dim value As String = My.Computer.Clipboard.GetText(format)
' Declaration
Public Function GetText() As String
' -or-
Public Function GetText( _
   ByVal format As System.Windows.Forms.TextDataFormat _
) As String

参数

• format
  TextDataFormat。如果已指定，则标识应检索哪种文本格式。默认值为 CommaSeparatedValue。必选。

返回值

String.

异常

此方法不引发异常。

备注

可能的格式有 CommaSeparatedValue、Html、Rtf 和 UnicodeText。

该方法需要 AllClipboard。

如果剪贴板上没有与指定格式相匹配的数据，该方法将返回一个空字符串。

任务

下表列出了涉及 My.Computer.Clipboard.GetText 方法的任务的示例。

示例

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

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

如果剪贴板上没有文本，本示例失败。

要求

命名空间：Microsoft.VisualBasic.MyServices

类：ClipboardProxy（提供对 Clipboard 的访问）

**程序集：**Visual Basic 运行库（在 Microsoft.VisualBasic.dll 中）

按项目类型列出的可用性

权限

不需要任何权限。

请参见

任务

如何：在 Visual Basic 中读取剪贴板

参考

My.Computer.Clipboard 对象

System.Windows.Forms.TextDataFormat

Clipboard.GetText

My.Computer.Clipboard.ContainsText 方法

My.Computer.Clipboard.SetText 方法