Partilhar via

Clipboard.GetFileDropList Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Recupera uma coleção de nomes de arquivo da Área de Transferência.

public:
 static System::Collections::Specialized::StringCollection ^ GetFileDropList();
public static System.Collections.Specialized.StringCollection GetFileDropList ();
static member GetFileDropList : unit -> System.Collections.Specialized.StringCollection
Public Shared Function GetFileDropList () As StringCollection

Retornos

StringCollection

Um StringCollection que contém nomes de arquivo ou null se a Área de Transferência não contiver dados que estejam no formato FileDrop ou que possam ser convertidos nesse formato.

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.

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 converte essa matriz em um StringCollection e retorna a coleção.

Use o ContainsFileDropList método para determinar se a Área de Transferência contém uma lista suspensa de arquivos antes de recuperá-la com esse método.

Use o SetFileDropList método para adicionar uma lista suspensa de arquivos à Área de Transferência.

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 .

Aplica-se a

Confira também