DataObject.GetData メソッド

定義

名前空間:

System.Windows

アセンブリ:

PresentationCore.dll

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

オーバーロード

GetData(String)	文字列で指定された形式のデータを返します。
GetData(Type)	Type オブジェクトで指定された形式のデータ オブジェクトを返します。
GetData(String, Boolean)	指定した形式のデータ オブジェクトを返し、オプションでデータを指定した形式に変換します。

GetData(String)

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

public:
 virtual System::Object ^ GetData(System::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);

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);

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

実装

GetData(String, Boolean)

例外

ArgumentNullException

format が null です。

こちらもご覧ください

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