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 には文字列が含まれていません。

-又は-

filePaths内の少なくとも 1 つの文字列がEmpty、空白のみを含み、InvalidPathCharsによって定義された無効な文字が 1 つ以上含まれているか、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 属性でマークされていることを確認します。

適用対象

こちらもご覧ください