Clipboard.ContainsData(String) Método

Definição

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

Indica se existem dados na Área de Transferência que estão no formato especificado ou se podem ser convertidos para esse 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

Parâmetros

format
String

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

Devoluções

Boolean

true se houver dados na Área de Transferência que estejam no especificado format ou possam ser convertidos para esse formato; caso contrário, false.

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.

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

A DataFormats classe contém nomes de formato pré-definidos que pode usar com este método.

Use este método para determinar se a Área de Transferência contém dados no formato especificado ou num formato compatível antes de os recuperar com o GetData método.

Note

Os dados podem ser convertidos para outro formato se foram armazenados, especificando que a conversão é permitida, e se o formato solicitado for compatível com o formato armazenado. Por exemplo, dados armazenados como Unicode podem ser convertidos em texto.

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