DataObject.GetData 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.

Retourne les données associées au format de données spécifié.

Surcharges

GetData(String, Boolean)	Retourne les données associées au format de données spécifié, grâce à un paramètre de conversion automatique permettant de déterminer si les données doivent être converties dans le format spécifié.
GetData(String)	Retourne les données associées au format de données spécifié.
GetData(Type)	Retourne les données associées au format correspondant au type classe spécifié.

GetData(String, Boolean)

Retourne les données associées au format de données spécifié, grâce à un paramètre de conversion automatique permettant de déterminer si les données doivent être converties dans le format spécifié.

public:
 virtual System::Object ^ GetData(System::String ^ format, bool autoConvert);

public virtual object GetData (string format, bool autoConvert);

public virtual object? GetData (string format, bool autoConvert);

abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj

Public Overridable 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

Object

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

Implémente

GetData(String, Boolean)

Exemples

L’exemple de code suivant récupère les données stockées dans un DataObject, à l’aide du autoConvert paramètre pour spécifier s’il faut convertir le format de données.

Tout d’abord, un nouveau DataObject est créé avec des données texte. Ensuite, l’exemple tente de récupérer les données, en spécifiant leur format sous forme de chaîne et aucune conversion de format, autrement dit, le autoConvert paramètre est false. Cette opération échoue, car il n’y a pas de données de chaîne dans .DataObject

Ensuite, l’exemple tente de récupérer à nouveau les données, avec le autoConvert paramètre défini sur true. Cette opération réussit et les résultats sont affichés dans un MessageBox.

Ce code nécessite que l’a textBox1 été créé.

private:
   void GetMyData3()
   {
      // Creates a new data object using a string and the text format.
      String^ myString = "My new text string";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );
      
      // Prints the string in a text box with autoconvert = false.
      if ( myDataObject->GetData( "System.String", false ) != 0 )
      {
         // Prints the string in a text box.
         textBox1->Text = String::Concat(
            myDataObject->GetData( "System.String", false )->ToString(), "\n" );
      }
      else
      {
         textBox1->Text = "Could not find data of the specified format\n";
      }
      
      // Prints the string in a text box with autoconvert = true.
      textBox1->Text = String::Concat(
            textBox1->Text, myDataObject->GetData( "System.String", true )->ToString() );
   }

private void GetMyData3() {
    // Creates a new data object using a string and the text format.
    string myString = "My new text string";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);
 
    // Prints the string in a text box with autoconvert = false.
    if(myDataObject.GetData("System.String", false) != null) {
       // Prints the string in a text box.
       textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
    } else
        {
            textBox1.Text = "Could not find data of the specified format" + '\n';
        }

        // Prints the string in a text box with autoconvert = true.
        textBox1.Text += myDataObject.GetData("System.String", true).ToString();
 }

Private Sub GetMyData3()
    ' Creates a new data object using a string and the text format.
    Dim myString As String = "My new text string"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)
    
    ' Prints the string in a text box with autoconvert = false.
    If (myDataObject.GetData("System.String", False) IsNot Nothing) Then
        ' Prints the string in a text box.
        textBox1.Text = myDataObject.GetData("System.String", False).ToString() & ControlChars.Cr
    Else
        textBox1.Text = "Could not find data of the specified format" & ControlChars.Cr
    End If 
    ' Prints the string in a text box with autoconvert = true.
    textBox1.Text += myDataObject.GetData("System.String", True).ToString()
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 la conversion automatique définie 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 ce DataObject.

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.

Quand format a la valeur Html, cette méthode retourne une chaîne encodée UTF-8 dans les applications qui ciblent .NET 4.5 ou version ultérieure, et une chaîne encodée ANSI dans les applications qui ciblent .NET 4.0 ou une version ultérieure.

Voir aussi

S’applique à

GetData(String)

Retourne les données associées au format de données spécifié.

public:
 virtual System::Object ^ GetData(System::String ^ format);

public virtual object GetData (string format);

public virtual object? GetData (string format);

abstract member GetData : string -> obj
override this.GetData : string -> obj

Public Overridable 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

Object

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

Implémente

GetData(String)

Exemples

L’exemple de code 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.

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

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é, ou si les données ont été stockées avec la conversion automatique définie sur false, cette méthode retourne null.

Notes

Voir aussi

S’applique à

GetData(Type)

Retourne les données associées au format correspondant au type classe spécifié.

public:
 virtual System::Object ^ GetData(Type ^ format);

public virtual object GetData (Type format);

public virtual object? GetData (Type format);

abstract member GetData : Type -> obj
override this.GetData : Type -> obj

Public Overridable Function GetData (format As Type) As Object

Paramètres

format: Type

Type représentant le format des données à récupérer.

Retours

Object

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

Implémente

GetData(Type)

Exemples

L’exemple de code suivant récupère les données stockées dans un DataObject. Tout d’abord, un nouveau DataObject est créé avec un composant. Ensuite, les données sont récupérées, en spécifiant leur type. Le type des données récupérées s’affiche dans une zone de texte.

Ce code nécessite que l’a textBox1 été créé.

private:
   void GetMyData()
   {
      // 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();
      
      // Retrieves the data using myType to represent its type.
      Object^ myObject = myDataObject->GetData( myType );
      if ( myObject != nullptr )
      {
         textBox1->Text = String::Format( "The data type stored in the DataObject is: {0}",
            myObject->GetType()->Name );
      }
      else
      {
         textBox1->Text = "Data of the specified type was not stored in the DataObject.";
      }
   }

private void GetMyData() {
    // 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();
 
    // Retrieves the data using myType to represent its type.
    Object myObject = myDataObject.GetData(myType);
    if(myObject != null)
       textBox1.Text = "The data type stored in the DataObject is: " +
       myObject.GetType().Name;
    else
       textBox1.Text = "Data of the specified type was not stored " +
       "in the DataObject.";
 }

Private Sub GetMyData()
    ' Creates a component to store in the data object.
    Dim myComponent As New 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()
    
    ' Retrieves the data using myType to represent its type.
    Dim myObject As Object = myDataObject.GetData(myType)
    If (myObject IsNot Nothing) Then
        textBox1.Text = "The data type stored in the DataObject is: " & myObject.GetType().Name
    Else
        textBox1.Text = "Data of the specified type was not stored " & "in the DataObject."
    End If
End Sub

Remarques

Notes

Voir aussi

S’applique à

Partager via

DataObject.GetData Méthode

Définition

Surcharges

GetData(String, Boolean)

Paramètres

Retours

Implémente

Exemples

Remarques

Voir aussi

S’applique à

GetData(String)

Paramètres

Retours

Implémente

Exemples

Remarques

Voir aussi

S’applique à

GetData(Type)

Paramètres

Retours

Implémente

Exemples

Remarques

Voir aussi

S’applique à

Ressources supplémentaires