Clipboard.SetFileDropList(StringCollection) Metod

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll
Källa:
Clipboard.cs
Källa:
Clipboard.cs
Källa:
Clipboard.cs
Källa:
Clipboard.cs
Källa:
Clipboard.cs

Rensar Urklipp och lägger sedan till en samling filnamn i FileDrop formatet.

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)

Parametrar

filePaths
StringCollection

En StringCollection som innehåller filnamnen.

Undantag

ExternalException

Urklipp kunde inte rensas. Detta inträffar vanligtvis när Urklipp används av en annan process.

ThreadStateException

Den aktuella tråden är inte i sta-läge (single-threaded apartment). Lägg till i STAThreadAttribute programmets Main metod.

ArgumentNullException

filePaths är null.

ArgumentException

filePaths innehåller inga strängar.

-eller-

Minst en av strängarna i filePaths är Empty, innehåller endast tomt utrymme, innehåller ett eller flera ogiltiga tecken som definieras av InvalidPathChars, är null, innehåller ett kolon (:) eller överskrider den systemdefinierade maximala längden.

Mer information finns i InnerException egenskapen för .ArgumentException

Exempel

I följande exempel visas den här medlemmen.

// 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

Kommentarer

En fillistelista är en samling strängar som innehåller sökvägsinformation för filer.

En fillistelista lagras i Urklipp som en String matris. Den här metoden konverterar filePaths till en String matris innan den läggs till i Urklipp.

Om du vill hämta en fillistelista från Urklipp använder ContainsFileDropList du först metoden för att avgöra om Urklipp innehåller data i det formatet innan du hämtar dem med GetFileDropList metoden.

Note

Klassen Clipboard kan endast användas i trådar som är inställda på sta-läge (single thread apartment). Om du vill använda den här klassen kontrollerar du att din Main-metod har markerats med attributet STAThreadAttribute.

Gäller för

Se även