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

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

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type DataObject = class
    interface IDataObject
    interface IDataObject.Interface
    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 y est stocké. Ensuite, il vérifie si des données du type approprié existent dans le DataObject. Le résultat s’affiche dans une zone de texte. Ce code nécessite que l’a textBox1 été créé.

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 texte. Ensuite, les données sont récupérées, en spécifiant leur format sous forme de 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 que l’a textBox1 été créé.

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 IDataObject méthodes fournissent un mécanisme indépendant du format pour le transfert de données.

Un DataObject est généralement utilisé avec et dans les Clipboard opérations 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 par son format associé. Étant donné que l’application cible n’est peut-être pas 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 pour connaître 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, passez les données au constructeur ou appelez SetData. Vous pouvez ajouter des données dans plusieurs formats au même DataObject. Si vous souhaitez que les données que vous ajoutez soient récupérées uniquement dans leur format natif, 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 dans n’importe quel format compatible avec GetData. Par exemple, le texte peut être converti en Unicode. Pour récupérer des données au format dans lequel elles ont été stockées, appelez GetData avec le autoConvert paramètre défini sur false.

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

Dans .NET Framework 2.0, 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 au DataObject, utilisez la méthode Format appropriéeSet, telle que SetText. Pour récupérer des données d’un format particulier à partir de , DataObjectappelez d’abord la méthode Format appropriée Contains (telle que ContainsText) pour déterminer si le DataObject contient des données dans ce format, puis appelez la méthode Format appropriée Get (telle que GetText) pour récupérer les données si le DataObject contient.

Constructeurs

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• Clipboard
• IDataObject
• DataFormats