Partager via


IDataObject.GetData Méthode

Définition

Récupère les données associées au format de données spécifié.

Surcharges

GetData(String)

Récupère les données associées au format de données spécifié.

GetData(Type)

Récupère les données associées au format du type classe spécifié.

GetData(String, Boolean)

Récupère les données associées au format de données spécifié, grâce à une valeur booléenne permettant de déterminer si les données doivent être converties dans le format spécifié.

GetData(String)

Récupère les données associées au format de données spécifié.

public:
 System::Object ^ GetData(System::String ^ format);
public object GetData (string format);
public object? GetData (string format);
abstract member GetData : string -> obj
Public Function GetData (format As String) As Object

Paramètres

format
String

Format des données à récupérer. Consultez DataFormats pour obtenir les formats prédéfinis.

Retours

Données associées au format spécifié ou null.

Exemples

Cet exemple utilise la DataObject classe, qui implémente IDataObject, pour illustrer l’utilisation de la GetData méthode . La méthode est utilisée pour récupérer les données stockées dans myDataObject, qui est associée au Text format . L’exemple suppose que vous avez déjà créé un Form nommé Form1 et un TextBox nommé textBox1.

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

      // Displays the string in a text box.
      textBox1->Text = myDataObject->GetData( DataFormats::Text )->ToString();
   }
private void GetData1() 
{
    // Creates a new data object using a string and the text format.
    string myString = "My text string";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);

    // Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString();
}
Private Sub GetData1()
    ' Creates a new data object using a string and the text format.
    Dim myString As String = "My text string"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString()
End Sub

Remarques

Si cette méthode ne trouve pas de données dans le format spécifié, elle tente de convertir les données au format. Si les données ne peuvent pas être converties au format spécifié, cette méthode retourne null.

Pour déterminer si les données sont associées à ou peuvent être converties dans un format, appelez GetDataPresent avant d’appeler GetData. Appelez GetFormats pour obtenir la liste des formats valides pour les données stockées dans cette instance.

Notes

Les données peuvent être converties dans un autre format si elles ont été stockées, 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 obtenir une implémentation de cette méthode, consultez DataObject.GetData.

Voir aussi

S’applique à

GetData(Type)

Récupère les données associées au format du type classe spécifié.

public:
 System::Object ^ GetData(Type ^ format);
public object GetData (Type format);
public object? GetData (Type format);
abstract member GetData : Type -> obj
Public Function GetData (format As Type) As Object

Paramètres

format
Type

Type représentant le format des données à récupérer. Consultez DataFormats pour obtenir les formats prédéfinis.

Retours

Données associées au format spécifié ou null.

Exemples

Cet exemple utilise la DataObject classe , qui implémente IDataObject, pour illustrer l’utilisation de la GetData méthode . La méthode est utilisée pour récupérer les données stockées dans myObject, qui est associée à un type spécifique, myType. Le type des données récupérées s’affiche dans une zone de message. L’exemple suppose que vous avez déjà créé un Form nommé Form1.

private:
   void GetData2()
   {
      // Creates a component.
      Component^ myComponent = gcnew Component;

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

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

      // Retrieves the data using myType to represent its type.
      Object^ myObject = myDataObject->GetData( myType );
      if ( myObject != nullptr )
            MessageBox::Show( "The data type stored in the data object is " +
                  myObject->GetType()->Name + "." );
      else
            MessageBox::Show( "Data of the specified type was not stored in the data object." );
   }
       private void GetData2() 
       {
           // Creates a component.
           Component myComponent = new Component();

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

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

           // Retrieves the data using myType to represent its type.
           Object myObject = myDataObject.GetData(myType);
           if(myObject != null)
               MessageBox.Show("The data type stored in the data object is " +
                   myObject.GetType().Name + ".");
           else
               MessageBox.Show("Data of the specified type was not stored " +
                   "in the data object.");
       }
Private Sub GetData2()
    ' Creates a component.
    Dim myComponent As New System.ComponentModel.Component()

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

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

    ' Retrieves the data using myType to represent its type.
    Dim myObject As [Object] = myDataObject.GetData(myType)
    If (myObject IsNot Nothing) Then
        MessageBox.Show("The data type stored in the data object is " + myObject.GetType().Name + ".")
    Else
        MessageBox.Show("Data of the specified type was not stored " + "in the data object.")
    End If
End Sub

Remarques

Si cette méthode ne trouve pas de données dans le format spécifié, elle tente de convertir les données au format. Si les données ne peuvent pas être converties au format spécifié, cette méthode retourne null.

Pour déterminer si les données sont associées à ou peuvent être converties dans un format, appelez GetDataPresent avant d’appeler GetData. Appelez GetFormats pour obtenir la liste des formats valides pour les données stockées dans cette instance.

Notes

Les données peuvent être converties dans un autre format si elles ont été stockées, 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 obtenir une implémentation de cette méthode, consultez DataObject.GetData.

Voir aussi

S’applique à

GetData(String, Boolean)

Récupère les données associées au format de données 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:
 System::Object ^ GetData(System::String ^ format, bool autoConvert);
public object GetData (string format, bool autoConvert);
public object? GetData (string format, bool autoConvert);
abstract member GetData : string * bool -> obj
Public Function GetData (format As String, autoConvert As Boolean) As Object

Paramètres

format
String

Format des données à récupérer. Consultez DataFormats pour obtenir les formats prédéfinis.

autoConvert
Boolean

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

Retours

Données associées au format spécifié ou null.

Exemples

Cet exemple utilise la DataObject classe , qui implémente IDataObject, pour illustrer l’utilisation de la GetData méthode . L’exemple récupère les données stockées dans un DataObject, à l’aide du autoConvert paramètre pour spécifier s’il faut ou non convertir le format de données. Tout d’abord, myDataObject est créé avec des données texte. Ensuite, l’exemple tente deux fois de récupérer les données. Dans la première version d’évaluation, il spécifie son format sous forme de chaîne et définit le autoConvert paramètre 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, l’exemple récupère les mêmes données avec le autoConvert paramètre défini 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 nommé Form1.

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

      // Displays the string with autoConvert equal to false.
      if ( myDataObject->GetData( "System::String", false ) != nullptr )
      {
         // Displays the string in a message box.
         MessageBox::Show( myDataObject->GetData( "System::String", false ) + ".", "Message #1" );
      }
      else
            MessageBox::Show( "Could not find data of the specified format.", "Message #1" );

      // Displays a not found message in a message box.
      // Displays the string in a text box with autoConvert equal to true.
      String^ myData = "The data is " + myDataObject->GetData( "System::String", true ) + ".";
      MessageBox::Show( myData, "Message #2" );
   }
       private void GetData3() 
       {
           // Creates a new data object using a text string.
           string myString = "Hello World!";
           DataObject myDataObject = new DataObject(DataFormats.Text, myString);

           // Displays the string with autoConvert equal to false.
           if (myDataObject.GetData("System.String", false) != null) 
           {
               // Displays the string in a message box.
               MessageBox.Show(myDataObject.GetData("System.String", false).ToString() + ".", "Message #1");
           } 
           else
           {
               // Displays a not found message in a message box.
               MessageBox.Show("Could not find data of the specified format.", "Message #1");
           }

           // Displays the string in a text box with autoConvert equal to true.
           string myData = "The data is " + myDataObject.GetData("System.String", true).ToString() +".";
           MessageBox.Show(myData,"Message #2");
       }
Private Sub GetData3()
    ' Creates a new data object using a text string.
    Dim myString As String = "Hello World!"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string with autoConvert equal to false.
    If (myDataObject.GetData("System.String", False) IsNot Nothing) Then
        ' Displays the string in a message box.
        MessageBox.Show(myDataObject.GetData("System.String", False).ToString() + ".", "Message #1")
        ' Displays a not found message in a message box.
    Else
        MessageBox.Show("Could not find data of the specified format.", "Message #1")
    End If

    ' Displays the string in a text box with autoConvert equal to true.
    Dim myData As String = "The data is " + myDataObject.GetData("System.String", True).ToString()
    MessageBox.Show(myData, "Message #2")
End Sub

Remarques

Si le autoConvert paramètre est true et que cette méthode ne trouve pas de données dans le format spécifié, elle tente de convertir les données au format. Si les données ne peuvent pas être converties au format spécifié, ou si les données ont été stockées avec le autoConvert paramètre défini sur false, cette méthode retourne null.

Si le autoConvert paramètre est false, cette méthode retourne des données au format spécifié ou null si aucune donnée de ce format n’est trouvée.

Pour déterminer si les données sont associées à ou peuvent être converties dans un format, appelez GetDataPresent avant d’appeler GetData. Appelez GetFormats pour obtenir la liste des formats valides pour les données stockées dans cette instance.

Notes

Les données peuvent être converties dans un autre format si elles ont été stockées, 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 obtenir une implémentation de cette méthode, consultez DataObject.GetData.

Voir aussi

S’applique à