Clipboard.ContainsData(String) 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í.

Určuje, zda jsou ve schránce data, která jsou v zadaném formátu nebo mohou být převedena do daného formátu.

public:
 static bool ContainsData(System::String ^ format);

public static bool ContainsData (string format);

public static bool ContainsData (string? format);

static member ContainsData : string -> bool

Public Shared Function ContainsData (format As String) As Boolean

Parametry

format: String

Formát dat, která se mají hledat. Viz DataFormats informace o předdefinovaných formátech.

Návraty

Boolean

true pokud jsou ve schránce data, která jsou v zadaném format formátu nebo mohou být převedena do daného formátu, falsejinak .

Výjimky

ExternalException

Schránku nelze vymazat. K tomu obvykle dochází, když schránku používá jiný proces.

ThreadStateException

Aktuální vlákno není v režimu jednovláknového apartmentu (STA). Přidejte do STAThreadAttribute metody vaší aplikace Main .

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

Třída DataFormats obsahuje předdefinované názvy formátů, které můžete použít s touto metodou.

Tato metoda slouží k určení, zda schránka obsahuje data v zadaném formátu nebo kompatibilním formátu před načtením pomocí GetData metody .

Poznámka

Data lze převést do jiného formátu, pokud byla uložena s určením, že převod je povolený, a pokud je požadovaný formát kompatibilní s uloženým formátem. Například data uložená jako Unicode se dají převést na text.

Třídu Clipboard lze použít pouze ve vláknech nastavených na režim jednovláknového apartmentu (STA). Pokud chcete použít tuto třídu, ujistěte se, že je vaše Main metoda označená atributem STAThreadAttribute .

Platí pro