DataObject.GetData メソッド

定義

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

オーバーロード

名前 説明
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 クラスを参照してください。

返品

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

実装

例外

formatnullです。

次の例では、このメソッドを使用して、最初に指定したデータ形式が使用できるかどうかを (ネイティブまたは自動変換によって) 確認します。指定した形式が使用可能な場合は、 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 クラスを参照してください。

返品

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

実装

例外

formatnullです。

こちらもご覧ください

適用対象

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 します。

返品

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

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

実装

例外

formatnull です

こちらもご覧ください

適用対象