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)