Clipboard.SetFileDropList(StringCollection) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löscht die Zwischenablage und fügt dann eine Auflistung von Dateinamen im FileDrop Format hinzu.
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
A StringCollection mit den Dateinamen.
Ausnahmen
Die Zwischenablage konnte nicht gelöscht werden. Dies tritt in der Regel auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.
Der aktuelle Thread befindet sich nicht im Sta-Modus (Single Threaded Apartment). Fügen Sie die STAThreadAttribute Methode Ihrer Anwendung Main hinzu.
filePaths ist null.
filePaths enthält keine Zeichenfolgen.
-oder-
Mindestens eine der Zeichenfolgen filePaths enthält Emptynur Leerzeichen, enthält ein oder mehrere ungültige Zeichen, wie durch InvalidPathChars, ist , enthält nulleinen Doppelpunkt (:) oder überschreitet die vom System definierte maximale Länge.
Weitere Informationen finden Sie in der InnerException Eigenschaft der ArgumentException
Beispiele
Im folgenden Beispiel wird dieses Element veranschaulicht.
// 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
Hinweise
Eine Dateiablageliste ist eine Sammlung von Zeichenfolgen, die Pfadinformationen für Dateien enthalten.
Eine Dateiablageliste wird in der Zwischenablage als String Array gespeichert. Diese Methode wird vor dem Hinzufügen in die Zwischenablage in ein filePaths Array konvertiertString.
Um eine Dateiablageliste aus der Zwischenablage abzurufen, verwenden Sie zuerst die ContainsFileDropList Methode, um zu bestimmen, ob die Zwischenablage Daten in diesem Format enthält, bevor Sie sie mit der GetFileDropList Methode abrufen.
Note
Die Clipboard-Klasse kann nur in Threads verwendet werden, die auf den STA-Modus (Single Thread Apartment) festgelegt sind. Um diese Klasse zu verwenden, stellen Sie sicher, dass die Main-Methode mit dem STAThreadAttribute-Attribut markiert ist.