Clipboard 类

  • 参考

定义

命名空间:
System.Windows
程序集:
PresentationCore.dll

提供便于将数据传入和传出系统剪贴板的静态方法。

public ref class Clipboard abstract sealed
public static class Clipboard
type Clipboard = class
Public Class Clipboard
继承
Object
Clipboard

示例

以下示例演示如何将数据添加到系统剪贴板。


// For this example, the data to be placed on the clipboard is a simple
// string.
string textData = "I want to put this string on the clipboard.";

// After this call, the data (string) is placed on the clipboard and tagged
// with a data format of "Text".
Clipboard.SetData(DataFormats.Text, (Object)textData);

' For this example, the data to be placed on the clipboard is a simple
' string.
Dim textData As String = "I want to put this string on the clipboard."

' After this call, the data (string) is placed on the clipboard and tagged
' with a data format of "Text".
Clipboard.SetData(DataFormats.Text, CType(textData, Object))

注解

Windows 的所有应用程序都共享系统剪贴板，因此当你切换到另一个应用程序时，内容可能会发生更改。

有关可用于 Clipboard 类的预定义格式列表，请参阅 DataFormats 类。

安全警报： 出于安全考虑，应记住以下几点。

  • 粘贴操作需要用户 (Ctrl-V、粘贴菜单) 启动。

  • 复制只能在用户选择的内容上。

  • 复制或剪切时，部分信任代码将纯文本和可扩展应用程序标记语言 (XAML) 放入剪贴板。 纯文本包括文本、Unicode 文本、OEM (对象交换模型) 文本以及 CSV (逗号分隔值) 。

  • 粘贴时，Windows Presentation Foundation (WPF) 将粘贴到可扩展应用程序标记语言 (XAML) 前提是该内容的源来自同样受信任的站点或更受信任的站点。 尤其是在下列情况下：

    • 部分信任应用程序可以从完全信任应用程序粘贴可扩展应用程序标记语言 (XAML) 。

    • 部分信任应用程序可以从部分信任应用程序粘贴可扩展应用程序标记语言 (XAML) 。

    • 完全信任应用程序只能从另一个完全信任的应用程序粘贴 XAML。

    • 非Windows Presentation Foundation (WPF) 完全信任应用程序可以检查剪贴板上的 ApplicationTrust 格式，并根据需要清理 XAML。

方法

Clear()

从系统剪贴板中清除任何数据。
ContainsAudio()

查询剪贴板上是否存在 WaveAudio 数据格式的数据。
ContainsData(String)

查询剪贴板上是否存在指定数据格式的数据。
ContainsFileDropList()

查询剪贴板上是否存在 FileDrop 数据格式的数据。
ContainsImage()

查询剪贴板上是否存在 Bitmap 数据格式的数据。
ContainsText()

查询剪贴板上是否存在 UnicodeText 格式的数据。
ContainsText(TextDataFormat)

查询剪贴板上是否存在文本数据格式的数据。
Flush()

永久地添加 Clipboard 上的数据，使其在数据的原始应用程序关闭后可用。
GetAudioStream()

返回 WaveAudio 数据格式的剪贴板数据流。
GetData(String)

从剪贴板检索指定格式的数据。
GetDataObject()

返回表示剪贴板全部内容的数据对象。
GetFileDropList()

返回一个字符串集合，其中包含剪贴板上提供的拖放文件的列表。
GetImage()

从剪贴板返回一个 BitmapSource 对象，其中包含 Bitmap 格式的数据。
GetText()

返回一个包含剪贴板上 UnicodeText 数据的字符串。
GetText(TextDataFormat)

返回一个包含剪贴板上文本数据的字符串。
IsCurrent(IDataObject)

比较指定的数据对象与剪贴板的内容。
SetAudio(Byte[])

将音频数据（WaveAudio 数据格式）存储在剪贴板上。 音频数据指定为字节数组。
SetAudio(Stream)

将音频数据（WaveAudio 数据格式）存储在剪贴板上。 音频数据指定为流。
SetData(String, Object)

以指定格式在剪贴板上存储指定数据。
SetDataObject(Object)

将指定的非永久性数据对象放置在系统剪贴板上。
SetDataObject(Object, Boolean)

将指定的数据对象置于系统剪贴板中，并接受一个布尔参数，该参数指示应用程序退出时是否将数据对象保留在剪贴板中。
SetFileDropList(StringCollection)

将 FileDrop 数据存储在剪贴板上。 拖放文件列表指定为字符串集合。
SetImage(BitmapSource)

将 Bitmap 数据存储在剪贴板上。 图像数据指定为 BitmapSource。
SetText(String)

将 UnicodeText 数据存储在剪贴板上。
SetText(String, TextDataFormat)

以指定的文本数据格式在剪贴板上存储文本数据。 将要存储的 UnicodeText 数据指定为一个字符串。

适用于

另请参阅