IDataObject.GetDataPresent 方法

定義

命名空間:

System.Windows

組件:

PresentationCore.dll

檢查資料是否以指定的格式儲存，或是否可轉換成指定的格式。

多載

GetDataPresent(String)	檢查以確定資料是否可為指定的格式，或資料是否可轉換成指定的格式，資料格式由字串指定。
GetDataPresent(Type)	檢查資料是否以指定的格式儲存，或是否可轉換成指定的格式。 資料格式由 Type 物件指定。
GetDataPresent(String, Boolean)	檢查資料是否以指定的格式儲存，或是否可轉換成指定的格式。 Boolean 旗標表示當資料不是指定格式時，是否檢查該資料能否轉換成指定的格式。

備註

呼叫 GetDataPresent ，在呼叫 GetData 之前，先判斷這個資料物件中是否有指定的格式可用。

呼叫 GetFormats 以取得此資料物件中可用之所有格式的清單。

GetDataPresent(String)

檢查以確定資料是否可為指定的格式，或資料是否可轉換成指定的格式，資料格式由字串指定。

public:
 bool GetDataPresent(System::String ^ format);

[System.Security.SecurityCritical]
public bool GetDataPresent (string format);

public bool GetDataPresent (string format);

[<System.Security.SecurityCritical>]
abstract member GetDataPresent : string -> bool

abstract member GetDataPresent : string -> bool

Public Function GetDataPresent (format As String) As Boolean

參數

format

String

字串，指定要檢查的格式。 如需一組預先定義的資料格式，請參閱 DataFormats 類別。

傳回

Boolean

如果資料在指定的格式中，或是可以轉換成指定的格式，則為 true；否則為 false。

屬性

SecurityCriticalAttribute

備註

如需此方法的實作，請參閱 GetDataPresent 。

呼叫 GetDataPresent ，在呼叫 GetData 之前，先判斷這個資料物件中是否有指定的格式可用。

呼叫 GetFormats 以取得此資料物件中可用之所有格式的清單。

另請參閱

• 載入已卸載的檔案範例

GetDataPresent(Type)

檢查資料是否以指定的格式儲存，或是否可轉換成指定的格式。 資料格式由 Type 物件指定。

public:
 bool GetDataPresent(Type ^ format);

[System.Security.SecurityCritical]
public bool GetDataPresent (Type format);

public bool GetDataPresent (Type format);

[<System.Security.SecurityCritical>]
abstract member GetDataPresent : Type -> bool

abstract member GetDataPresent : Type -> bool

Public Function GetDataPresent (format As Type) As Boolean

參數

format

Type

Type，指定要檢查的格式。 如需一組預先定義的資料格式，請參閱 DataFormats 類別。

傳回

Boolean

如果資料在指定的格式中，或是可以轉換成指定的格式，則為 true；否則為 false。

屬性

SecurityCriticalAttribute

備註

針對這個方法的實作，為 GetDataPresent 。

呼叫 GetDataPresent ，在呼叫 GetData 之前，先判斷這個資料物件中是否有指定的格式可用。

呼叫 GetFormats 以取得此資料物件中可用之所有格式的清單。

另請參閱

• 載入已卸載的檔案範例

GetDataPresent(String, Boolean)

檢查資料是否以指定的格式儲存，或是否可轉換成指定的格式。 Boolean 旗標表示當資料不是指定格式時，是否檢查該資料能否轉換成指定的格式。

public:
 bool GetDataPresent(System::String ^ format, bool autoConvert);

[System.Security.SecurityCritical]
public bool GetDataPresent (string format, bool autoConvert);

public bool GetDataPresent (string format, bool autoConvert);

[<System.Security.SecurityCritical>]
abstract member GetDataPresent : string * bool -> bool

abstract member GetDataPresent : string * bool -> bool

Public Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean

參數

format

String

字串，指定要檢查的格式。 如需一組預先定義的資料格式，請參閱 DataFormats 類別。

autoConvert

Boolean

false 表示只檢查指定的格式，true 表示同時檢查這個資料物件中所儲存的資料是否可轉換成指定的格式。

傳回

Boolean

如果資料在指定的格式中，或是可以轉換成指定的格式，則為 true；否則為 false。

屬性

SecurityCriticalAttribute

備註

如需此方法的實作，請參閱 GetDataPresent 。

呼叫 GetDataPresent ，在呼叫 GetData 之前，先判斷這個資料物件中是否有指定的格式可用。

呼叫 GetFormats 以取得此資料物件中可用之所有格式的清單。

這個方法會在下列情況下傳 true 回：

• autoConvert 參數為 true ，且資料格式為指定格式，或可轉換成指定的格式。

• autoConvert 參數為 false ，且資料的格式為指定的。

這個方法會在下列情況下傳 false 回：

• autoConvert 參數為 true ，而且資料無法使用指定的格式，而且無法轉換成指定的格式。

• autoConvert 參數為 false ，而且資料無法使用指定的格式。

另請參閱

• 載入已卸載的檔案範例