Clipboard.SetFileDropList(StringCollection) Metodo

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Cancella gli Appunti e quindi aggiunge una raccolta di nomi di file nel FileDrop formato .

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)

Parametri

filePaths
StringCollection

Oggetto StringCollection contenente i nomi di file.

Eccezioni

ExternalException

Impossibile cancellare gli Appunti. Ciò si verifica in genere quando gli Appunti vengono usati da un altro processo.

ThreadStateException

Il thread corrente non è in modalità apartment a thread singolo (STA). Aggiungere l'oggetto STAThreadAttribute al metodo dell'applicazione Main .

ArgumentNullException

filePaths è null.

ArgumentException

filePaths non contiene stringhe.

oppure

Almeno una delle stringhe in filePaths è Empty, contiene solo spazi vuoti, contiene uno o più caratteri non validi, come definito da , è null, contiene due punti (:) o supera la lunghezza massima definita dal InvalidPathCharssistema.

Per altre informazioni, vedere la InnerException proprietà di ArgumentException .

Esempio

Nell'esempio seguente viene illustrato questo membro.

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

Commenti

Un elenco a discesa di file è una raccolta di stringhe contenenti informazioni sul percorso per i file.

Un elenco a discesa di file viene archiviato negli Appunti come String matrice. Questo metodo viene convertito filePaths in una String matrice prima di aggiungerlo agli Appunti.

Per recuperare un elenco a discesa di file dagli Appunti, utilizzare prima di tutto il ContainsFileDropList metodo per determinare se gli Appunti contengono dati in tale formato prima di recuperarli con il GetFileDropList metodo .

Note

La classe Clipboard può essere utilizzata solo nei thread impostati sulla modalità STA (Single Thread Apartment), a thread singolo. Per usare questa classe, assicurarsi che il metodo Main sia contrassegnato con l'attributo STAThreadAttribute.

Si applica a

Vedi anche