Clipboard.SetFileDropList(StringCollection) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Limpa a Área de Transferência e, em seguida, adiciona uma coleção de nomes de arquivos no 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

Um StringCollection que contém os nomes de arquivo.

Exceções

ExternalException

Não foi possível limpar a Área de Transferência. Isso geralmente ocorre quando a Área de Transferência está sendo usada por outro processo.

ThreadStateException

O thread atual não está no modo STA (Single-Threaded Apartment). Adicione o STAThreadAttribute ao método Main do aplicativo.

ArgumentNullException

filePaths é null.

ArgumentException

filePaths não contém nenhuma cadeia de caracteres.

- ou -

Pelo menos uma das cadeias de caracteres no filePaths é Empty, contém somente espaços em branco, contém um ou mais caracteres inválidos conforme definido por InvalidPathChars, é null, contém dois-pontos (:) ou excede o comprimento máximo definido pelo sistema.

Consulte a propriedade InnerException de ArgumentException para obter mais informações.

Exemplos

O exemplo a seguir demonstra esse 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

Comentários

Uma lista suspensa de arquivos é uma coleção de cadeias de caracteres que contêm informações de caminho para arquivos.

Uma lista suspensa de arquivos é armazenada na Área de Transferência como uma String matriz. Esse método é convertido filePaths em uma String matriz antes de adicioná-la à Área de Transferência.

Para recuperar uma lista suspensa de arquivos da Área de Transferência, primeiro use o ContainsFileDropList método para determinar se a Área de Transferência contém dados nesse formato antes de recuperá-los com o GetFileDropList método .

Observação

A Clipboard classe só pode ser usada em threads definidos como modo STA (single thread apartment). Para usar essa classe, verifique se o Main método está marcado com o STAThreadAttribute atributo .

Confira também

• FileDrop
• ContainsFileDropList()
• GetFileDropList()