ClipboardProxy 類別

定義

命名空間:

Microsoft.VisualBasic.MyServices

組件:

Microsoft.VisualBasic.Forms.dll

提供用於操作剪貼簿的方法。

public ref class ClipboardProxy

public class ClipboardProxy

type ClipboardProxy = class

Public Class ClipboardProxy

繼承

Object

ClipboardProxy

範例

本範例會將剪貼簿中的文字讀入字串 textOnClipboard中。

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

如果剪貼簿上沒有文字，這個範例將會失敗。

備註

即使應用程式關閉之後，移動或複製到剪貼簿的專案仍會保存。

剪貼簿上的數據可以是任何數據格式，也稱為剪貼簿格式。 如需要搭配剪貼簿使用的預先定義格式清單，請參閱 DataFormats。 當專案移動或複製到剪貼簿時，會清除其他格式的專案。 若要保存其他格式，請使用 DataObject，它會複製目前剪貼簿上現有的所有專案，包括從其他應用程式貼上的專案。 將數據放在剪貼簿上以多種格式，以最大化目標應用程式可能不知道其格式需求可以成功擷取數據的可能性。

因為所有 Windows 應用程式都會共享系統剪貼簿，所以當您切換到另一個應用程式時，內容可能會變更。

類別必須可串行化，才能將它放在剪貼簿上。 如需詳細資訊，請參閱 串行化 - C# 或 串行化 - Visual Basic。

從遠端存取剪貼簿時， ThreadStateException 除非存取線程在 STA (單個線程 Apartment) 模式中運作，否則會擲回 。 若要解決此問題，請將 設定 ThreadApartmentState 為 STA。 如需詳細資訊，請參閱STAThreadAttribute。

如需詳細資訊，請參閱將資料儲存至剪貼簿並從剪貼簿讀取。

依專案類型的可用性

專案類型	可用
Windows 應用程式	是
類別庫	是
主控台應用程式	是
Windows 控制項程式庫	是
Web 控制項程式庫	否
Windows 服務	是
網站	否

方法

Clear()	清除 [剪貼簿]。
ContainsAudio()	指出剪貼簿是否包含音效資料。
ContainsData(String)	指出 [剪貼簿] 是否包含指定自訂格式的資料。
ContainsFileDropList()	傳回 Boolean，指出 [剪貼簿] 是否包含檔案下拉清單。
ContainsImage()	傳回 Boolean，指出 [剪貼簿] 上是否儲存了一個影像。
ContainsText()	判斷 [剪貼簿] 中是否有文字。
ContainsText(TextDataFormat)	判斷 [剪貼簿] 中是否有文字。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetAudioStream()	從剪貼簿擷取音效串流。
GetData(String)	從 [剪貼簿] 擷取自訂格式的資料。
GetDataObject()	以 IDataObject 的形式從 [剪貼簿] 擷取資料。
GetFileDropList()	從 [剪貼簿] 擷取表示檔名的字串集合。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetImage()	從剪貼簿擷取影像。
GetText()	從 [剪貼簿] 擷取文字。
GetText(TextDataFormat)	從 [剪貼簿] 擷取文字。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
SetAudio(Byte[])	將音訊資料寫入至 [剪貼簿]。
SetAudio(Stream)	將音訊資料寫入至 [剪貼簿]。
SetData(String, Object)	將自訂格式的資料寫入 [剪貼簿]。
SetDataObject(DataObject)	將 DataObject 寫入 [剪貼簿]。
SetFileDropList(StringCollection)	將表示檔案路徑的字串集合寫入 [剪貼簿]。
SetImage(Image)	將影像寫入 [剪貼簿]。
SetText(String)	將文字寫入至 [剪貼簿]。
SetText(String, TextDataFormat)	將文字寫入至 [剪貼簿]。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• Computer
• Clipboard
• 物件 (Visual Basic)