Clipboard.SetFileDropList(StringCollection) 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

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 中不包含任何字符串。

- 或 -

在 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()