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: Single Thread Apartment) モードになっていません。 アプリケーションの Main メソッドに STAThreadAttribute を追加してください。

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 格納されます。 このメソッドは、クリップボードに追加するString前に配列に変換filePathsします。

クリップボードからファイル のドロップ リストを取得するには、 メソッドを ContainsFileDropList 使用して取得する前 GetFileDropList に、 メソッドを使用してクリップボードにその形式のデータが含まれているかどうかを判断します。

注意

Clipboard クラスは、STA (シングル スレッド アパートメント) モードに設定されたスレッドでのみ使用できます。 このクラスを使用するには、お使いの Main メソッドが STAThreadAttribute 属性でマークされているようにします。

適用対象

こちらもご覧ください