DataObject Constructors

Definition

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Initializes a new instance of the DataObject class.

Overloads

DataObject()	Initializes a new instance of the DataObject class.
DataObject(Object)	Initializes a new instance of the DataObject class that contains the specified data.
DataObject(String, Object)	Initializes a new instance of the DataObject class that contains the specified data and its associated format; the format is specified by a string.
DataObject(Type, Object)	Initializes a new instance of the DataObject class that contains the specified data and its associated format; the data format is specified by a Type object.
DataObject(String, Object, Boolean)	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.

DataObject()

Initializes a new instance of the DataObject class.

public:
 DataObject();

public DataObject ();

Public Sub New ()

DataObject(Object)

Initializes a new instance of the DataObject class that contains the specified data.

public:
 DataObject(System::Object ^ data);

public DataObject (object data);

new System.Windows.DataObject : obj -> System.Windows.DataObject

Public Sub New (data As Object)

Parameters

data

Object

An object that represents the data to store in this data object.

Exceptions

ArgumentNullException

data is null.

ArgumentOutOfRangeException

data references a DataObject object.

Examples

The following example creates a new data object and uses this constructor to initialize the data object with a string. In this case, an appropriate data format is determined automatically according to the stored data's type, and auto-converting of the stored data is allowed by default.

string stringData = "Some string data to store...";
DataObject dataObject = new DataObject(stringData);

Dim stringData As String = "Some string data to store..."
Dim dataObject As New DataObject(stringData)

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

DataObject dataObject = new DataObject("Some string data to store...");

Dim dataObject As New DataObject("Some string data to store...")

DataObject(String, Object)

Initializes a new instance of the DataObject class that contains the specified data and its associated format; the format is specified by a string.

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

public DataObject (string format, object data);

new System.Windows.DataObject : string * obj -> System.Windows.DataObject

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

Parameters

format

String

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

data

Object

An object that represents the data to store in this data object.

Exceptions

ArgumentNullException

data or format is null.

Examples

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. Auto-converting of the stored data is allowed by default.

string stringData = "Some string data to store...";
string dataFormat = DataFormats.UnicodeText;
DataObject dataObject = new DataObject(dataFormat, stringData);

Dim stringData As String = "Some string data to store..."
Dim dataFormat As String = DataFormats.UnicodeText
Dim dataObject As New DataObject(dataFormat, stringData)

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

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

Dim dataObject As New DataObject(DataFormats.UnicodeText, "Some string data to store...")

DataObject(Type, Object)

Initializes a new instance of the DataObject class that contains the specified data and its associated format; the data format is specified by a Type object.

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

public DataObject (Type format, object data);

new System.Windows.DataObject : Type * obj -> System.Windows.DataObject

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

Parameters

format

Type

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

data

Object

The data to store in this data object.

Exceptions

ArgumentNullException

data or format is null.

Examples

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 Type parameter. Auto-converting of the stored data is allowed by default.

string stringData = "Some string data to store...";
Type dataFormat = stringData.GetType();
DataObject dataObject = new DataObject(dataFormat, stringData);

Dim stringData As String = "Some string data to store..."
Dim dataFormat As Type = stringData.GetType()
Dim dataObject As New DataObject(dataFormat, stringData)

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

DataObject dataObject = new DataObject("".GetType(), "Some string data to store...");

Dim dataObject As New DataObject("".GetType(), "Some string data to store...")

DataObject(String, Object, Boolean)

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.

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

public DataObject (string format, object data, bool autoConvert);

new System.Windows.DataObject : string * obj * bool -> System.Windows.DataObject

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

Parameters

format

String

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

data

Object

The data to store in this data object.

autoConvert

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.

Exceptions

ArgumentNullException

data or format is null.

Examples

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);

Dim stringData As String = "Some string data to store..."
Dim dataFormat As String = DataFormats.Text
Dim autoConvert As Boolean = False
Dim dataObject As 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);

Dim dataObject As New DataObject(DataFormats.Text, "Some string data to store...", False)