Sdílet prostřednictvím

Clipboard.SetData(String, Object) Metoda

  • Reference

Definice

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

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

Viz také