Clipboard.SetFileDropList(StringCollection) Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

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

Viz také