Clipboard.SetFileDropList(StringCollection) Metoda

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 .

Zobacz też

• FileDrop
• ContainsFileDropList()
• GetFileDropList()