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

指定資料格式的 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)

適用於