DataObject.SetData Méthode

Définition

Ajoute un objet à DataObject.Adds an object to the DataObject.

Surcharges

SetData(Object)

Ajoute l'objet spécifié au DataObject en utilisant le type d'objet comme format de données.Adds the specified object to the DataObject using the object type as the data format.

SetData(String, Object)

Ajoute l'objet spécifié au DataObject à l'aide du format spécifié.Adds the specified object to the DataObject using the specified format.

SetData(Type, Object)

Ajoute l'objet spécifié au DataObject en utilisant le type spécifié comme format.Adds the specified object to the DataObject using the specified type as the format.

SetData(String, Boolean, Object)

Ajoute l'objet spécifié au DataObject en utilisant le format spécifié et en indiquant si les données peuvent être converties dans un autre format.Adds the specified object to the DataObject using the specified format and indicating whether the data can be converted to another format.

SetData(Object)

Ajoute l'objet spécifié au DataObject en utilisant le type d'objet comme format de données.Adds the specified object to the DataObject using the object type as the data format.

public:
 virtual void SetData(System::Object ^ data);
public virtual void SetData (object data);
abstract member SetData : obj -> unit
override this.SetData : obj -> unit
Public Overridable Sub SetData (data As Object)

Paramètres

data
Object

Données à stocker.The data to store.

Implémente

Exemples

L’exemple de code suivant stocke des données dans un DataObject.The following code example stores data in a DataObject. Tout d’abord, un nouveau DataObject est créé et un composant y est stocké.First, a new DataObject is created and a component is stored in it. Ensuite, les données sont récupérées en spécifiant la classe.Then, the data is retrieved by specifying the class. Le résultat s’affiche dans une zone de texte.The result is displayed in a text box.

Ce code requiert la création de textBox1.This code requires that textBox1 has been created.

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->Name,
           " is present in the DataObject" );
      }
      else
      {
         textBox1->Text = String::Concat( "Data of type ", myType->Name,
           " 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.GetType().Name + 
       " is present in the DataObject";
    else
       textBox1.Text = "Data of type " + myType.GetType().Name +
       " 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.GetType().Name & _
            " is present in the DataObject"
    Else
        textBox1.Text = "Data of type " & myType.GetType().Name & _
            " is not present in the DataObject"
    End If
End Sub

Remarques

Important

L’appel de cette méthode avec des données non approuvées est un risque de sécurité.Calling this method with untrusted data is a security risk. Appelez cette méthode avec des données approuvées uniquement.Call this method only with trusted data. Pour plus d’informations, consultez Validation des données.For more information, see Data Validation.

Si vous ne connaissez pas le format de l’application cible, vous pouvez stocker les données dans plusieurs formats à l’aide de cette méthode.If you do not know the format of the target application, you can store data in multiple formats using this method. Les données stockées à l’aide de cette méthode peuvent être converties dans un format compatible lorsqu’elles sont récupérées.Data stored using this method can be converted to a compatible format when it is retrieved.

La surcharge SetData(Object) stocke la valeur data dans un format qu’elle détermine en appelant la méthode Object.GetType.The SetData(Object) overload stores the data value in a format that it determines by calling the Object.GetType method. Si data implémente l’interface ISerializable, cette surcharge stocke également la valeur au format de Serializable.If data implements the ISerializable interface, this overload also stores the value in the Serializable format.

Voir aussi

SetData(String, Object)

Ajoute l'objet spécifié au DataObject à l'aide du format spécifié.Adds the specified object to the DataObject using the specified format.

public:
 virtual void SetData(System::String ^ format, System::Object ^ data);
public virtual void SetData (string format, object data);
abstract member SetData : string * obj -> unit
override this.SetData : string * obj -> unit
Public Overridable Sub SetData (format As String, data As Object)

Paramètres

format
String

Format associé aux données.The format associated with the data. Consultez DataFormats pour obtenir les formats prédéfinis.See DataFormats for predefined formats.

data
Object

Données à stocker.The data to store.

Implémente

Exemples

L’exemple de code suivant stocke des données dans un DataObject, en spécifiant son format Unicode.The following code example stores data in a DataObject, specifying its format as Unicode.

Ensuite, les données sont récupérées en spécifiant le format de texte, car la valeur par défaut consiste à convertir les données lorsque le format final est compatible.Then the data is retrieved by specifying the text format, since the default is to convert the data when the final format is compatible. Le résultat s’affiche dans une zone de texte.The result is displayed in a text box.

Ce code requiert la création de textBox1.This code requires that textBox1 has been created.

private:
   void AddMyData()
   {
      // Creates a new data object using a string and the text format.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Stores a string, specifying the Unicode format.
      myDataObject->SetData( DataFormats::UnicodeText, "Text string" );
      
      // Retrieves the data by specifying Text.
      textBox1->Text = myDataObject->GetData( DataFormats::Text )->GetType()->Name;
   }
private void AddMyData() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject();
 
    // Stores a string, specifying the Unicode format.
    myDataObject.SetData(DataFormats.UnicodeText, "Text string");
 
    // Retrieves the data by specifying Text.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).GetType().Name;
 }
 
Private Sub AddMyData()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject()
    
    ' Stores a string, specifying the Unicode format.
    myDataObject.SetData(DataFormats.UnicodeText, "Text string")
    
    ' Retrieves the data by specifying Text.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).GetType().Name
End Sub

Remarques

Important

L’appel de cette méthode avec des données non approuvées est un risque de sécurité.Calling this method with untrusted data is a security risk. Appelez cette méthode avec des données approuvées uniquement.Call this method only with trusted data. Pour plus d’informations, consultez Validation des données.For more information, see Data Validation.

Si vous ne connaissez pas le format de l’application cible, vous pouvez stocker les données dans plusieurs formats à l’aide de cette méthode.If you do not know the format of the target application, you can store data in multiple formats using this method.

Les données stockées à l’aide de cette méthode peuvent être converties dans un format compatible lorsqu’elles sont récupérées.Data stored using this method can be converted to a compatible format when it is retrieved.

Voir aussi

SetData(Type, Object)

Ajoute l'objet spécifié au DataObject en utilisant le type spécifié comme format.Adds the specified object to the DataObject using the specified type as the format.

public:
 virtual void SetData(Type ^ format, System::Object ^ data);
public virtual void SetData (Type format, object data);
abstract member SetData : Type * obj -> unit
override this.SetData : Type * obj -> unit
Public Overridable Sub SetData (format As Type, data As Object)

Paramètres

format
Type

Type représentant le format associé aux données.A Type representing the format associated with the data.

data
Object

Données à stocker.The data to store.

Implémente

Exemples

L’exemple de code suivant stocke des données dans un DataObject à l’aide d’un Type comme format de données.The following code example stores data in a DataObject using a Type as the data format. Les données sont ensuite récupérées en appelant GetData à l’aide de la Type pour spécifier le format de données.The data is then retrieved by calling GetData using the Type to specify the data format. Le résultat s’affiche dans une zone de texte.The result is displayed in a text box.

Ce code requiert la création de textBox1.This code requires that textBox1 has been created.

private:
   void AddMyData2()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Gets the type of the component.
      Type^ myType = myComponent->GetType();
      
      // Creates a new data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds the component to the DataObject.
      myDataObject->SetData( myType, myComponent );
      
      // Prints whether data of the specified type is in the DataObject.
      if ( myDataObject->GetDataPresent( myType ) )
      {
         textBox1->Text = String::Concat( "Data of type ", myType->Name,
            " is present in the DataObject" );
      }
      else
      {
         textBox1->Text = String::Concat( "Data of type ", myType->Name,
           " is not present in the DataObject" );
      }
   }
private void AddMyData2() {
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Gets the type of the component.
    Type myType = myComponent.GetType();
 
    // Creates a new data object.
    DataObject myDataObject = new DataObject();
 
    // Adds the component to the DataObject.
    myDataObject.SetData(myType, myComponent);
 
    // Prints whether data of the specified type is in the DataObject.
    if(myDataObject.GetDataPresent(myType))
       textBox1.Text = "Data of type " + myType.GetType().Name + 
       " is present in the DataObject";
    else
       textBox1.Text = "Data of type " + myType.GetType().Name +
       " is not present in the DataObject";
 }
 
Private Sub AddMyData2()
    ' Creates a component to store in the data object.
    Dim myComponent As New Component()
    
    ' Gets the type of the component.
    Dim myType As Type = myComponent.GetType()
    
    ' Creates a new data object.
    Dim myDataObject As New DataObject()
    
    ' Adds the component to the DataObject.
    myDataObject.SetData(myType, myComponent)
    
    ' Prints whether data of the specified type is in the DataObject.
    If myDataObject.GetDataPresent(myType) Then
        textBox1.Text = "Data of type " & myType.GetType().Name & _
            " is present in the DataObject"
    Else
        textBox1.Text = "Data of type " & myType.GetType().Name & _
            " is not present in the DataObject"
    End If
End Sub

Remarques

Important

L’appel de cette méthode avec des données non approuvées est un risque de sécurité.Calling this method with untrusted data is a security risk. Appelez cette méthode avec des données approuvées uniquement.Call this method only with trusted data. Pour plus d’informations, consultez Validation des données.For more information, see Data Validation.

Si vous ne connaissez pas le format de l’application cible, vous pouvez stocker les données dans plusieurs formats à l’aide de cette méthode.If you do not know the format of the target application, you can store data in multiple formats using this method.

Les données stockées à l’aide de cette méthode peuvent être converties dans un format compatible lorsqu’elles sont récupérées.Data stored using this method can be converted to a compatible format when it is retrieved.

Voir aussi

SetData(String, Boolean, Object)

Ajoute l'objet spécifié au DataObject en utilisant le format spécifié et en indiquant si les données peuvent être converties dans un autre format.Adds the specified object to the DataObject using the specified format and indicating whether the data can be converted to another format.

public:
 virtual void SetData(System::String ^ format, bool autoConvert, System::Object ^ data);
public virtual void SetData (string format, bool autoConvert, object data);
abstract member SetData : string * bool * obj -> unit
override this.SetData : string * bool * obj -> unit
Public Overridable Sub SetData (format As String, autoConvert As Boolean, data As Object)

Paramètres

format
String

Format associé aux données.The format associated with the data. Consultez DataFormats pour obtenir les formats prédéfinis.See DataFormats for predefined formats.

autoConvert
Boolean

true en cas d'autorisation de conversion des données dans un autre format ; sinon false.true to allow the data to be converted to another format; otherwise, false.

data
Object

Données à stocker.The data to store.

Implémente

Exemples

L’exemple de code suivant stocke des données dans un DataObject et spécifie que les données peuvent uniquement être récupérées dans leur format natif.The following code example stores data in a DataObject and specifies that the data can only be retrieved in its native format.

Tout d’abord, un nouveau DataObject est créé.First, a new DataObject is created. Les données au format Unicode sont stockées dans le DataObject, autoConvert ayant la valeur false.Data in the Unicode format is stored in the DataObject, with autoConvert set to false.

La DataObject est ensuite interrogée pour obtenir la liste des formats de données disponibles.Then, the DataObject is queried for the list of available data formats. Seul le format Unicode est retourné, bien que les données Unicode puissent être converties en texte et dans d’autres formats.Only the Unicode format is returned, although Unicode data can be converted to text and other formats.

Ce code requiert la création de textBox1.This code requires that textBox1 has been created.

private:
   void AddMyData4()
   {
      // Creates a new data object, and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds data to the DataObject, and specifies no format conversion.
      myDataObject->SetData( DataFormats::UnicodeText, false, "My Unicode data" );
      
      // Gets the data formats in the DataObject.
      array<String^>^ arrayOfFormats = myDataObject->GetFormats();
      
      // Prints the results.
      textBox1->Text = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < arrayOfFormats->Length; i++ )
      {
         textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
      }
   }
private void AddMyData4() {
    // Creates a new data object, and assigns it the component.
    DataObject myDataObject = new DataObject();
 
    // Adds data to the DataObject, and specifies no format conversion.
    myDataObject.SetData(DataFormats.UnicodeText, false, "My Unicode data");
 
    // Gets the data formats in the DataObject.
    String[] arrayOfFormats = myDataObject.GetFormats();
 
    // Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " + '\n';
    for(int i=0; i<arrayOfFormats.Length; i++)
       textBox1.Text += arrayOfFormats[i] + '\n';
 }
 
Private Sub AddMyData4()
    ' Creates a new data object, and assigns it the component.
    Dim myDataObject As New DataObject()
    
    ' Adds data to the DataObject, and specifies no format conversion.
    myDataObject.SetData(DataFormats.UnicodeText, False, "My Unicode data")
    
    ' Gets the data formats in the DataObject.
    Dim arrayOfFormats As String() = myDataObject.GetFormats()
    
    ' Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " & ControlChars.Cr
    Dim i As Integer
    For i = 0 To arrayOfFormats.Length - 1
        textBox1.Text += arrayOfFormats(i) & ControlChars.Cr
    Next i
End Sub

Remarques

Important

L’appel de cette méthode avec des données non approuvées est un risque de sécurité.Calling this method with untrusted data is a security risk. Appelez cette méthode avec des données approuvées uniquement.Call this method only with trusted data. Pour plus d’informations, consultez Validation des données.For more information, see Data Validation.

Si vous ne connaissez pas le format de l’application cible, vous pouvez stocker les données dans plusieurs formats à l’aide de cette méthode.If you do not know the format of the target application, you can store data in multiple formats using this method.

Voir aussi

S’applique à