ClipboardProxy 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供操作剪貼板的方法。
public ref class ClipboardProxypublic class ClipboardProxytype ClipboardProxy = classPublic Class ClipboardProxy- 繼承
-
ClipboardProxy
範例
此範例將夾板的文字讀入字串 textOnClipboard。
Dim textOnClipboard As String = My.Computer.Clipboard.GetText()
如果剪貼簿上沒有文字，這個範例就會失敗。
備註
移動或複製到夾板的項目即使應用程式關閉後仍會持續存在。
剪貼簿上的資料可以是任何資料格式，也稱為剪貼簿格式。 關於可搭配剪貼簿使用的預設格式列表，請參見 DataFormats。 當項目被移動或複製到剪貼簿時，其他格式的項目會被清除。 要讓其他格式持續存在，請使用 DataObject，它會複製目前剪貼簿上所有現有的內容，包括從其他應用程式貼上的項目。 將資料以多種格式放置於剪貼簿上，以最大化目標應用程式（你可能不了解其格式需求）成功取得資料的可能性。
由於所有 Windows 應用程式共用系統剪貼簿，切換到其他應用程式時內容可能會改變。
類別必須具備序列化能力，才能被放入剪貼簿。 欲了解更多資訊，請參閱 Serialization - C#或 Serialization - Visual Basic。
遠端存取剪貼簿時，除非存取執行緒以 STA（單執行緒公寓）模式運作，否則會拋出 a ThreadStateException 。 要解決這個問題，請將 設 ThreadApartmentState 為 STA。 如需詳細資訊，請參閱STAThreadAttribute。
欲了解更多資訊，請參閱 「將資料儲存至剪貼板及從剪貼簿讀取」。
依專案類型提供可用性
| 專案類型 | Available |
|---|---|
| Windows 應用程式 | Yes |
| 類別庫 | Yes |
| 主控台應用程式 | Yes |
| Windows 控件庫 | Yes |
| Web 控制庫 | No |
| Windows 服務 | Yes |
| 網站 | No |
方法
| 名稱 | Description |
|---|---|
| Clear() |
清理夾板。 |
| ContainsAudio() |
顯示剪貼簿是否包含音訊資料。 |
| ContainsData(String) |
顯示剪貼簿是否包含指定的自訂格式資料。 |
| ContainsFileDropList() |
回傳 A |
| ContainsImage() |
回傳 A |
| 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) |
寫 a DataObject 在夾板上。 |
| SetFileDropList(StringCollection) |
將一組字串代表檔案路徑寫入剪貼簿。 |
| SetImage(Image) |
在剪貼簿上寫下一張圖片。 |
| SetText(String, TextDataFormat) |
在剪貼簿上寫文字。 |
| SetText(String) |
在剪貼簿上寫文字。 |
| ToString() |
傳回表示目前 物件的字串。 (繼承來源 Object) |