IDataObject.GetDataPresent Méthode

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

Détermine si les données stockées dans cette instance sont associées au format spécifié.

Surcharges

GetDataPresent(String)	Détermine si les données stockées dans cette instance sont associées au format spécifié ou si elles peuvent être converties dans le format spécifié.
GetDataPresent(Type)	Détermine si les données stockées dans cette instance sont associées au format spécifié ou si elles peuvent être converties dans le format spécifié.
GetDataPresent(String, Boolean)	Détermine si les données stockées dans cette instance sont associées au format spécifié, grâce à une valeur booléenne permettant de déterminer si les données doivent être converties dans le format spécifié.

GetDataPresent(String)

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

public:
 bool GetDataPresent(System::String ^ format);

public bool GetDataPresent (string format);

abstract member GetDataPresent : string -> bool

Public Function GetDataPresent (format As String) As Boolean

Paramètres

format: String

Format à vérifier. Consultez DataFormats pour obtenir les formats prédéfinis.

Retours

Boolean

true si les données stockées dans cette instance sont associées ou peuvent être converties au format spécifié ; sinon false.

Exemples

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 objet de données à l’aide d’une chaîne et du Text format. Ensuite, il vérifie que les données sont présentes dans le Text format et affiche les résultats dans une boîte de message. L’exemple suppose que vous avez créé un Form nom Form1.

private:
   void TestDataObject()
   {
      // Creates a new data object using a string and the Text format.
      String^ myString = "Hello World!";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Checks whether the data is present in the Text format and displays the result.
      if ( myDataObject->GetDataPresent( DataFormats::Text ) )
            MessageBox::Show( "The stored data is in the Text format.", "Test Result" );
      else
            MessageBox::Show( "The stored data is not in the Text format.", "Test Result" );
   }

       private void TestDataObject() 
       {
           // Creates a new data object using a string and the Text format.
           string myString = "Hello World!";
           DataObject myDataObject = new DataObject(DataFormats.Text, myString);

           // Checks whether the data is present in the Text format and displays the result.
           if (myDataObject.GetDataPresent(DataFormats.Text))
               MessageBox.Show("The stored data is in the Text format." , "Test Result");
           else
               MessageBox.Show("The stored data is not in the Text format.", "Test Result");
       }

Private Sub TestDataObject()
    ' Creates a new data object using a string and the Text format.
    Dim myString As New String("Hello World!")
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Checks whether the data is present in the Text format and displays the result.
    If (myDataObject.GetDataPresent(DataFormats.Text)) Then
        MessageBox.Show("The stored data is in the Text format.", "Test Result")
    Else
        MessageBox.Show("The stored data is not in the Text format.", "Test Result")
    End If
End Sub

Remarques

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

Notes

Les données peuvent être converties dans un autre format s’il a été stocké 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 peuvent être converties en texte.

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

Voir aussi

S’applique à

GetDataPresent(Type)

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

public:
 bool GetDataPresent(Type ^ format);

public bool GetDataPresent (Type format);

abstract member GetDataPresent : Type -> bool

Public Function GetDataPresent (format As Type) As Boolean

Paramètres

format: Type

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

Retours

Boolean

true si les données stockées dans cette instance sont associées ou peuvent être converties au format spécifié ; sinon false.

Exemples

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). Ensuite, il vérifie si les données spécifiées sont stockées dans myDataObject. Si le test est trueévalué, il 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 nom Form1 et un TextBox nommé textBox1.

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

      // Creates a new data object and assigns it the component.
      DataObject^ myDataObject = gcnew 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." );
   }

       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.");
           }
       }

Private Sub GetDataPresent2()
    ' Creates a component to store in the data object.
    Dim myComponent As New System.ComponentModel.Component()

    ' Creates a new data object and assigns it the component.
    Dim myDataObject As New DataObject(myComponent)

    'Creates a type to store the type of data.
    Dim myType As Type = myComponent.GetType()

    ' Checks whether the specified data type exists in the object.
    If myDataObject.GetDataPresent(myType) Then
        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.")
    End If
End Sub

Remarques

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

Notes

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

Voir aussi

S’applique à

GetDataPresent(String, Boolean)

Détermine si les données stockées dans cette instance sont associées au format spécifié, grâce à une valeur booléenne permettant de déterminer si les données doivent être converties dans le format spécifié.

public:
 bool GetDataPresent(System::String ^ format, bool autoConvert);

public bool GetDataPresent (string format, bool autoConvert);

abstract member GetDataPresent : string * bool -> bool

Public Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean

Paramètres

format: String

Format à vérifier. Consultez DataFormats pour obtenir les formats prédéfinis.

autoConvert: Boolean

true pour déterminer si les données stockées dans cette instance peuvent être converties dans le format spécifié ; false pour vérifier si les données correspondent au format spécifié.

Retours

Boolean

true en présence de données dans le format spécifié ou en cas de possibilité de conversion des données dans le format spécifié ; sinon false.

Exemples

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 objet de données (myDataObject) à l’aide d’une chaîne et du Text format. Ensuite, il interroge l’objet pour les données associées au Text format, avec le autoConvert paramètre défini sur false. Cette version d’évaluation échoue et le résultat s’affiche dans une zone de message intitulée « Message #1 ». Dans la deuxième version d’évaluation, elle définit le autoConvert paramètre sur true. Cette version d’évaluation réussit et le résultat s’affiche dans une zone de message intitulée « Message #2 ». L’exemple suppose que vous avez créé un Form nom Form1.

private:
   void GetDataPresent3()
   {
      // Creates a new data object using a string and the Text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"My String" );

      // Checks whether the string can be displayed with autoConvert equal to false.
      if ( myDataObject->GetDataPresent( "System::String", false ) )
            MessageBox::Show( myDataObject->GetData( "System::String", false )->ToString(), "Message #1" );
      else
            MessageBox::Show( "Cannot convert data to the specified format with autoConvert set to false.", "Message #1" );

      // Displays the string with autoConvert equal to true.
      MessageBox::Show( "Now that autoConvert is true, you can convert " + myDataObject->GetData( "System::String", true ) + " to string format.", "Message #2" );
   }

       private void GetDataPresent3() 
       {
           // Creates a new data object using a string and the Text format.
           DataObject myDataObject = new DataObject(DataFormats.Text, "My String");

           // Checks whether the string can be displayed with autoConvert equal to false.
           if(myDataObject.GetDataPresent("System.String", false)) 
               MessageBox.Show(myDataObject.GetData("System.String", false).ToString(), "Message #1");
           else
               MessageBox.Show("Cannot convert data to the specified format with autoConvert set to false.", "Message #1");

           // Displays the string with autoConvert equal to true.
           MessageBox.Show("Now that autoConvert is true, you can convert " + 
               myDataObject.GetData("System.String", true).ToString() + " to string format.","Message #2");
       }

Private Sub GetDataPresent3()
    ' Creates a new data object using a string and the Text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "My String")

    ' Checks whether the string can be displayed with autoConvert equal to false.
    If myDataObject.GetDataPresent("System.String", False) Then
        MessageBox.Show(myDataObject.GetData("System.String", False).ToString() + ".", "Message #1")
    Else
        MessageBox.Show("Cannot convert data to the specified format with autoConvert set to false.", "Message #1")
    End If
    ' Displays the string with autoConvert equal to true.
    MessageBox.Show(("Now that autoConvert is true, you can convert " + myDataObject.GetData("System.String", _
         True).ToString() + " to string format."), "Message #2")

End Sub

Remarques

Appelez cette méthode pour déterminer si un format existe dans ce DataObject fichier avant d’appeler GetData. Appelez GetFormats les formats disponibles dans cette instance.

Cette méthode retourne true quand :

Le autoConvert paramètre est true et les données se trouvent dans un format qui peut être converti au format approprié.
Le autoConvert paramètre est false et les données sont au format approprié.

Cette méthode retourne false quand :

Le autoConvert paramètre est true et cette méthode ne peut pas trouver de données au format spécifié, et elle ne peut pas convertir les données au format spécifié, ou les données ont été stockées avec autoConvert la valeur définie false.
Le autoConvert paramètre est false, et les données n’existent pas dans cette instance au format spécifié.

Notes

Les données peuvent être converties en un autre format s’il a été stocké en spécifiant que cette conversion est autorisée et si le format demandé est compatible avec le format stocké. Par exemple, les données stockées en unicode peuvent être converties en texte.

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

Voir aussi

S’applique à

IDataObject.GetDataPresent Méthode

Définition

Surcharges

GetDataPresent(String)

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

GetDataPresent(Type)

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

GetDataPresent(String, Boolean)

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

Ressources supplémentaires