DataObject Constructor (String, Object, Boolean)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Initializes a new instance of the DataObject class that contains the specified data and its associated format; the format is specified by a string. This overload includes a Boolean flag to indicate whether the data may be converted to another format on retrieval.

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

public DataObject(
	string format,
	object data,
	bool autoConvert


Type: System.String

A string that specifies the format for the data. For a set of predefined data formats, see the DataFormats class.

Type: System.Object

The data to store in this data object.

Type: System.Boolean

true to allow the data to be converted to another format on retrieval; false to prohibit the data from being converted to another format on retrieval.

Exception Condition

data or format is null.

The following example creates a new data object and uses this constructor to initialize the data object with a string and a specified data format. In this case, the data format is specified by a string; the DataFormats class provides a set of predefined type strings.

string stringData = "Some string data to store...";
string dataFormat = DataFormats.Text;
bool autoConvert = false;
DataObject dataObject = new DataObject(dataFormat, stringData, autoConvert);

The following example is a condensed version of the preceding example.

DataObject dataObject = new DataObject(DataFormats.Text, "Some string data to store...", false);

.NET Framework
Available since 3.0
Return to top