Clipboard.SetFileDropList(StringCollection) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

Clipboard.cs

Vymaže schránku a potom přidá kolekci názvů souborů ve FileDrop formátu.

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)

Parametry

filePaths

StringCollection

A StringCollection obsahující názvy souborů.

Výjimky

ExternalException

Schránku nelze vymazat. K tomu obvykle dochází v případě, že schránku používá jiný proces.

ThreadStateException

Aktuální vlákno není v režimu STA (Single-Threaded Apartment). Přidejte metodu STAThreadAttributeMain aplikace.

ArgumentNullException

filePaths je null.

ArgumentException

filePaths neobsahuje žádné řetězce.

nebo

Nejméně jeden z řetězců v filePaths je Empty, obsahuje pouze prázdné znaky, obsahuje jeden nebo více neplatných znaků definovaných InvalidPathChars, je null, obsahuje dvojtečku (:), nebo překračuje maximální délku definovanou systémem.

Další informace najdete ve InnerException vlastnosti ArgumentException .

Příklady

Následující příklad ukazuje tohoto člena.

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

Poznámky

Rozevírací seznam souborů je kolekce řetězců obsahujících informace o cestě pro soubory.

Rozevírací seznam souborů je uložen ve schránce jako String pole. Tato metoda se filePaths před přidáním do schránky převede na String pole.

Chcete-li načíst rozevírací seznam souborů ze schránky, nejprve pomocí ContainsFileDropList metody určete, zda schránka obsahuje data v tomto formátu před načtením GetFileDropList pomocí metody.

Note

Třída Clipboard lze použít pouze ve vláknech nastavených na režim jednovláknového apartmentu (STA). Chcete-li použít tuto třídu, ujistěte se, že je vaše metoda Main označena atributem STAThreadAttribute.

Viz také

• FileDrop
• ContainsFileDropList()
• GetFileDropList()