Clipboard.SetData(String, Object) 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á data v zadaném formátu.

public:
 static void SetData(System::String ^ format, System::Object ^ data);

public static void SetData (string format, object data);

static member SetData : string * obj -> unit

Public Shared Sub SetData (format As String, data As Object)

Parametry

format: String

Formát dat, která se mají nastavit. Viz DataFormats předdefinované formáty.

data: Object

Představuje Object data, která se mají přidat.

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

data je null.

Příklady

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

// Demonstrates SetData, ContainsData, and GetData.
public Object SwapClipboardFormattedData(String format, Object data)
{
    Object returnObject = null;
    if (Clipboard.ContainsData(format))
    {
        returnObject = Clipboard.GetData(format);
        Clipboard.SetData(format, data);
    }
    return returnObject;
}

' Demonstrates SetData, ContainsData, and GetData.
Public Function SwapClipboardFormattedData( _
    ByVal format As String, ByVal data As Object) As Object

    Dim returnObject As Object = Nothing

    If (Clipboard.ContainsData(format)) Then
        returnObject = Clipboard.GetData(format)
        Clipboard.SetData(format, data)
    End If

    Return returnObject

End Function

Poznámky

Pokud neznáte formát cílové aplikace, můžete pomocí této metody ukládat data ve více formátech.

Data uložená pomocí této metody lze při načtení převést do kompatibilního formátu.

Chcete-li načíst data ze schránky v určitém formátu, nejprve použijte metodu ContainsData k určení, zda schránka obsahuje data v daném formátu před načtením pomocí GetData 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