DataObject Classe

Définition

public ref class DataObject : System::Windows::Forms::IDataObject

public ref class DataObject : System::Runtime::InteropServices::ComTypes::IDataObject, System::Windows::Forms::IDataObject

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
public class DataObject : System.Windows.Forms.IDataObject

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
public class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.Forms.IDataObject

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type DataObject = class
    interface IDataObject
    interface UnsafeNativeMethods.IOleDataObject

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type DataObject = class
    interface IDataObject
    interface IDataObject

Public Class DataObject
Implements IDataObject

Public Class DataObject
Implements IDataObject, IDataObject

Héritage

Object

DataObject

Attributs

ClassInterfaceAttribute

Implémente

IDataObject IDataObject

Exemples

L’exemple de code suivant ajoute des données dans un DataObject. Tout d’abord, un nouveau DataObject est créé et un composant est stocké dans celui-ci. Ensuite, il vérifie si les données du type approprié existent dans le DataObject. Le résultat est affiché dans une zone de texte. Ce code nécessite la textBox1 création.

private:
   void AddMyData3()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a new data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds the component to the DataObject.
      myDataObject->SetData( myComponent );
      
      // Prints whether data of the specified type is in the DataObject.
      Type^ myType = myComponent->GetType();
      if ( myDataObject->GetDataPresent( myType ) )
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is present in the DataObject" );
      }
      else
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is not present in the DataObject" );
      }
   }

private void AddMyData3() {
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Creates a new data object.
    DataObject myDataObject = new DataObject();
 
    // Adds the component to the DataObject.
    myDataObject.SetData(myComponent);
 
    // Prints whether data of the specified type is in the DataObject.
    Type myType = myComponent.GetType();
    if(myDataObject.GetDataPresent(myType))
       textBox1.Text = "Data of type " + myType.ToString() + 
       " is present in the DataObject";
    else
       textBox1.Text = "Data of type " + myType.ToString() +
       " is not present in the DataObject";
 }

Private Sub AddMyData3()
    ' Creates a component to store in the data object.
    Dim myComponent As New Component()
    
    ' Creates a new data object.
    Dim myDataObject As New DataObject()
    
    ' Adds the component to the DataObject.
    myDataObject.SetData(myComponent)
    
    ' Prints whether data of the specified type is in the DataObject.
    Dim myType As Type = myComponent.GetType()
    If myDataObject.GetDataPresent(myType) Then
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is present in the DataObject"
    Else
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is not present in the DataObject"
    End If
End Sub

L’exemple suivant récupère les données stockées dans un DataObject. Tout d’abord, un nouveau DataObject est créé avec des données de texte. Ensuite, les données sont récupérées, en spécifiant son format en tant que chaîne et affichées dans une zone de texte. Le format de données est automatiquement converti du texte en chaîne. Ce code nécessite la textBox1 création.

void GetMyData2()
{
   // Creates a new data object using a string and the text format.
   DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"Text to Store" );
   
   // Prints the string in a text box.
   textBox1->Text = myDataObject->GetData( DataFormats::Text )->ToString();
}

private void GetMyData2() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "Text to Store");
 
    // Prints the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString();
 }

Private Sub GetMyData2()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "Text to Store")
    
    ' Prints the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString()
End Sub

Remarques

DataObject implémente l’interface, dont les méthodes fournissent un mécanisme indépendant du format pour le IDataObject transfert de données.

Un DataObject est généralement utilisé avec les Clipboard opérations de glisser-déplacer et de glisser-déplacer. La DataObject classe fournit l’implémentation recommandée de l’interface IDataObject . Il est suggéré d’utiliser la DataObject classe plutôt que de vous implémenter IDataObject vous-même.

Plusieurs éléments de données dans différents formats peuvent être stockés dans un DataObject. Les données sont récupérées à partir d’un DataObject format associé. Étant donné que l’application cible peut ne pas être connue, vous pouvez augmenter la probabilité que les données soient au format approprié pour une application en plaçant les données dans plusieurs DataObject formats. Consultez DataFormats les formats prédéfinis. Vous pouvez implémenter votre propre format en créant une instance de la DataFormats.Format classe.

Pour stocker des données dans un DataObject, transmettez les données au constructeur ou à l’appel SetData. Vous pouvez ajouter des données dans plusieurs formats au même DataObjectformat. Si vous souhaitez que les données que vous ajoutez soient récupérées dans son format natif uniquement, appelez SetData(String, Boolean, Object) avec le autoConvert paramètre défini sur false.

Les données peuvent être récupérées à partir d’un DataObject format compatible avec GetData. Par exemple, le texte peut être converti en Unicode. Pour récupérer des données au format dans lequel il a été stocké, appelez GetData avec le autoConvert paramètre défini sur false.

Pour déterminer quels formats les données sont stockées, appelez GetFormats. Pour déterminer si un format est disponible, appelez GetDataPresent avec le format souhaité.

La DataObject classe fournit des méthodes supplémentaires qui facilitent l’utilisation des données dans des formats courants. Pour ajouter des données d’un format particulier à l’élément DataObject, utilisez la méthode Format appropriéeSet, telle que SetText. Pour récupérer des données d’un format particulier à partir du DataObject, appelez d’abord la méthode Format appropriée Contains (par exempleContainsText) pour déterminer si les DataObject données contiennent dans ce format, puis appelez la méthode Format appropriée Get (par exempleGetText) pour récupérer les données si elles le DataObject contiennent.

Voir aussi

• Clipboard
• IDataObject
• DataFormats