Clipboard.GetFileDropList Methode

Definition

Ruft eine Auflistung von Dateinamen aus der Zwischenablage ab.

public:
 static System::Collections::Specialized::StringCollection ^ GetFileDropList();
public static System.Collections.Specialized.StringCollection GetFileDropList();
static member GetFileDropList : unit -> System.Collections.Specialized.StringCollection
Public Shared Function GetFileDropList () As StringCollection

Gibt zurück

A StringCollection containing file names or null if the Clipboard does not contain any data that is in the FileDrop format or can be converted to that format.

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.

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 konvertiert dieses Array in eine StringCollection und gibt die Auflistung zurück.

Verwenden Sie die ContainsFileDropList Methode, um zu bestimmen, ob die Zwischenablage eine Dateiablageliste enthält, bevor Sie sie mit dieser Methode abrufen.

Verwenden Sie die SetFileDropList Methode, um der Zwischenablage eine Dateiablageliste hinzuzufügen.

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