DataObject 构造函数

定义

命名空间:

System.Windows

程序集:

PresentationCore.dll

初始化 DataObject 类的新实例。

重载

DataObject()	初始化 DataObject 类的新实例。
DataObject(Object)	初始化包含指定数据的 DataObject 类的新实例。
DataObject(String, Object)	初始化 DataObject 类的新实例，该类包含指定数据及其关联格式；格式由字符串指定。
DataObject(Type, Object)	初始化 DataObject 类的新实例，该类包含指定数据及其关联格式；数据格式由 Type 对象指定。
DataObject(String, Object, Boolean)	初始化 DataObject 类的新实例，该类包含指定数据及其关联格式；格式由字符串指定。 此重载包含一个 Boolean 标志，用于指示是否可在检索时将数据转换为其他格式。

DataObject()

初始化 DataObject 类的新实例。

public:
 DataObject();

public DataObject ();

Public Sub New ()

DataObject(Object)

初始化包含指定数据的 DataObject 类的新实例。

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

public DataObject (object data);

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

Public Sub New (data As Object)

参数

data

Object

一个对象，表示要在此数据对象中存储的数据。

例外

ArgumentNullException

data 为 null。

ArgumentOutOfRangeException

data 引用 DataObject 对象。

示例

以下示例创建新的数据对象，并使用此构造函数用字符串初始化数据对象。 在这种情况下，根据存储的数据类型自动确定适当的数据格式，默认情况下允许自动转换存储的数据。

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)

以下示例是上一个示例的精简版本。

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

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

DataObject(String, Object)

初始化 DataObject 类的新实例，该类包含指定数据及其关联格式；格式由字符串指定。

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)

参数

format

String

一个指定数据格式的字符串。 有关预定义数据格式集，请参阅 DataFormats 类。

data

Object

一个对象，表示要在此数据对象中存储的数据。

例外

ArgumentNullException

data 或 format 为 null。

示例

以下示例创建新的数据对象，并使用此构造函数通过字符串和指定的数据格式初始化数据对象。 在本例中，数据格式由字符串指定;类 DataFormats 提供一组预定义的类型字符串。 默认情况下，允许自动转换存储的数据。

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)

以下示例是上一个示例的精简版本。

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)

初始化 DataObject 类的新实例，该类包含指定数据及其关联格式；数据格式由 Type 对象指定。

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)

参数

format

Type

一个 Type，指定数据的格式。 有关预定义数据格式集，请参阅 DataFormats 类。

data

Object

要在此数据对象中存储的数据。

例外

ArgumentNullException

data 或 format 为 null。

示例

以下示例创建新的数据对象，并使用此构造函数通过字符串和指定的数据格式初始化数据对象。 在这种情况下，数据格式由 Type 参数指定。 默认情况下，允许自动转换存储的数据。

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)

以下示例是上一个示例的精简版本。

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)

初始化 DataObject 类的新实例，该类包含指定数据及其关联格式；格式由字符串指定。 此重载包含一个 Boolean 标志，用于指示是否可在检索时将数据转换为其他格式。

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)

参数

format

String

一个指定数据格式的字符串。 有关预定义数据格式集，请参阅 DataFormats 类。

data

Object

要在此数据对象中存储的数据。

autoConvert

Boolean

如果允许在检索时将数据转换为其他格式，则为 true；如果禁止在检索时将数据转换为其他格式，则为 false。

例外

ArgumentNullException

data 或 format 为 null。

示例

以下示例创建新的数据对象，并使用此构造函数通过字符串和指定的数据格式初始化数据对象。 在本例中，数据格式由字符串指定;类 DataFormats 提供一组预定义的类型字符串。

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)

以下示例是前面示例的精简版本。

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)