Clipboard.GetFileDropList Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

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

StringCollection

Eine StringCollection mit Dateinamen oder null, wenn die Zwischenablage keine Daten im FileDrop-Format oder Daten enthält, die in dieses Format konvertiert werden können.

Ausnahmen

ExternalException

Die Zwischenablage konnte nicht gelöscht werden. Dies tritt i. d. R. auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.

ThreadStateException

Der aktuelle Thread befindet sich nicht im STA-Modus (Singlethread-Apartment). Fügen Sie der Main-Methode der Anwendung das STAThreadAttribute 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 enthält.

Eine Dateiablageliste wird in der Zwischenablage als String Array gespeichert. Diese Methode konvertiert dieses Array in ein StringCollection und gibt die Auflistung zurück.

Verwenden Sie die ContainsFileDropList -Methode, um zu ermitteln, 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.

Hinweis

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 Ihre Main-Methode mit dem STAThreadAttribute-Attribut gekennzeichnet ist.

Gilt für: