Clipboard.GetData(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.

Recupera i dati dagli Appunti nel formato specificato.

public:
 static System::Object ^ GetData(System::String ^ format);

public static object GetData (string format);

public static object? GetData (string format);

static member GetData : string -> obj

Public Shared Function GetData (format As String) As Object

Parametri

format: String

Formato dei dati da recuperare. Per i formati predefiniti, vedere DataFormats.

Restituisce

Object

Classe Object che rappresenta i dati degli Appunti o null se gli Appunti non contengono dati nel format specificato o che possano essere convertiti in tale formato.

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

Usare il ContainsData metodo per determinare se gli Appunti contengono dati nel formato specificato o in un formato compatibile prima di recuperarlo con questo metodo.

Se questo metodo non riesce a trovare i dati nel formato specificato, tenta di convertire i dati nel formato. Se i dati non possono essere convertiti nel formato specificato o se i dati sono stati archiviati con la conversione automatica impostata su false, questo metodo restituisce null.

Nota

I dati possono essere convertiti in un altro formato se è stato archiviato 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 .

Usare il SetData metodo per aggiungere dati agli Appunti in un formato specifico.

Si applica a

Condividi tramite