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)

参数

返回

实现

例外

示例

注解

另请参阅

适用于

反馈

其他资源