Bahasa

Clipboard.ContainsData(String) Metode

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll
Sumber:
Clipboard.cs
Sumber:
Clipboard.cs
Sumber:
Clipboard.cs
Sumber:
Clipboard.cs
Sumber:
Clipboard.cs

Menunjukkan apakah ada data di Clipboard yang dalam format yang ditentukan atau dapat dikonversi ke format tersebut.

public:
 static bool ContainsData(System::String ^ format);
public static bool ContainsData(string format);
public static bool ContainsData(string? format);
static member ContainsData : string -> bool
Public Shared Function ContainsData (format As String) As Boolean

Parameter

format
String

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

Mengembalikan

Boolean

true jika ada data di Clipboard yang ada dalam format yang ditentukan format atau dapat dikonversi ke format tersebut; jika tidak, false.

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.

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

Kelas DataFormats berisi nama format yang telah ditentukan sebelumnya yang dapat Anda gunakan dengan metode ini.

Gunakan metode ini untuk menentukan apakah Clipboard berisi data dalam format yang ditentukan atau format yang kompatibel sebelum mengambilnya dengan GetData metode .

Note

Data dapat dikonversi ke format lain jika disimpan yang menentukan bahwa konversi diizinkan, dan jika format yang diminta kompatibel dengan format tersimpan. Misalnya, data yang disimpan sebagai Unicode dapat dikonversi ke teks.

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.

Berlaku untuk

Lihat juga