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) 。

    • 部分信任應用程式可以從部分信任應用程式貼上可延伸應用程式標記語言 (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 資料會指定為字串。

適用於

另請參閱