Clipboard.SetFileDropList(StringCollection) Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Löscht die Zwischenablage und fügt dann im FileDrop-Format eine Auflistung von Dateinamen 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

Eine StringCollection, die die Dateinamen enthält.

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.

ArgumentNullException

filePaths ist null.

ArgumentException

filePaths enthält keine Zeichenfolgen.

- oder -

Mindestens eine der Zeichenfolgen in filePaths ist Empty, enthält nur Leerraum, enthält ein oder mehrere ungültige Zeichen wie in InvalidPathChars definiert, ist null, enthält einen Doppelpunkt (:) oder überschreitet die systemdefinierte maximale Länge.

Weitere Informationen finden Sie unter der InnerException-Eigenschaft der ArgumentException.

Beispiele

Im folgenden Beispiel wird dieser Member 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 in ein String Array konvertiertfilePaths, bevor sie der Zwischenablage hinzugefügt wird.

Um eine Dateiablageliste aus der Zwischenablage abzurufen, verwenden Sie zunächst die ContainsFileDropList -Methode, um zu bestimmen, ob die Zwischenablage Daten in diesem Format enthält, bevor Sie sie mit der GetFileDropList -Methode abrufen.

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:

Weitere Informationen