Clipboard.ContainsData(String) Método

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Consulta a Área de Transferência quanto à presença de dados no formato de dados especificado.

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 os dados no formato especificado estiverem disponíveis na Área de Transferência; caso contrário, false.

Exceções

ArgumentNullException

format é null.

Exemplos

O exemplo a seguir demonstra o uso desse método.

// After this line executes, IsHTMLDataOnClipboard will be true if
// HTML data is available natively on the clipboard; if not, it 
// will be false.
bool IsHTMLDataOnClipboard = Clipboard.ContainsData(DataFormats.Html);

// If there is HTML data on the clipboard, retrieve it.
string htmlData;
if(IsHTMLDataOnClipboard)
{

    htmlData = Clipboard.GetText(TextDataFormat.Html);
}

' After this line executes, IsHTMLDataOnClipboard will be true if
' HTML data is available natively on the clipboard; if not, it 
' will be false.
Dim IsHTMLDataOnClipboard As Boolean = Clipboard.ContainsData(DataFormats.Html)

' If there is HTML data on the clipboard, retrieve it.
Dim htmlData As String
If IsHTMLDataOnClipboard Then

    htmlData = Clipboard.GetText(TextDataFormat.Html)

End If

Comentários

Uma consulta para o formato Bitmap de dados ou FileDrop retornará true se os dados puderem ser convertidos automaticamente no formato de dados especificado. Para outros formatos de dados, esse método retornará true somente se o formato especificado estiver disponível nativamente na Área de Transferência.

Confira também

• ContainsAudio()
• ContainsFileDropList()
• ContainsImage()
• ContainsText
• GetData(String)
• SetData(String, Object)
• DataFormats