Поделиться через


Clipboard.GetFileDropList Метод

Определение

Извлекает из буфера обмена коллекцию имен файлов.

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

Возвращаемое значение

Коллекция StringCollection, содержащая имена файлов, или значение null, если буфер обмена не содержит никаких данных в формате FileDrop или данных, которые могут быть преобразованы в этот формат.

Исключения

Не удалось очистить буфер обмена. Обычно это происходит, когда буфер обмена используется другим процессом.

Текущий поток не выполняется в режиме апартмента с одним потоком (STA). Добавьте STAThreadAttribute в метод Main своего приложения.

Примеры

В следующем примере демонстрируется этот элемент.

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

Комментарии

Раскрывающийся список файлов — это коллекция строк, содержащих сведения о пути к файлам.

Раскрывающийся список файлов хранится в буфере обмена в виде массива String . Этот метод преобразует этот массив в StringCollection и возвращает коллекцию .

Используйте метод , ContainsFileDropList чтобы определить, содержит ли буфер обмена раскрывающийся список файлов, прежде чем получать его с помощью этого метода.

Используйте метод , SetFileDropList чтобы добавить раскрывающийся список файлов в буфер обмена.

Примечание

Класс Clipboard можно использовать только в потоках в режиме контейнера с одним потоком (STA). Чтобы использовать этот класс, убедитесь, что метод Main отмечен атрибутом STAThreadAttribute.

Применяется к

См. также раздел