This documentation is archived and is not being maintained.

DataObject.SetData Method (Type, Object)

Adds the specified object to the DataObject using the specified type as the format.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public virtual void SetData(
	Type format,
	Object data


Type: System.Type
A Type representing the format associated with the data.
Type: System.Object
The data to store.


IDataObject.SetData(Type, Object)

If you do not know the format of the target application, you can store data in multiple formats using this method.

Data stored using this method can be converted to a compatible format when it is retrieved.

The following code example stores data in a DataObject using a Type as the data format. The data is then retrieved by calling GetData using the Type to specify the data format. The result is displayed in a text box.

This code requires that textBox1 has been created.

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.
       textBox1.Text = "Data of type " + myType.GetType().Name + 
       " is present in the DataObject";
       textBox1.Text = "Data of type " + myType.GetType().Name +
       " is not present in the DataObject";

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.