My.Computer.Clipboard.SetText 方法

更新：2007 年 11 月

将文本写入剪贴板。

' Usage
My.Computer.Clipboard.SetText(text)
My.Computer.Clipboard.SetText(text ,format)
' Declaration
Public Sub SetText( _
   ByVal text As String _
)
' -or-
Public Sub SetText( _
   ByVal text As String, _
   ByVal format As System.Windows.Forms.TextDataFormat _
)

参数

• text
  String。要写入的文本。必选。

• format
  TextDataFormat。写入文本时要使用的格式。默认值为 UnicodeText。必选。

异常

以下情况可能会导致异常：

• text 为空字符串 (ArgumentException)。

• text 为 Nothing (ArgumentNullException)。

备注

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

该方法需要 AllClipboard。

不保留以前的剪贴板格式。

安全说明：
因为其他用户可以访问剪贴板，所以不要使用剪贴板存储敏感信息，例如密码或机密数据。

任务

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

示例

本示例将字符串 This is a test string. 写入剪贴板。

My.Computer.Clipboard.SetText("This is a test string.")

要求

命名空间：Microsoft.VisualBasic.MyServices

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

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

按项目类型列出的可用性

权限

不需要任何权限。

请参见

参考

My.Computer.Clipboard 对象

System.Windows.Forms.TextDataFormat

Clipboard.SetText

My.Computer.Clipboard.ContainsText 方法

My.Computer.Clipboard.GetText 方法

其他资源

将数据存储到剪贴板以及从剪贴板读取数据