Clipboard.ContainsData(String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Consulta a Área de Transferência para a presença de dados num 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 procurar. Veja DataFormats para formatos pré-definidos.
Devoluções
true se os dados no formato especificado estiverem disponíveis na Prancheta; caso contrário, false.
Exceções
format é null.
Exemplos
O exemplo seguinte demonstra a utilização deste 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
Observações
Uma consulta para o formato Bitmap dos dados ou FileDrop retornará true se os dados puderem ser convertidos automaticamente para o formato especificado. Para outros formatos de dados, este método só retorna true se o formato especificado estiver disponível nativamente na Área de Transferência.
