Udostępnij za pośrednictwem

Clipboard.SetFileDropList(StringCollection) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Czyści schowek, a następnie dodaje kolekcję nazw plików w FileDrop formacie.

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)

Parametry

filePaths
StringCollection

Element StringCollection zawierający nazwy plików.

Wyjątki

ExternalException

Nie można wyczyścić schowka. Zwykle występuje to, gdy schowek jest używany przez inny proces.

ThreadStateException

Bieżący wątek nie jest w trybie jednowątkowego mieszkania (STA). Dodaj metodę STAThreadAttribute do metody aplikacji Main .

ArgumentNullException

filePaths to null.

ArgumentException

filePaths nie zawiera żadnych ciągów.

-lub-

Co najmniej jeden z ciągów w pliku filePaths to Empty, zawiera tylko białe znaki, zawiera co najmniej jeden nieprawidłowy znak zdefiniowany przez InvalidPathCharsmetodę , to null, zawiera dwukropek (:) lub przekracza maksymalną długość zdefiniowaną przez system.

InnerException Aby uzyskać więcej informacji, zobacz właściwość obiektu ArgumentException .

Przykłady

W poniższym przykładzie pokazano ten element członkowski.

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

Uwagi

Lista upuszczania plików to kolekcja ciągów zawierających informacje o ścieżce dla plików.

Lista upuszczania plików jest przechowywana w Schowku jako tablica String . Ta metoda konwertuje filePaths na tablicę String przed dodaniem jej do Schowka.

Aby pobrać listę rozwijaną pliku ze Schowka, najpierw użyj ContainsFileDropList metody , aby określić, czy Schowek zawiera dane w tym formacie przed pobraniem GetFileDropList go za pomocą metody .

Uwaga

Klasa Clipboard może być używana tylko w wątkach ustawionych na tryb pojedynczego wątku (STA). Aby użyć tej klasy, upewnij się, że Main metoda jest oznaczona atrybutem STAThreadAttribute .

Dotyczy

Zobacz też