Clipboard.ContainsData(String) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Indica se há dados na área de transferência que estão no formato especificado ou que podem ser convertidos nesse 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 serem procurados. Consulte DataFormats para obter os formatos predefinidos.

Retornos

Boolean

true se houver dados na área de transferência que estejam no format especificado ou que possam ser convertido nesse formato. Caso contrário, false.

Exceções

ExternalException

Não foi possível limpar a Área de Transferência. Isso geralmente ocorre quando a Área de Transferência está sendo usada por outro processo.

ThreadStateException

O thread atual não está no modo STA (Single-Threaded Apartment). Adicione o STAThreadAttribute ao método Main do aplicativo.

Exemplos

O exemplo a seguir demonstra esse 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

Comentários

A DataFormats classe contém nomes de formato predefinidos que você pode usar com esse método.

Use esse método para determinar se a Área de Transferência contém dados no formato especificado ou um formato compatível antes de recuperá-los com o GetData método .

Observação

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

A Clipboard classe só pode ser usada em threads definidos como modo STA (single thread apartment). Para usar essa classe, verifique se o Main método está marcado com o STAThreadAttribute atributo .

Confira também

• DataFormats
• GetData(String)
• SetData(String, Object)