DataObject 建構函式

定義

命名空間:: System.Windows

組件:: PresentationCore.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 DataObject 類別的新執行個體。

多載

名稱	Description
DataObject()	初始化 DataObject 類別的新執行個體。
DataObject(Object)	初始化包含指定資料的類別新實例 DataObject 。
DataObject(String, Object)	初始化包含指定資料及其相關格式的新類別實例 DataObject ;格式由字串指定。
DataObject(Type, Object)	初始化包含指定資料及其相關格式的類別新實例 DataObject ;資料格式由物件 Type 指定。
DataObject(String, Object, Boolean)	初始化包含指定資料及其相關格式的新類別實例 DataObject ;格式由字串指定。此過載包含 `Boolean` 一個旗標，指示資料在擷取時是否可轉換成其他格式。

DataObject()

初始化 DataObject 類別的新執行個體。

public:
 DataObject();

[System.Security.SecurityCritical]
public DataObject();

public DataObject();

Public Sub New ()

屬性: SecurityCriticalAttribute

適用於

DataObject(Object)

初始化包含指定資料的類別新實例 DataObject 。

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

[System.Security.SecurityCritical]
public DataObject(object data);

public DataObject(object data);

[<System.Security.SecurityCritical>]
new System.Windows.DataObject : obj -> System.Windows.DataObject

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

Public Sub New (data As Object)

參數

data: Object

一個代表要儲存在該資料物件中資料的物件。

屬性: SecurityCriticalAttribute

例外狀況

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

[System.Security.SecurityCritical]
public DataObject(string format, object data);

public DataObject(string format, object data);

[<System.Security.SecurityCritical>]
new System.Windows.DataObject : string * obj -> System.Windows.DataObject

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

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

參數

format: String

一個指定資料格式的字串。關於一組預先定義的資料格式，請參見類別 DataFormats 。

data: Object

一個代表要儲存在該資料物件中資料的物件。

屬性: SecurityCriticalAttribute

例外狀況

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

[System.Security.SecurityCritical]
public DataObject(Type format, object data);

public DataObject(Type format, object data);

[<System.Security.SecurityCritical>]
new System.Windows.DataObject : Type * obj -> System.Windows.DataObject

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

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

參數

format: Type

A Type 用來指定資料格式。關於一組預先定義的資料格式，請參見類別 DataFormats 。

data: Object

要儲存在這個資料物件裡的資料。

屬性: SecurityCriticalAttribute

例外狀況

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

[System.Security.SecurityCritical]
public DataObject(string format, object data, bool autoConvert);

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

[<System.Security.SecurityCritical>]
new System.Windows.DataObject : string * obj * bool -> System.Windows.DataObject

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 禁止資料在檢索時被轉換成其他格式。

屬性: SecurityCriticalAttribute

例外狀況

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)

適用於

意見反應

此頁面對您有幫助嗎？