DataObject.GetData メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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 クラスを参照してください。
返品
指定した形式のデータを含むオブジェクト。指定した形式でデータが使用できない場合に null 。
実装
例外
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 クラスを参照してください。
返品
指定した形式のデータを含むデータ オブジェクト。指定した形式でデータが使用できない場合は null 。
実装
例外
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 します。
返品
指定した形式のデータを含むデータ オブジェクト。指定した形式でデータが使用できない場合は null 。
autoConvert パラメーターがtrueされ、データを指定した形式に変換できない場合、または自動変換が無効になっている場合 (autoConvert パラメーターを false に設定してSetData(String, Object, Boolean)を呼び出すことによって)、このメソッドはnullを返します。
実装
例外
format が null です。