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)