IDataObject.GetData Méthode

Définition

Récupère les données associées au format de données spécifié.Retrieves the data associated with the specified data format.

Surcharges

GetData(String)

Récupère les données associées au format de données spécifié.Retrieves the data associated with the specified data format.

GetData(Type)

Récupère les données associées au format du type classe spécifié.Retrieves the data associated with the specified class type format.

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é.Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

GetData(String)

Récupère les données associées au format de données spécifié.Retrieves the data associated with the specified data format.

public:
 System::Object ^ GetData(System::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.The format of the data to retrieve. Consultez DataFormats pour obtenir les formats prédéfinis.See DataFormats for predefined formats.

Retours

Données associées au format spécifié ou null.The data associated with the specified format, or null.

Exemples

Cet exemple utilise la DataObject classe, qui IDataObject, implémente pour illustrer l’utilisation de GetData la méthode.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. La méthode est utilisée pour récupérer les données stockées dans myDataObject, qui est associé Text au format.The method is used to retrieve the data stored in myDataObject, which is associated with the Text format. L’exemple suppose que vous avez déjà créé Form un nommé Form1 et un TextBox nommé textBox1.The example assumes that you have already created a Form named Form1 and a TextBox named 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 peut pas trouver de données au format spécifié, elle tente de convertir les données au format.If this method cannot find data in the specified format, it attempts to convert the data to the format. Si les données ne peuvent pas être converties au format spécifié, nullcette méthode retourne.If the data cannot be converted to the specified format, this method returns null.

Pour déterminer si les données sont associées ou peuvent être converties en un format, appelez GetDataPresent avant d' GetDataappeler.To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. Appelez GetFormats pour obtenir une liste de formats valides pour les données stockées dans cette instance.Call GetFormats for a list of valid formats for the data stored in this instance.

Notes

Les données peuvent être converties dans un autre format s’il a été stocké, ce qui spécifie que la conversion est autorisée et si le format demandé est compatible avec le format stocké.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Par exemple, les données stockées au format Unicode peuvent être converties en texte.For example, data stored as Unicode can be converted to text.

Pour une implémentation de cette méthode, consultez DataObject.GetData.For an implementation of this method, see DataObject.GetData.

Voir aussi

GetData(Type)

Récupère les données associées au format du type classe spécifié.Retrieves the data associated with the specified class type format.

public:
 System::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.A Type representing the format of the data to retrieve. Consultez DataFormats pour obtenir les formats prédéfinis.See DataFormats for predefined formats.

Retours

Données associées au format spécifié ou null.The data associated with the specified format, or null.

Exemples

Cet exemple utilise la DataObject classe, qui IDataObjectimplémente, pour illustrer l’utilisation de GetData la méthode.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. La méthode est utilisée pour récupérer les données stockées dans myObject, qui est associé à un type spécifique, myType.The method is used to retrieve the data stored in myObject, which is associated with a specific type, myType. Le type des données récupérées s’affiche dans une boîte de message.The type of the retrieved data is displayed in a message box. L’exemple suppose que vous avez déjà créé un Form nommé. Form1The example assumes that you have already created a Form named 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 peut pas trouver de données au format spécifié, elle tente de convertir les données au format.If this method cannot find data in the specified format, it attempts to convert the data to the format. Si les données ne peuvent pas être converties au format spécifié, nullcette méthode retourne.If the data cannot be converted to the specified format, this method returns null.

Pour déterminer si les données sont associées ou peuvent être converties en un format, appelez GetDataPresent avant d' GetDataappeler.To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. Appelez GetFormats pour obtenir une liste de formats valides pour les données stockées dans cette instance.Call GetFormats for a list of valid formats for the data stored in this instance.

Notes

Les données peuvent être converties dans un autre format s’il a été stocké, ce qui spécifie que la conversion est autorisée et si le format demandé est compatible avec le format stocké.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Par exemple, les données stockées au format Unicode peuvent être converties en texte.For example, data stored as Unicode can be converted to text.

Pour une implémentation de cette méthode, consultez DataObject.GetData.For an implementation of this method, see DataObject.GetData.

Voir aussi

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é.Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

public:
 System::Object ^ GetData(System::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.The format of the data to retrieve. Consultez DataFormats pour obtenir les formats prédéfinis.See DataFormats for predefined formats.

autoConvert
Boolean

true en cas de conversion des données dans le format spécifié ; sinon false.true to convert the data to the specified format; otherwise, false.

Retours

Données associées au format spécifié ou null.The data associated with the specified format, or null.

Exemples

Cet exemple utilise la DataObject classe, qui IDataObjectimplémente, pour illustrer l’utilisation de GetData la méthode.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. 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 des données.The example retrieves the data stored in a DataObject, using the autoConvert parameter to specify whether or not to convert the data format. Tout d' myDataObject abord, est créé avec des données texte.First, myDataObject is created with text data. L’exemple essaie ensuite de récupérer deux fois les données.Then the example tries twice to retrieve the data. Dans le premier essai, il spécifie son format sous forme de chaîne et autoConvert définit le falseparamètre sur.In the first trial, it specifies its format as a string and sets the autoConvert parameter to false. Cette version d’évaluation échoue et le résultat s’affiche dans une boîte de message intitulée «message #1».This trial fails, and the result is displayed in a message box labeled "Message #1." Dans la deuxième version d’évaluation, l’exemple récupère les mêmes données avec autoConvert le paramètre défini truesur.In the second trial, the example retrieves the same data with the autoConvert parameter set to true. Cette version d’évaluation aboutit et le résultat s’affiche dans une boîte de message intitulée «message #2».This trial succeeds, and the result is displayed in a message box labeled "Message #2." L’exemple suppose que vous avez créé un Form nommé. Form1The example assumes that you have created a Form named 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 a true la valeur et que cette méthode ne peut pas trouver de données au format spécifié, elle tente de convertir les données au format.If the autoConvert parameter is true and this method cannot find data in the specified format, it attempts to convert the data to the format. Si les données ne peuvent pas être converties au format spécifié, ou si les données ont autoConvert été stockées avec falsele paramètre ayant la nullvaleur, cette méthode retourne.If the data cannot be converted to the specified format, or if the data was stored with the autoConvert parameter set to false, this method returns null.

Si le autoConvert paramètre a falsela valeur, cette méthode retourne les données au format spécifié null , ou si aucune donnée n’est disponible dans ce format.If the autoConvert parameter is false, this method returns data in the specified format, or null if no data in this format can be found.

Pour déterminer si les données sont associées ou peuvent être converties en un format, appelez GetDataPresent avant d' GetDataappeler.To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. Appelez GetFormats pour obtenir une liste de formats valides pour les données stockées dans cette instance.Call GetFormats for a list of valid formats for the data stored in this instance.

Notes

Les données peuvent être converties dans un autre format s’il a été stocké, ce qui spécifie que la conversion est autorisée et si le format demandé est compatible avec le format stocké.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Par exemple, les données stockées au format Unicode peuvent être converties en texte.For example, data stored as Unicode can be converted to text.

Pour une implémentation de cette méthode, consultez DataObject.GetData.For an implementation of this method, see DataObject.GetData.

Voir aussi

S’applique à