Clipboard.SetFileDropList(StringCollection) Metoda

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vymaže schránku a pak 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 jednovláknového panelu (STA). Přidejte do STAThreadAttribute metody aplikace Main parametr .

ArgumentNullException

filePaths je null.

ArgumentException

filePaths neobsahuje žádné řetězce.

-nebo-

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

Další informace najdete ve InnerException vlastnosti objektu 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ě k souborům.

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

Chcete-li načíst rozevírací seznam souborů ze schránky, nejprve použijte metodu ContainsFileDropList k určení, zda schránka obsahuje data v daném formátu před načtením pomocí GetFileDropList metody .

Poznámka

Třídu 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 Main metoda označena atributem STAThreadAttribute .

Platí pro