Clipboard.SetFileDropList(StringCollection) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
Impossibile cancellare gli Appunti. Ciò si verifica solitamente se un altro processo sta utilizzando gli Appunti.
Il thread corrente non è in modalità Single Thread Apartment (STA). Aggiungere la classe STAThreadAttribute al metodo Main
dell'applicazione.
filePaths
è null
.
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 .