Clipboard.SetData(String, Object) Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Limpa a Área de Transferência e depois adiciona dados no formato especificado.

public:
 static void SetData(System::String ^ format, System::Object ^ data);
public static void SetData(string format, object data);
static member SetData : string * obj -> unit
Public Shared Sub SetData (format As String, data As Object)

Parâmetros

format
String

O formato dos dados a definir. Veja DataFormats para formatos pré-definidos.

data
Object

E representa Object os dados a adicionar.

Exceções

ExternalException

A prancheta não pôde ser limpa. Isto ocorre tipicamente quando a Prancheta está a ser usada por outro processo.

ThreadStateException

O tópico atual não está em modo apartamento single-threaded (STA). Adicione-os STAThreadAttribute ao processo da Main sua candidatura.

ArgumentNullException

data é null.

Exemplos

O exemplo seguinte demonstra este elemento.

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

Observações

Se não souber o formato da aplicação alvo, pode armazenar dados em múltiplos formatos usando este método.

Os dados armazenados com este método podem ser convertidos para um formato compatível quando são recuperados.

Para recuperar dados da Área de Transferência num determinado formato, primeiro use o ContainsData método para determinar se a Área de Transferência contém dados nesse formato antes de os recuperar com o GetData método.

Note

A classe Clipboard só pode ser usada em threads configurados para o modo apartamento de thread único (modo STA). Para usar essa classe, verifique se o método Main está marcado com o atributo STAThreadAttribute.

Aplica-se a

Ver também