Condividi tramite


Clipboard.GetData(String) Metodo

Definizione

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

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

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

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

Vedi anche