DataObject.GetDataPresent メソッド

定義

名前空間:: System.Windows

アセンブリ:: PresentationCore.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定した形式でデータを使用できるかどうか、またはデータを変換できるかどうかを決定します。

オーバーロード

名前	説明
GetDataPresent(String)	データが文字列で指定された形式で使用できるか、または変換できるかを決定します。
GetDataPresent(Type)	データが、 Type オブジェクトで指定された形式で使用できるか、またはデータに変換できるかを決定します。
GetDataPresent(String, Boolean)	指定した形式でデータを使用できるかどうか、またはデータを変換できるかどうかを決定します。 `Boolean` フラグは、データがその形式で使用できない場合に、指定した形式に変換できるかどうかを確認するかどうかを示します。

注釈

GetDataを呼び出す前に、GetDataPresentを呼び出して、このデータオブジェクトで形式を使用できるかどうかを判断します。 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(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 。 F または定義済みのデータ形式のセットは、 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(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

注釈

こちらもご覧ください

ドロップされたファイルの読み込みサンプル

適用対象

フィードバック

このページはお役に立ちましたか?