Clipboard.SetFileDropList(StringCollection) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> unitPublic Shared Sub SetFileDropList (filePaths As StringCollection)Parametry
- filePaths
- StringCollection
Element StringCollection zawierający nazwy plików.
Wyjątki
Nie można wyczyścić Schowka. Zwykle występuje to, gdy Schowek jest używany przez inny proces.
Bieżący wątek nie jest w trybie jednowątkowy (STA). Dodaj element STAThreadAttribute do metody aplikacji Main .
Parametr filePaths ma wartość null.
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 tylko jeden lub więcej nieprawidłowych znaków zdefiniowanych przez InvalidPathCharselement , 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 .
Note
Klasę Clipboard można używać tylko w wątkach ustawionych na tryb jednowątkowy (STA). Aby użyć tej klasy, upewnij się, że metoda Main jest oznaczona atrybutem STAThreadAttribute.
