Clipboard.ContainsData(String) Metodo

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Indica se sono presenti dati negli Appunti nel formato specificato o che possono essere convertiti in tale formato.

public:
 static bool ContainsData(System::String ^ format);
public static bool ContainsData(string format);
static member ContainsData : string -> bool
Public Shared Function ContainsData (format As String) As Boolean

Parametri

format
String

Formato dei dati da cercare. Vedere DataFormats per i formati predefiniti.

Valori restituiti

Boolean

true se negli Appunti sono presenti dati presenti nell'oggetto specificato format o che possono essere convertiti in tale formato; in caso contrario, false.

Eccezioni

ExternalException

Impossibile cancellare gli Appunti. Ciò si verifica in genere quando gli Appunti vengono usati da un altro processo.

ThreadStateException

Il thread corrente non è in modalità apartment a thread singolo (STA). Aggiungere l'oggetto STAThreadAttribute al metodo dell'applicazione Main .

Esempio

Nell'esempio seguente viene illustrato questo membro.

// 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

Commenti

La DataFormats classe contiene nomi di formato predefiniti che è possibile usare con questo metodo.

Utilizzare questo metodo per determinare se gli Appunti contengono dati nel formato specificato o in un formato compatibile prima di recuperarli con il GetData metodo .

Note

I dati possono essere convertiti in un altro formato se sono stati archiviati specificando che la conversione è consentita e se il formato richiesto è compatibile con il formato archiviato. Ad esempio, i dati archiviati come Unicode possono essere convertiti in testo.

La classe Clipboard può essere utilizzata solo nei thread impostati sulla modalità STA (Single Thread Apartment), a thread singolo. Per usare questa classe, assicurarsi che il metodo Main sia contrassegnato con l'attributo STAThreadAttribute.

Si applica a

Vedi anche