DataObject.GetData メソッド

定義

名前空間:: System.Windows

アセンブリ:: PresentationCore.dll

重要

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

指定したデータ形式のデータを返します。

オーバーロード

名前	説明
GetData(String)	文字列で指定された形式でデータを返します。
GetData(Type)	Type オブジェクトで指定された形式のデータオブジェクトを返します。
GetData(String, Boolean)	指定した形式のデータオブジェクトを返します。必要に応じて、データを指定した形式に変換します。

GetData(String)

文字列で指定された形式でデータを返します。

public:
 virtual System::Object ^ GetData(System::String ^ format);

public object GetData(string format);

public object? GetData(string format);

abstract member GetData : string -> obj
override this.GetData : string -> obj

Public Function GetData (format As String) As Object

パラメーター

format: String

データの形式を指定する文字列。定義済みのデータ形式のセットについては、 DataFormats クラスを参照してください。

返品

Object

指定した形式のデータを含むオブジェクト。指定した形式でデータが使用できない場合に null 。

実装

GetData(String)

例外

ArgumentNullException

format は nullです。

例

次の例では、このメソッドを使用して、最初に指定したデータ形式が使用できるかどうかを (ネイティブまたは自動変換によって) 確認します。指定した形式が使用可能な場合は、 GetData(String) メソッドを使用してデータを取得します。

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

string desiredFormat = DataFormats.UnicodeText;
byte[] data = null;

// Use the GetDataPresent method to check for the presence of a desired data format.
// This particular overload of GetDataPresent looks for both native and auto-convertible 
// data formats.
if (dataObject.GetDataPresent(desiredFormat))
{
    // If the desired data format is present, use one of the GetData methods to retrieve the
    // data from the data object.
    data = dataObject.GetData(desiredFormat) as byte[];
}

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

Dim desiredFormat As String = DataFormats.UnicodeText
Dim data() As Byte = Nothing

' Use the GetDataPresent method to check for the presence of a desired data format.
' This particular overload of GetDataPresent looks for both native and auto-convertible 
' data formats.
If dataObject.GetDataPresent(desiredFormat) Then
    ' If the desired data format is present, use one of the GetData methods to retrieve the
    ' data from the data object.
    data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If

次のコード例では、 GetDataPresent(String, Boolean) メソッドを使用して、指定したデータ形式がネイティブに使用可能かどうかを最初に確認します (自動変換可能なデータ形式がフィルター処理されます)。指定した形式が使用可能な場合は、 GetData(String) メソッドを使用してデータを取得します。

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

string desiredFormat = DataFormats.UnicodeText;
bool noAutoConvert = false;
byte[] data = null;

// Use the GetDataPresent method to check for the presence of a desired data format.
// The autoconvert parameter is set to false to filter out auto-convertible data formats,
// returning true only if the specified data format is available natively.
if (dataObject.GetDataPresent(desiredFormat, noAutoConvert))
{
    // If the desired data format is present, use one of the GetData methods to retrieve the
    // data from the data object.
    data = dataObject.GetData(desiredFormat) as byte[];
}

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

Dim desiredFormat As String = DataFormats.UnicodeText
Dim noAutoConvert As Boolean = False
Dim data() As Byte = Nothing

' Use the GetDataPresent method to check for the presence of a desired data format.
' The autoconvert parameter is set to false to filter out auto-convertible data formats,
' returning true only if the specified data format is available natively.
If dataObject.GetDataPresent(desiredFormat, noAutoConvert) Then
    ' If the desired data format is present, use one of the GetData methods to retrieve the
    ' data from the data object.
    data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If

こちらもご覧ください

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

適用対象

GetData(Type)

Type オブジェクトで指定された形式のデータオブジェクトを返します。

public:
 virtual System::Object ^ GetData(Type ^ format);

public object GetData(Type format);

public object? GetData(Type format);

abstract member GetData : Type -> obj
override this.GetData : Type -> obj

Public Function GetData (format As Type) As Object

パラメーター

format: Type

データの形式を指定する Type 。定義済みのデータ形式のセットについては、 DataFormats クラスを参照してください。

返品

Object

指定した形式のデータを含むデータオブジェクト。指定した形式でデータが使用できない場合は null 。

実装

GetData(Type)

例外

ArgumentNullException

format は nullです。

こちらもご覧ください

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

適用対象

GetData(String, Boolean)

指定した形式のデータオブジェクトを返します。必要に応じて、データを指定した形式に変換します。

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

public object GetData(string format, bool autoConvert);

public object? GetData(string format, bool autoConvert);

abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj

Public Function GetData (format As String, autoConvert As Boolean) As Object

パラメーター

format: String

データの形式を指定する文字列。定義済みのデータ形式のセットについては、 DataFormats クラスを参照してください。

autoConvert: Boolean

true データを指定された形式に自動的に変換する場合。データ形式の変換がない場合に false します。

返品

Object

指定した形式のデータを含むデータオブジェクト。指定した形式でデータが使用できない場合は null 。

autoConvert パラメーターがtrueされ、データを指定した形式に変換できない場合、または自動変換が無効になっている場合 (SetData(String, Object, Boolean) パラメーターを autoConvert に設定してfalseを呼び出すことによって)、このメソッドはnullを返します。

実装

GetData(String, Boolean)

例外

ArgumentNullException

format が null です。

こちらもご覧ください

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

適用対象

フィードバック

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