IDataObject.SetData Método

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Almacena en esta instancia los datos especificados y el formato asociado a estos datos.

Sobrecargas

SetData(Object)	Almacena los datos especificados en esta instancia utilizando la clase de los datos para el formato.
SetData(String, Object)	Almacena en esta instancia los datos especificados y el formato asociado a estos datos.
SetData(Type, Object)	Almacena en esta instancia los datos especificados y el tipo de clase asociado a estos datos.
SetData(String, Boolean, Object)	Almacena los datos especificados y el formato que tienen asociado en esta instancia, usando un valor de tipo booleano para indicar si pueden convertirse los datos a otro formato.

SetData(Object)

Almacena los datos especificados en esta instancia utilizando la clase de los datos para el formato.

public:
 void SetData(System::Object ^ data);

public void SetData (object data);

public void SetData (object? data);

abstract member SetData : obj -> unit

Public Sub SetData (data As Object)

Parámetros

data: Object

Datos que se van a almacenar.

Ejemplos

En este ejemplo se usa la DataObject clase , que implementa IDataObject, para mostrar el uso del SetData método . En primer lugar, crea un componente (myComponent) y lo almacena en un objeto de datos (myDataObject). A continuación, comprueba si los datos especificados se almacenan en el objeto de datos y muestra el resultado en un cuadro de mensaje. En el ejemplo se supone que ha creado un Form denominado Form1.

private:
   void SetData1()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds the component to the data object.
      myDataObject->SetData( myComponent );
      
      // Checks whether data of the specified type is in the data object.
      Type^ myType = myComponent->GetType();
      String^ myMessageText;
      if ( myDataObject->GetDataPresent( myType ) )
      {
         myMessageText = "Data of type " + myType->Name +
            " is present in the data object";
      }
      else
      {
         myMessageText = "Data of type " + myType->Name +
            " is not present in the data object";
      }
      
      // Displays the result in a message box.
      MessageBox::Show( myMessageText, "The Test Result" );
   }

private void SetData1() 
{
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Creates a data object.
    DataObject myDataObject = new DataObject();

    // Adds the component to the data object.
    myDataObject.SetData(myComponent);
 
    // Checks whether data of the specified type is in the data object.
    Type myType = myComponent.GetType();
    string myMessageText;
    if(myDataObject.GetDataPresent(myType))
         myMessageText = "Data of type " + myType.Name + 
            " is present in the data object";
    else
        myMessageText = "Data of type " + myType.Name +
            " is not present in the data object";

    // Displays the result in a message box.
    MessageBox.Show(myMessageText, "The Test Result"); 
}

Private Sub SetData1()
   ' Creates a component to store in the data object.
   Dim myComponent As New System.ComponentModel.Component()
   
   ' Creates a data object.
   Dim myDataObject As New DataObject()
   
   ' Adds the component to the data object.
   myDataObject.SetData(myComponent)
   
   ' Checks whether data of the specified type is in the data object.
   Dim myType As Type = myComponent.GetType()
   Dim myMessageText As String
   If myDataObject.GetDataPresent(myType) Then
      myMessageText = "Data of type " + myType.Name + " is present in the data object"
   Else
      myMessageText = "Data of type " + myType.Name + " is not present in the data object"
   End If

   ' Displays the result in a message box.
   MessageBox.Show(myMessageText, "The Test Result")
End Sub

Comentarios

El formato se deriva de la clase de datos.

Los datos almacenados con este método se pueden convertir a un formato compatible cuando se recuperan.

Para obtener una implementación de este método, vea DataObject.SetData.

Consulte también

Se aplica a

SetData(String, Object)

Almacena en esta instancia los datos especificados y el formato asociado a estos datos.

public:
 void SetData(System::String ^ format, System::Object ^ data);

public void SetData (string format, object data);

public void SetData (string format, object? data);

abstract member SetData : string * obj -> unit

Public Sub SetData (format As String, data As Object)

Parámetros

format: String

Formato asociado a los datos. Vea DataFormats para obtener los formatos predefinidos.

data: Object

Datos que se van a almacenar.

Ejemplos

En este ejemplo se usa la DataObject clase , que implementa IDataObject, para mostrar el uso del SetData método . En primer lugar, crea un objeto de datos (myDataObject) y almacena una cadena en el objeto que especifica el UnicodeText formato. A continuación, recupera los datos almacenados en el objeto que especifican el Text formato para que los datos se conviertan al Text formato . El resultado se muestra en un cuadro de mensaje. En este ejemplo se supone que ha creado un Form denominado Form1.

private:
   void SetData2()
   {
      // Creates a data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Stores a string, specifying the UnicodeText format.
      myDataObject->SetData( DataFormats::UnicodeText, "Hello World!" );
      
      // Retrieves the data by specifying the Text format.
      String^ myMessageText = "The data type is " +
         myDataObject->GetData( DataFormats::Text )->GetType()->Name;
      
      // Displays the result.
      MessageBox::Show( myMessageText, "The Test Result" );
   }

private void SetData2() 
{
    // Creates a data object.
    DataObject myDataObject = new DataObject();
 
    // Stores a string, specifying the UnicodeText format.
    myDataObject.SetData(DataFormats.UnicodeText, "Hello World!");
 
    // Retrieves the data by specifying the Text format.
    string myMessageText = "The data type is " + myDataObject.GetData(DataFormats.Text).GetType().Name;

    // Displays the result.
    MessageBox.Show(myMessageText, "The Test Result");
}

Private Sub SetData2()
   ' Creates a data object.
   Dim myDataObject As New DataObject()
   
   ' Stores a string, specifying the UnicodeText format.
   myDataObject.SetData(DataFormats.UnicodeText, "Hello World!")
   
   ' Retrieves the data by specifying the Text format.
   Dim myMessageText As String = "The data type is " & _
             myDataObject.GetData(DataFormats.Text).GetType().Name
   
   ' Displays the result.
   MessageBox.Show(myMessageText, "The Test Result")
End Sub

Comentarios

Si no conoce el formato de la aplicación de destino, puede almacenar datos en varios formatos mediante este método.

Los datos almacenados con este método se pueden convertir a un formato compatible cuando se recuperan.

Para obtener una implementación de este método, vea DataObject.SetData.

Consulte también

Se aplica a

SetData(Type, Object)

Almacena en esta instancia los datos especificados y el tipo de clase asociado a estos datos.

public:
 void SetData(Type ^ format, System::Object ^ data);

public void SetData (Type format, object data);

public void SetData (Type format, object? data);

abstract member SetData : Type * obj -> unit

Public Sub SetData (format As Type, data As Object)

Parámetros

format: Type

Type que representa el formato asociado a los datos. Vea DataFormats para obtener los formatos predefinidos.

data: Object

Datos que se van a almacenar.

Ejemplos

En este ejemplo se usa la DataObject clase , que implementa IDataObject, para mostrar el uso del SetData método . En primer lugar, crea un componente (myComponent) y lo almacena en un objeto de datos (myDataObject), utilizando myType para especificar el formato de datos. A continuación, comprueba si los datos del tipo especificado se almacenan en el objeto y muestran el resultado en un cuadro de mensaje. En el ejemplo se supone que ha creado un Form denominado Form1.

private:
   void SetData3()
   {
      // Creates a component.
      Component^ myComponent = gcnew Component;
      
      // Gets the type of the component.
      Type^ myType = myComponent->GetType();
      
      // Creates a data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Stores the component in the data object.
      myDataObject->SetData( myType, myComponent );
      
      // Checks whether data of the specified type is in the data object.
      String^ myMessageText;
      if ( myDataObject->GetDataPresent( myType ) )
      {
         myMessageText = "Data of type " + myType->Name +
            " is stored in the data object";
      }
      else
      {
         myMessageText = "No data of type " + myType->Name +
            " is stored in the data object";
      }
      
      // Displays the result.
      MessageBox::Show( myMessageText, "The Test Result" );
   }

private void SetData3() 
{
    // Creates a component.
    Component myComponent = new Component();
 
    // Gets the type of the component.
    Type myType = myComponent.GetType();
 
    // Creates a data object.
    DataObject myDataObject = new DataObject();
 
    // Stores the component in the data object.
    myDataObject.SetData(myType, myComponent);
 
    // Checks whether data of the specified type is in the data object.
    string myMessageText;
    if(myDataObject.GetDataPresent(myType))
        myMessageText = "Data of type " + myType.Name + 
            " is stored in the data object";
    else
        myMessageText = "No data of type " + myType.Name +
            " is stored in the data object";
            
    // Displays the result.
    MessageBox.Show(myMessageText, "The Test Result");
}

Private Sub SetData3()
   ' Creates a component.
   Dim myComponent As New System.ComponentModel.Component()
   
   ' Gets the type of the component.
   Dim myType As Type = myComponent.GetType()
   
   ' Creates a data object.
   Dim myDataObject As New DataObject()
   
   ' Stores the component in the data object.
   myDataObject.SetData(myType, myComponent)
   
   ' Checks whether data of the specified type is in the data object.
   Dim myMessageText As String
   If myDataObject.GetDataPresent(myType) Then
      myMessageText = "Data of type " & myType.Name & " is stored in the data object"
   Else
      myMessageText = "No data of type " & myType.Name & " is stored in the data object"
   End If
   
   ' Displays the result.
   MessageBox.Show(myMessageText, "The Test Result")
End Sub

Comentarios

Si no conoce el formato de la aplicación de destino, puede almacenar datos en varios formatos mediante este método.

Los datos almacenados con este método se pueden convertir a un formato compatible cuando se recuperan.

Para obtener una implementación de este método, vea DataObject.SetData.

Consulte también

Se aplica a

SetData(String, Boolean, Object)

Almacena los datos especificados y el formato que tienen asociado en esta instancia, usando un valor de tipo booleano para indicar si pueden convertirse los datos a otro formato.

public:
 void SetData(System::String ^ format, bool autoConvert, System::Object ^ data);

public void SetData (string format, bool autoConvert, object data);

public void SetData (string format, bool autoConvert, object? data);

abstract member SetData : string * bool * obj -> unit

Public Sub SetData (format As String, autoConvert As Boolean, data As Object)

Parámetros

format: String

Formato asociado a los datos. Vea DataFormats para obtener los formatos predefinidos.

autoConvert: Boolean

true para permitir la conversión de los datos a otros formatos; en cualquier otro caso, false.

data: Object

Datos que se van a almacenar.

Ejemplos

En este ejemplo se usa la DataObject clase , que implementa IDataObject, para mostrar el uso del SetData método . En primer lugar, crea un objeto de datos (myDataObject) y almacena una UnicodeText cadena en él, con el autoConvert parámetro establecido falseen . A continuación, recupera los formatos asociados a los datos almacenados en el objeto y muestra el resultado en un cuadro de mensaje. El único formato asociado a los datos es el UnicodeText formato. En este ejemplo se supone que ha creado un Form denominado Form1.

private:
   void SetData4()
   {
      // Creates a new data object.
      DataObject^ myDataObject = gcnew DataObject;

      // Adds UnicodeText string to the object, and set the autoConvert
      // parameter to false.
      myDataObject->SetData( DataFormats::UnicodeText, false, "My text String*" );

      // Gets the data format(s) in the data object.
      array<String^>^arrayOfFormats = myDataObject->GetFormats();

      // Stores the results in a string.
      String^ theResult = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < arrayOfFormats->Length; i++ )
         theResult = theResult + arrayOfFormats[ i ], " \n";

      // Show the results in a message box.
      MessageBox::Show( theResult );
   }

       private void SetData4() 
       {
           // Creates a new data object.
           DataObject myDataObject = new DataObject();

           // Adds UnicodeText string to the object, and set the autoConvert 
           // parameter to false.
           myDataObject.SetData(DataFormats.UnicodeText, false, "My text string");

           // Gets the data format(s) in the data object.
           String[] arrayOfFormats = myDataObject.GetFormats();

           // Stores the results in a string.
           string theResult = "The format(s) associated with the data are:" + '\n';
           for(int i=0; i<arrayOfFormats.Length; i++)
               theResult += arrayOfFormats[i] + '\n';
           
           // Show the results in a message box. 
           MessageBox.Show(theResult);
       }

Private Sub SetData4()
    ' Creates a new data object.
    Dim myDataObject As New DataObject()

    ' Adds UnicodeText string to the object, and set the autoConvert
    ' parameter to false.
    myDataObject.SetData(DataFormats.UnicodeText, False, "My text string")

    ' Gets the data format(s) in the data object.
    Dim arrayOfFormats As [String]() = myDataObject.GetFormats()

    ' Stores the results in a string.
    Dim theResult As String = "The format(s) associated with the data are:" + _
            ControlChars.Cr
    Dim i As Integer
    For i = 0 To arrayOfFormats.Length - 1
        theResult += arrayOfFormats(i) + ControlChars.Cr
    Next i
    ' Show the results in a message box. 
    MessageBox.Show(theResult)
End Sub

Comentarios

Si no conoce el formato de la aplicación de destino, puede almacenar datos en varios formatos mediante este método.

Para obtener una implementación de este método, vea DataObject.SetData.

Consulte también

Se aplica a

Compartir vía

IDataObject.SetData Método

Definición

Sobrecargas

SetData(Object)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

SetData(String, Object)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

SetData(Type, Object)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

SetData(String, Boolean, Object)

Parámetros

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionales