DataObject.GetDataPresent 方法

參考

定義

命名空間:: System.Windows

組件:: PresentationCore.dll

重要

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

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

多載

GetDataPresent(String)	判斷資料是否以字串指定的格式儲存，或是否可轉換成該格式。
GetDataPresent(Type)	判斷資料是否可以使用 Type 物件所指定的格式，或是否可轉換成該格式。
GetDataPresent(String, Boolean)	判斷資料是否以指定的格式儲存，或是否可轉換成指定的格式。 `Boolean` 旗標表示如果資料無法使用指定的格式，是否檢查該資料能否轉換為該格式。

備註

呼叫 GetDataPresent 以判斷這個資料物件中是否有格式可用，然後再呼叫 GetData 。呼叫 GetFormats 以取得此資料物件中所有可用格式的清單。

GetDataPresent(String)

判斷資料是否以字串指定的格式儲存，或是否可轉換成該格式。

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

public bool GetDataPresent (string format);

abstract member GetDataPresent : string -> bool
override this.GetDataPresent : string -> bool

Public Function GetDataPresent (format As String) As Boolean

參數

format: String

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

傳回

Boolean

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

實作

GetDataPresent(String)

例外狀況

ArgumentNullException

format 為 null。

範例

下列範例會使用這個方法來查詢描述元字串是否有特定資料格式。

DataObject dataObject = new DataObject("Some string data to store...");

// Query for the presence of Text data in the data object, by a data format descriptor string.
// In this overload of GetDataPresent, the method will return true both for native data formats
// and when the data can automatically be converted to the specifed format.

// In this case, string data is present natively, so GetDataPresent returns "true".
string textData = null;
if (dataObject.GetDataPresent(DataFormats.StringFormat))
{
    textData = dataObject.GetData(DataFormats.StringFormat) as string;
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, so GetDataPresent returns "true".
byte[] unicodeData = null;
if (dataObject.GetDataPresent(DataFormats.UnicodeText))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}

Dim dataObject As New DataObject("Some string data to store...")

' Query for the presence of Text data in the data object, by a data format descriptor string.
' In this overload of GetDataPresent, the method will return true both for native data formats
' and when the data can automatically be converted to the specifed format.

' In this case, string data is present natively, so GetDataPresent returns "true".
Dim textData As String = Nothing
If dataObject.GetDataPresent(DataFormats.StringFormat) Then
    textData = TryCast(dataObject.GetData(DataFormats.StringFormat), String)
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, so GetDataPresent returns "true".
Dim unicodeData() As Byte = Nothing
If dataObject.GetDataPresent(DataFormats.UnicodeText) Then
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

備註

呼叫 GetDataPresent 以判斷這個資料物件中是否有格式可用，然後再呼叫 GetData 。呼叫 GetFormats 以取得此資料物件中所有可用格式的清單。

另請參閱

載入已卸載的檔案範例

適用於

GetDataPresent(Type)

判斷資料是否可以使用 Type 物件所指定的格式，或是否可轉換成該格式。

public:
 virtual bool GetDataPresent(Type ^ format);

public bool GetDataPresent (Type format);

abstract member GetDataPresent : Type -> bool
override this.GetDataPresent : Type -> bool

Public Function GetDataPresent (format As Type) As Boolean

參數

format: Type

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

傳回

Boolean

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

實作

GetDataPresent(Type)

例外狀況

ArgumentNullException

format 為 null。

範例

下列範例會使用此方法，依類型查詢特定資料格式是否存在。

DataObject dataObject = new DataObject("Some string data to store...");

// Query for the presence of String data in the data object, by type.  In this overload 
// of GetDataPresent, the method will return true both for native data formats
// and when the data can automatically be converted to the specifed format.

// In this case, the Text data present in the data object can be autoconverted
// to type string (also represented by DataFormats.String), so GetDataPresent returns "true".
string stringData = null;
if (dataObject.GetDataPresent(typeof(string)))
{
    stringData = dataObject.GetData(DataFormats.Text) as string;
}

Dim dataObject As New DataObject("Some string data to store...")

' Query for the presence of String data in the data object, by type.  In this overload 
' of GetDataPresent, the method will return true both for native data formats
' and when the data can automatically be converted to the specifed format.

' In this case, the Text data present in the data object can be autoconverted
' to type string (also represented by DataFormats.String), so GetDataPresent returns "true".
Dim stringData As String = Nothing
If dataObject.GetDataPresent(GetType(String)) Then
    stringData = TryCast(dataObject.GetData(DataFormats.Text), String)
End If

備註

呼叫 GetDataPresent 以判斷這個資料物件中是否有格式可用，然後再呼叫 GetData 。呼叫 GetFormats 以取得此資料物件中所有可用格式的清單。

另請參閱

載入已卸載的檔案範例

適用於

GetDataPresent(String, Boolean)

判斷資料是否以指定的格式儲存，或是否可轉換成指定的格式。 Boolean 旗標表示如果資料無法使用指定的格式，是否檢查該資料能否轉換為該格式。

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

public bool GetDataPresent (string format, bool autoConvert);

abstract member GetDataPresent : string * bool -> bool
override this.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。

實作

GetDataPresent(String, Boolean)

例外狀況

ArgumentNullException

format 為 null。

範例

下列範例會使用這個方法來依描述項字串查詢資料，並指定如何處理自動轉換的資料格式。

DataObject dataObject = new DataObject("Some string data to store...");

// Query for the presence of Text data in the data object, by data format descriptor string,
// and specifying whether auto-convertible data formats are acceptable.  

// In this case, Text data is present natively, so GetDataPresent returns "true".
string textData = null;
if (dataObject.GetDataPresent(DataFormats.Text, false /* Auto-convert? */))
{
    textData = dataObject.GetData(DataFormats.Text) as string;
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, but it is not available natively, so GetDataPresent returns "false".
byte[] unicodeData = null;
if (dataObject.GetDataPresent(DataFormats.UnicodeText, false /* Auto-convert? */))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, so GetDataPresent returns "true".
if (dataObject.GetDataPresent(DataFormats.UnicodeText, true /* Auto-convert? */))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}

Dim dataObject As New DataObject("Some string data to store...")

' Query for the presence of Text data in the data object, by data format descriptor string,
' and specifying whether auto-convertible data formats are acceptable.  

' In this case, Text data is present natively, so GetDataPresent returns "true".
Dim textData As String = Nothing
If dataObject.GetDataPresent(DataFormats.Text, False) Then ' Auto-convert? 
    textData = TryCast(dataObject.GetData(DataFormats.Text), String)
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, but it is not available natively, so GetDataPresent returns "false".
Dim unicodeData() As Byte = Nothing
If dataObject.GetDataPresent(DataFormats.UnicodeText, False) Then ' Auto-convert? 
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, so GetDataPresent returns "true".
If dataObject.GetDataPresent(DataFormats.UnicodeText, True) Then ' Auto-convert? 
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

備註

呼叫 GetDataPresent 以判斷這個資料物件中是否有格式可用，然後再呼叫 GetData 。呼叫 GetFormats 以取得此資料物件中所有可用格式的清單。

另請參閱

載入已卸載的檔案範例

適用於

DataObject.GetDataPresent 方法

定義

多載

備註

GetDataPresent(String)

參數

傳回

實作

例外狀況

範例

備註

另請參閱

適用於

GetDataPresent(Type)

參數

傳回

實作

例外狀況

範例

備註

另請參閱

適用於

GetDataPresent(String, Boolean)

參數

傳回

實作

例外狀況

範例

備註

另請參閱

適用於

意見反應

其他資源