Clipboard.SetData(String, Object) Metode

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

Bagikan melalui