语言

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（对象Exchange模型）文本和 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)

以指定格式将指定数据存储在剪贴板上。
SetDataAsJson<T>(String, T)

提供静态方法，方便将数据传入和传出系统剪贴板。
SetDataObject(Object, Boolean)

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

在系统剪贴板上放置指定的非持久性数据对象。
SetFileDropList(StringCollection)

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

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

以指定的文本数据格式将文本数据存储在剪贴板上。 要 UnicodeText 存储的数据被指定为字符串。
SetText(String)

将数据 UnicodeText 存储在剪贴板上。
TryGetData<T>(String, Func<TypeName,Type>, T)

提供静态方法，方便将数据传入和传出系统剪贴板。
TryGetData<T>(String, T)

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

适用于

另请参阅