Bagikan melalui

Clipboard.SetData(String, Object) Metode

  • Referensi

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

Menghapus Clipboard lalu menambahkan data dalam format yang ditentukan.

public:
 static void SetData(System::String ^ format, System::Object ^ data);
public static void SetData (string format, object data);
static member SetData : string * obj -> unit
Public Shared Sub SetData (format As String, data As Object)

Parameter

format
String

Format data yang akan diatur. Lihat DataFormats untuk format yang telah ditentukan sebelumnya.

data
Object

mewakili Object data yang akan ditambahkan.

Pengecualian

ExternalException

Papan klip tidak bisa dibersihkan. Ini biasanya terjadi ketika Clipboard sedang digunakan oleh proses lain.

ThreadStateException

Utas saat ini tidak dalam mode apartemen berulir tunggal (STA). Tambahkan ke STAThreadAttribute metode aplikasi Main Anda.

ArgumentNullException

dataadalah null.

Contoh

Contoh berikut menunjukkan anggota ini.

// Demonstrates SetData, ContainsData, and GetData.
public Object SwapClipboardFormattedData(String format, Object data)
{
    Object returnObject = null;
    if (Clipboard.ContainsData(format))
    {
        returnObject = Clipboard.GetData(format);
        Clipboard.SetData(format, data);
    }
    return returnObject;
}

' Demonstrates SetData, ContainsData, and GetData.
Public Function SwapClipboardFormattedData( _
    ByVal format As String, ByVal data As Object) As Object

    Dim returnObject As Object = Nothing

    If (Clipboard.ContainsData(format)) Then
        returnObject = Clipboard.GetData(format)
        Clipboard.SetData(format, data)
    End If

    Return returnObject

End Function

Keterangan

Jika Anda tidak tahu format aplikasi target, Anda dapat menyimpan data dalam beberapa format menggunakan metode ini.

Data yang disimpan menggunakan metode ini dapat dikonversi ke format yang kompatibel saat diambil.

Untuk mengambil data dari Clipboard dalam format tertentu, pertama-tama ContainsData gunakan metode untuk menentukan apakah Clipboard berisi data dalam format tersebut sebelum mengambilnya dengan GetData metode .

Catatan

Kelas Clipboard hanya dapat digunakan dalam utas yang diatur ke mode apartemen rangkaian tunggal (STA). Untuk menggunakan kelas ini, pastikan metode Anda Main ditandai dengan STAThreadAttribute atribut .

Berlaku untuk

Lihat juga