Clipboard.SetFileDropList(StringCollection) Metodo

  • Riferimento

Definizione

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

Cancella il contenuto degli Appunti e aggiunge un insieme di nomi di file nel formato 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)

Parametri

filePaths
StringCollection

Classe StringCollection contenente i nomi di file.

Eccezioni

ExternalException

Impossibile cancellare gli Appunti. Ciò si verifica solitamente se un altro processo sta utilizzando gli Appunti.

ThreadStateException

Il thread corrente non è in modalità Single Thread Apartment (STA). Aggiungere la classe STAThreadAttribute al metodo Main dell'applicazione.

ArgumentNullException

filePaths è null.

ArgumentException

Il parametro filePaths non contiene stringhe.

-oppure-

Almeno una stringa in filePaths è Empty, contiene solo uno spazio bianco, contiene uno o più caratteri non validi come definito dalla classe InvalidPathChars, è null, contiene il carattere due punti (:) oppure supera la lunghezza massima definita dal sistema.

Per ulteriori informazioni, vedere la proprietà InnerException della classe 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 .

Nota

La Clipboard classe può essere usata solo nei thread impostati sulla modalità single thread apartment (STA). Per usare questa classe, assicurarsi che il Main metodo sia contrassegnato con l'attributo STAThreadAttribute .

Si applica a

Vedi anche