Clipboard.SetFileDropList(StringCollection) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
清除剪貼簿，然後以該 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 -> unitPublic Shared Sub SetFileDropList (filePaths As StringCollection)參數
- filePaths
- StringCollection
包含檔案名稱的 A StringCollection 。
例外狀況
夾板無法清理。 這通常發生在夾板被其他程序使用時。
目前執行緒並非處於單執行緒公寓（STA）模式。 把STAThreadAttribute它Main加入你的申請方法。
filePaths 是 null。
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 類別只能在設定為單一執行緒 Apartment (STA) 模式的執行緒中使用。 若要使用此類別，請確定您的 Main 方法已標示為 STAThreadAttribute 屬性。
