Clipboard.SetFileDropList(StringCollection) Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Borra el Portapapeles y, a continuación, agrega una colección de nombres de archivo en el 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)

Parámetros

filePaths
StringCollection

StringCollection que contiene los nombres de archivo.

Excepciones

ExternalException

No se ha podido vaciar el Portapapeles. Esto ocurre normalmente cuando otro proceso utiliza el Portapapeles.

ThreadStateException

El subproceso actual no está en el modo de contenedor uniproceso (STA). Agregue STAThreadAttribute al método Main de la aplicación.

ArgumentNullException

filePaths es null.

ArgumentException

filePaths no contiene ninguna cadena.

o bien

Al menos una de las cadenas de filePaths es Empty, contiene sólo espacio en blanco, contiene uno o varios caracteres no válidos de los que define InvalidPathChars, es null, contiene un carácter de dos puntos (:) o supera la longitud máxima definida por el sistema.

Para obtener más información, vea la propiedad InnerException de ArgumentException.

Ejemplos

En el ejemplo siguiente se muestra este miembro.

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

Comentarios

Una lista desplegable de archivos es una colección de cadenas que contienen información de ruta de acceso para los archivos.

Una lista desplegable de archivos se almacena en el Portapapeles como una String matriz. Este método se filePaths convierte en una String matriz antes de agregarla al Portapapeles.

Para recuperar una lista desplegable de archivos del Portapapeles, use primero el ContainsFileDropList método para determinar si el Portapapeles contiene datos en ese formato antes de recuperarlos con el GetFileDropList método .

Nota

La clase Clipboard solo se puede usar en subprocesos establecidos en modo de subprocesamiento controlado simple (STA). Para usar esta clase, asegúrese de que el método Main está marcado con el atributo STAThreadAttribute.

Se aplica a

Consulte también