Clipboard.ContainsData(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> boolPublic Shared Function ContainsData (format As String) As BooleanParâmetros
- format
- String
O formato dos dados a serem procurados. Consulte DataFormats para obter os formatos predefinidos.
Retornos
true se os dados no formato especificado estiverem disponíveis na Área de Transferência; caso contrário, false.
Exceções
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.
