Clipboard.SetFileDropList(StringCollection) Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

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

StringCollection contenant les noms de fichiers.

Exceptions

ExternalException

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

ThreadStateException

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

ArgumentNullException

filePaths a la valeur null.

ArgumentException

filePaths ne contient pas de chaînes.

- ou -

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

Pour plus d'informations, consultez la propriété InnerException de ArgumentException.

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 est filePaths convertie en tableau String avant de l’ajouter au Presse-papiers.

Pour récupérer une liste déroulante de fichiers à partir du 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 .

Notes

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