Clipboard.SetFileDropList(StringCollection) Метод

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll
Исходный код:
Clipboard.cs
Исходный код:
Clipboard.cs
Исходный код:
Clipboard.cs
Исходный код:
Clipboard.cs
Исходный код:
Clipboard.cs

Очищает буфер обмена и добавляет коллекцию имен файлов в 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)

Параметры

filePaths
StringCollection

Содержит StringCollection имена файлов.

Исключения

ExternalException

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

ThreadStateException

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

ArgumentNullException

filePaths равно null.

ArgumentException

filePaths не содержит строк.

–или–

По крайней мере одна из строк содержит filePathsEmptyтолько пробелы, содержит один или несколько недопустимых символов, как определено InvalidPathChars, содержит nullдвоеточие (:) или превышает системную максимальную длину.

Дополнительные сведения см. в InnerException свойстве ArgumentException .

Примеры

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

// 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 . Этот метод преобразуется filePaths в String массив перед добавлением в буфер обмена.

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

Note

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

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

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