Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

IDataObject.GetDataPresent méthode (Type)

 

Date de publication : novembre 2016

Détermine si les données stockées dans cette instance sont associées, ou peuvent être converties au format spécifié.

Espace de noms:   System.Windows.Forms
Assembly:  System.Windows.Forms (dans System.Windows.Forms.dll)

bool GetDataPresent(
	Type format
)

Paramètres

format
Type: System.Type

Un Type représentant le format à vérifier. Consultez DataFormats pour les formats prédéfinis.

Valeur de retour

Type: System.Boolean

true Si les données stockées dans cette instance est associée, ou peut être convertie au format spécifié ; dans le cas contraire, false.

Appelez cette méthode pour déterminer l’existence d’un format de ce DataObject avant d’appeler GetData. Appelez GetFormats pour les formats disponibles dans cette instance.

System_CAPS_noteRemarque

Données peuvent être converties dans un autre format si elle a été stockée en spécifiant que la conversion est autorisée, et si le format demandé est compatible avec le format stocké. Par exemple, les données stockées en Unicode peut être convertie en texte.

Pour une implémentation de cette méthode, consultez la page DataObject.GetDataPresent.

Cet exemple utilise la DataObject classe qui implémente IDataObject, pour illustrer l’utilisation de la GetDataPresent méthode. Tout d’abord, il crée un composant (myComponent) et le stocke dans un objet de données (myDataObject). Puis il vérifie si les données spécifiées sont stockées dans myDataObject. Si le test a la valeur true, elle affiche le résultat dans une boîte de message et affiche le type de données dans une zone de texte. Cet exemple suppose que vous avez déjà créé un Form nommé Form1 et un TextBox nommé textBox1.

private void GetDataPresent2() 
{
    // Creates a component to store in the data object.
    Component myComponent = new Component();

    // Creates a new data object and assigns it the component.
    DataObject myDataObject = new DataObject(myComponent);

    // Creates a type to store the type of data.
    Type myType = myComponent.GetType();

    // Checks whether the specified data type exists in the object.
    if (myDataObject.GetDataPresent(myType))
    {
        MessageBox.Show("The specified data is stored in the data object.");
        // Displays the type of data.
        textBox1.Text = "The data type is " + myDataObject.GetData(myType).GetType().Name + ".";
    }
    else
        MessageBox.Show("The specified data is not stored in the data object.");
}

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: