Clipboard.SetFileDropList(StringCollection) 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 kumpulan nama file dalam FileDrop format.

public:
 static void SetFileDropList(System::Collections::Specialized::StringCollection ^ filePaths);

public static void SetFileDropList (System.Collections.Specialized.StringCollection filePaths);

static member SetFileDropList : System.Collections.Specialized.StringCollection -> unit

Public Shared Sub SetFileDropList (filePaths As StringCollection)

Parameter

filePaths: StringCollection

yang StringCollection berisi nama file.

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

filePathsadalah null.

ArgumentException

filePaths tidak berisi string apa pun.

-atau-

Setidaknya salah satu string di filePaths adalah Empty, hanya berisi spasi kosong, berisi satu atau beberapa karakter yang tidak valid seperti yang didefinisikan oleh InvalidPathChars, adalah null, berisi titik dua (:), atau melebihi panjang maksimum yang ditentukan sistem.

InnerException Lihat properti untuk ArgumentException informasi selengkapnya.

Contoh

Contoh berikut menunjukkan anggota ini.

// Demonstrates SetFileDropList, ContainsFileDroList, and GetFileDropList
public System.Collections.Specialized.StringCollection
    SwapClipboardFileDropList(
    System.Collections.Specialized.StringCollection replacementList)
{
    System.Collections.Specialized.StringCollection returnList = null;
    if (Clipboard.ContainsFileDropList())
    {
        returnList = Clipboard.GetFileDropList();
        Clipboard.SetFileDropList(replacementList);
    }
    return returnList;
}

' Demonstrates SetFileDropList, ContainsFileDroList, and GetFileDropList
Public Function SwapClipboardFileDropList(ByVal replacementList _
    As System.Collections.Specialized.StringCollection) _
    As System.Collections.Specialized.StringCollection

    Dim returnList As System.Collections.Specialized.StringCollection _
        = Nothing

    If Clipboard.ContainsFileDropList() Then

        returnList = Clipboard.GetFileDropList()
        Clipboard.SetFileDropList(replacementList)
    End If

    Return returnList

End Function

Keterangan

Daftar drop file adalah kumpulan string yang berisi informasi jalur untuk file.

Daftar drop file disimpan di Clipboard sebagai String array. Metode ini mengonversi filePaths ke String array sebelum menambahkannya ke Clipboard.

Untuk mengambil daftar drop file dari Clipboard, pertama-tama gunakan ContainsFileDropList metode untuk menentukan apakah Clipboard berisi data dalam format tersebut GetFileDropList sebelum mengambilnya dengan metode .

Catatan

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

Berlaku untuk

Bagikan melalui