Clipboard.SetData(String, Object) Metoda

Definice

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

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á chcete 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 STA (Single-Threaded Apartment). Přidejte metodu STAThreadAttributeMain aplikace.

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 data ukládat ve více formátech pomocí této metody.

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 pomocí ContainsData metody určete, zda schránka obsahuje data v tomto formátu před načtením pomocí GetData 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.

Platí pro

Viz také