Clipboard.ContainsData(String) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

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

Parametri

format: String

Formato di dati da ricercare. Per i formati predefiniti, vedere DataFormats.

Restituisce

Boolean

true se sono presenti dati negli Appunti nel format specificato o che possano essere convertiti in tale formato; in caso contrario, false.

Eccezioni

ExternalException

Impossibile cancellare gli Appunti. Ciò si verifica solitamente se un altro processo sta utilizzando gli Appunti.

ThreadStateException

Il thread corrente non è in modalità Single Thread Apartment (STA). Aggiungere la classe STAThreadAttribute al metodo Main dell'applicazione.

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 .

Nota

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 Clipboard classe può essere usata solo nei thread impostati sulla modalità single thread apartment (STA). Per usare questa classe, assicurarsi che il Main metodo sia contrassegnato con l'attributo STAThreadAttribute .

Si applica a