Clipboard.SetData(String, Object) Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

Clipboard.cs

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 dapat 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

data adalah 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 gunakan ContainsData metode untuk menentukan apakah Clipboard berisi data dalam format tersebut GetData sebelum mengambilnya dengan metode .

Note

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

Lihat juga

• DataFormats
• ContainsData(String)
• GetData(String)