Clipboard.SetFileDropList(StringCollection) Methode

Definition

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.

Gilt für:

Weitere Informationen