Clipboard.SetFileDropList(StringCollection) Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

-или-

Хотя бы одна из строк в filePaths равна Empty, содержит только пробелы, содержит один или более недопустимых символов согласно определению 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 метода .

Примечание

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

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

• FileDrop
• ContainsFileDropList()
• GetFileDropList()