Clipboard.SetFileDropList(StringCollection) Méthode

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
Clipboard.cs
Source:
Clipboard.cs
Source:
Clipboard.cs
Source:
Clipboard.cs
Source:
Clipboard.cs

Efface le Presse-papiers, puis ajoute une collection de noms de fichiers au FileDrop format.

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)

Paramètres

filePaths
StringCollection

Contenant StringCollection les noms de fichiers.

Exceptions

ExternalException

Le Presse-papiers n’a pas pu être effacé. Cela se produit généralement lorsque le Presse-papiers est utilisé par un autre processus.

ThreadStateException

Le thread actuel n’est pas en mode STA (Single-Threaded Apartment). Ajoutez la STAThreadAttribute méthode de Main votre application.

ArgumentNullException

filePaths a la valeur null.

ArgumentException

filePaths ne contient aucune chaîne.

- ou -

Au moins une des chaînes dans filePaths est Empty, contient uniquement un espace blanc, contient un ou plusieurs caractères non valides tels que définis par InvalidPathChars, est null, contient un signe deux-points (:) ou dépasse la longueur maximale définie par le système.

Pour plus d’informationsInnerException, consultez la ArgumentException propriété.

Exemples

L’exemple suivant illustre ce membre.

// 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

Remarques

Une liste déroulante de fichiers est une collection de chaînes contenant des informations de chemin d’accès pour les fichiers.

Une liste déroulante de fichiers est stockée dans le Presse-papiers sous forme de String tableau. Cette méthode se filePaths convertit en tableau String avant de l’ajouter au Presse-papiers.

Pour récupérer une liste déroulante de fichiers dans le Presse-papiers, utilisez d’abord la ContainsFileDropList méthode pour déterminer si le Presse-papiers contient des données dans ce format avant de les récupérer avec la GetFileDropList méthode.

Note

La Clipboard classe ne peut être utilisée que dans les threads définis en mode STA (Single Thread Apartment). Pour utiliser cette classe, vérifiez que votre Main méthode est marquée avec l’attribut STAThreadAttribute .

S’applique à

Voir aussi