次の方法で共有


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);
abstract member GetData : string -> obj
override this.GetData : string -> obj
Public Function GetData (format As String) As Object

パラメーター

format
String

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

戻り値

Object

指定した形式のデータを格納しているオブジェクト。指定した形式でデータを取得できない場合は 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);
abstract member GetData : Type -> obj
override this.GetData : Type -> obj
Public Function GetData (format As Type) As Object

パラメーター

format
Type

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

戻り値

Object

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

実装

例外

formatnullです。

こちらもご覧ください

適用対象

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

実装

例外

formatnull です。

こちらもご覧ください

適用対象