Clipboard.ContainsData(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Interroge le Presse-papiers sur la présence de données au format de données spécifié.
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
Paramètres
- format
- String
Format des données à rechercher. Consultez DataFormats pour obtenir les formats prédéfinis.
Retours
true
si les données au format spécifié sont disponibles dans le Presse-papiers ; sinon false
.
Exceptions
format
a la valeur null
.
Exemples
L’exemple suivant illustre l’utilisation de cette méthode.
// 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
Remarques
Une requête pour le format Bitmap de données ou FileDrop retourne true
si les données peuvent être converties automatiquement au format de données spécifié. Pour les autres formats de données, cette méthode retourne true
uniquement si le format spécifié est disponible en mode natif dans le Presse-papiers.