DataObject DataObject DataObject DataObject Class

定義

基本実装を提供、IDataObjectインターフェイスで、データを転送するための形式に依存しないメカニズムを定義します。Provides a basic implementation of the IDataObject interface, which defines a format-independent mechanism for transferring data.

public ref class DataObject sealed : System::Runtime::InteropServices::ComTypes::IDataObject, System::Windows::IDataObject
public sealed class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.IDataObject
type DataObject = class
    interface IDataObject
    interface IDataObject
Public NotInheritable Class DataObject
Implements IDataObject, IDataObject
継承
DataObjectDataObjectDataObjectDataObject
実装

このクラスを使用する方法を次の例に示します。The following example shows how to use this class.

string stringData = "Some string data to store...";
string dataFormat = DataFormats.UnicodeText;
DataObject dataObject = new DataObject(dataFormat, stringData);
Dim stringData As String = "Some string data to store..."
Dim dataFormat As String = DataFormats.UnicodeText
Dim dataObject As New DataObject(dataFormat, stringData)

注釈

重要

このクラスのメソッドを信頼されていないデータを指定して呼び出すことには、セキュリティ上のリスクが伴います。Calling methods from this class with untrusted data is a security risk. このクラスのメソッドの呼び出しは、信頼されたデータだけを指定して実行してください。Call the methods from this class only with trusted data. 詳しくは、「Data Validation」(データの入力規則) を参照してください。For more information, see Data Validation.

コンストラクター

DataObject() DataObject() DataObject() DataObject()

DataObject クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataObject class.

DataObject(Object) DataObject(Object) DataObject(Object) DataObject(Object)

新しいインスタンスを初期化、DataObject指定されたデータを含むクラスです。Initializes a new instance of the DataObject class that contains the specified data.

DataObject(String, Object) DataObject(String, Object) DataObject(String, Object) DataObject(String, Object)

新しいインスタンスを初期化、DataObjectクラス、指定されたデータとその関連付けられている形式を格納している; の形式は文字列で指定します。Initializes a new instance of the DataObject class that contains the specified data and its associated format; the format is specified by a string.

DataObject(String, Object, Boolean) DataObject(String, Object, Boolean) DataObject(String, Object, Boolean) DataObject(String, Object, Boolean)

新しいインスタンスを初期化、DataObjectクラス、指定されたデータとその関連付けられている形式を格納している; の形式は文字列で指定します。Initializes a new instance of the DataObject class that contains the specified data and its associated format; the format is specified by a string. このオーバー ロードが含まれています、Booleanデータの取得に別の形式に変換できるかどうかを示すフラグ。This overload includes a Boolean flag to indicate whether the data may be converted to another format on retrieval.

DataObject(Type, Object) DataObject(Type, Object) DataObject(Type, Object) DataObject(Type, Object)

新しいインスタンスを初期化、DataObjectクラス、指定されたデータとその関連付けられている形式を格納している; で、データ形式が指定された、Typeオブジェクト。Initializes a new instance of the DataObject class that contains the specified data and its associated format; the data format is specified by a Type object.

フィールド

CopyingEvent CopyingEvent CopyingEvent CopyingEvent

Copying 添付イベントを識別します。Identifies the Copying attached event.

PastingEvent PastingEvent PastingEvent PastingEvent

Pasting 添付イベントを識別します。Identifies the Pasting attached event.

SettingDataEvent SettingDataEvent SettingDataEvent SettingDataEvent

SettingData 添付イベントを識別します。Identifies the SettingData attached event.

メソッド

AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

指定された依存関係オブジェクトに Copying イベント ハンドラーを追加します。Adds a Copying event handler to a specified dependency object.

AddPastingHandler(DependencyObject, DataObjectPastingEventHandler) AddPastingHandler(DependencyObject, DataObjectPastingEventHandler) AddPastingHandler(DependencyObject, DataObjectPastingEventHandler) AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)

指定された依存関係オブジェクトに Pasting イベント ハンドラーを追加します。Adds a Pasting event handler to a specified dependency object.

AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

指定された依存関係オブジェクトに SettingData イベント ハンドラーを追加します。Adds a SettingData event handler to a specified dependency object.

ContainsAudio() ContainsAudio() ContainsAudio() ContainsAudio()

内のデータが存在するデータ オブジェクトに照会、WaveAudioデータ形式。Queries a data object for the presence of data in the WaveAudio data format.

ContainsFileDropList() ContainsFileDropList() ContainsFileDropList() ContainsFileDropList()

内のデータが存在するデータ オブジェクトに照会、FileDropデータ形式。Queries a data object for the presence of data in the FileDrop data format.

ContainsImage() ContainsImage() ContainsImage() ContainsImage()

内のデータが存在するデータ オブジェクトに照会、Bitmapデータ形式。Queries a data object for the presence of data in the Bitmap data format.

ContainsText() ContainsText() ContainsText() ContainsText()

内のデータが存在するデータ オブジェクトに照会、UnicodeText形式。Queries a data object for the presence of data in the UnicodeText format.

ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat)

テキスト データ形式のデータが存在するデータ オブジェクトに照会します。Queries a data object for the presence of data in a text data format.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetAudioStream() GetAudioStream() GetAudioStream() GetAudioStream()

内のデータを格納しているストリームを返します、WaveAudioデータ形式。Returns a stream that contains data in the WaveAudio data format.

GetData(String) GetData(String) GetData(String) GetData(String)

文字列で指定された形式でデータを返します。Returns data in a format specified by a string.

GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean)

必要に応じて、データを指定された形式に変換する、指定された形式でデータ オブジェクトを返します。Returns a data object in a specified format, optionally converting the data to the specified format.

GetData(Type) GetData(Type) GetData(Type) GetData(Type)

指定された形式でデータ オブジェクトを返します、Typeオブジェクト。Returns a data object in a format specified by a Type object.

GetDataPresent(String) GetDataPresent(String) GetDataPresent(String) GetDataPresent(String)

データで使用できる、または文字列で指定された形式に変換できるかどうかを判断します。Determines whether the data is available in, or can be converted to, a format specified by a string.

GetDataPresent(String, Boolean) GetDataPresent(String, Boolean) GetDataPresent(String, Boolean) GetDataPresent(String, Boolean)

データで使用できますか、指定した形式に変換できるかどうか決定します。Determines whether the data is available in, or can be converted to, a specified format. ABooleanフラグではない形式が使用可能な場合、データを指定した形式に変換できるかどうかを確認するかどうかを示します。A Boolean flag indicates whether to check if the data can be converted to the specified format if it is not available in that format.

GetDataPresent(Type) GetDataPresent(Type) GetDataPresent(Type) GetDataPresent(Type)

データで使用できますかで指定された形式に変換できるかどうかを決定します、Typeオブジェクト。Determines whether the data is available in, or can be converted to, a format specified by a Type object.

GetFileDropList() GetFileDropList() GetFileDropList() GetFileDropList()

ドロップされたファイルの一覧を含む文字列コレクションを返します。Returns a string collection that contains a list of dropped files.

GetFormats() GetFormats() GetFormats() GetFormats()

このデータ オブジェクト内のデータが格納されているまたはに変換できる形式の一覧を返します。Returns a list of formats in which the data in this data object is stored, or can be converted to.

GetFormats(Boolean) GetFormats(Boolean) GetFormats(Boolean) GetFormats(Boolean)

このデータ オブジェクト内のデータが格納されている形式の一覧を返します。Returns a list of formats in which the data in this data object is stored. ABooleanフラグは、データを自動的に変換できる形式も含めるかどうかを示します。A Boolean flag indicates whether to also include formats that the data can be automatically converted to.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetImage() GetImage() GetImage() GetImage()

返します、BitmapSource内のデータを格納しているオブジェクト、Bitmap形式。Returns a BitmapSource object that contains data in the Bitmap format.

GetText() GetText() GetText() GetText()

含む文字列を返します、UnicodeTextこのデータ オブジェクト内のデータ。Returns a string that contains the UnicodeText data in this data object.

GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat)

このデータ オブジェクトで指定された形式のテキスト データを含む文字列を返します。Returns a string that contains text data of the specified format in this data object.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler) RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)

指定した依存関係オブジェクトから Copying イベント ハンドラーを削除します。Removes a Copying event handler from a specified dependency object.

RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler) RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler) RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler) RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)

指定した依存関係オブジェクトから Pasting イベント ハンドラーを削除します。Removes a Pasting event handler from a specified dependency object.

RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler) RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)

指定した依存関係オブジェクトから SettingData イベント ハンドラーを削除します。Removes a SettingData event handler from a specified dependency object.

SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[])

オーディオ データの格納 (WaveAudioデータ形式) でこのデータ オブジェクト。Stores audio data (WaveAudio data format) in this data object. オーディオ データは、バイト配列として指定されます。The audio data is specified as a byte array.

SetAudio(Stream) SetAudio(Stream) SetAudio(Stream) SetAudio(Stream)

オーディオ データの格納 (WaveAudioデータ形式) でこのデータ オブジェクト。Stores audio data (WaveAudio data format) in this data object. オーディオ データは、ストリームとして指定されます。The audio data is specified as a stream.

SetData(Object) SetData(Object) SetData(Object) SetData(Object)

ソース オブジェクトの型からのデータ形式を自動的に決定する、このデータ オブジェクトに指定したデータを格納します。Stores the specified data in this data object, automatically determining the data format from the source object type.

SetData(String, Object) SetData(String, Object) SetData(String, Object) SetData(String, Object)

指定したデータを、1 つ以上の指定したデータ形式と共に、このデータ オブジェクトに格納します。データ形式は文字列で指定します。Stores the specified data in this data object, along with one or more specified data formats; the data format is specified by a string.

SetData(String, Object, Boolean) SetData(String, Object, Boolean) SetData(String, Object, Boolean) SetData(String, Object, Boolean)

1 つまたは複数の指定したデータ形式と共に、このデータ オブジェクトに指定したデータを格納します。Stores the specified data in this data object, along with one or more specified data formats. このオーバー ロードが含まれています、Booleanデータの取得に別の形式に変換できるかどうかを示すフラグ。This overload includes a Boolean flag to indicate whether the data can be converted to another format on retrieval.

SetData(Type, Object) SetData(Type, Object) SetData(Type, Object) SetData(Type, Object)

1 つまたは複数指定したデータ形式と共に、このデータ オブジェクトに指定したデータを格納します。データ形式がで指定された、Typeオブジェクト。Stores the specified data in this data object, along with one or more specified data formats; the data format is specified by a Type object.

SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection)

ストアFileDropこのデータ オブジェクト内のデータ。Stores FileDrop data in this data object. ドロップされたファイルのリストは、文字列コレクションとして指定されます。The dropped file list is specified as a string collection.

SetImage(BitmapSource) SetImage(BitmapSource) SetImage(BitmapSource) SetImage(BitmapSource)

ストアBitmapこのデータ オブジェクト内のデータ。Stores Bitmap data in this data object. イメージ データとして指定するBitmapSourceします。The image data is specified as a BitmapSource.

SetText(String) SetText(String) SetText(String) SetText(String)

ストアUnicodeTextデータ、このデータ オブジェクトの文字列として指定します。Stores UnicodeText data, specified as a string, in this data object.

SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat)

このデータ オブジェクトには、テキスト データを格納します。Stores text data in this data object. メンバーに格納するテキスト データの形式が指定されたTextDataFormatします。The format of the text data to store is specified with a member of TextDataFormat.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

添付イベント

Copying Copying Copying Copying

関連付けられた依存関係オブジェクトが、コピーする選択項目を表す適切なデータ形式の準備を完了し、コピーする選択範囲の形式を DataObject に追加し、DataObjectClipboard に置くか、ドラッグ アンド ドロップ操作を開始する準備ができたときに発生します。Occurs when the associated dependency object has prepared appropriate data formats that represent the copy selection, added the copy selection formats to a DataObject, and is ready to either place the DataObject on the Clipboard or begin a drag-and-drop operation.

Pasting Pasting Pasting Pasting

関連付けられた依存関係オブジェクトがデータを貼り付ける準備ができたときに発生します。Occurs when the associated dependency object is ready to paste data.

SettingData SettingData SettingData SettingData

関連付けられた依存関係オブジェクトが新しいデータ形式を DataObject に追加しようとすると発生します。Occurs when the associated dependency object attempts to add a new data format to a DataObject.

明示的なインターフェイスの実装

IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

データ オブジェクトとアドバイズ シンク間の接続を作成します。Creates a connection between a data object and an advisory sink. このメソッドは、アドバイズ シンクをサポートするオブジェクトによって呼び出され、オブジェクトのデータの変更をアドバイズ シンクに通知できるようにします。This method is called by an object that supports an advisory sink and enables the advisory sink to be notified of changes in the object's data.

IDataObject.DUnadvise(Int32) IDataObject.DUnadvise(Int32) IDataObject.DUnadvise(Int32) IDataObject.DUnadvise(Int32)

以前に確立されていた通知の接続を破棄します。Destroys a notification connection that had been previously established.

IDataObject.EnumDAdvise(IEnumSTATDATA) IDataObject.EnumDAdvise(IEnumSTATDATA) IDataObject.EnumDAdvise(IEnumSTATDATA) IDataObject.EnumDAdvise(IEnumSTATDATA)

現在のアドバイザリ コネクションを列挙するために使用できるオブジェクトを作成します。Creates an object that can be used to enumerate the current advisory connections.

IDataObject.EnumFormatEtc(DATADIR) IDataObject.EnumFormatEtc(DATADIR) IDataObject.EnumFormatEtc(DATADIR) IDataObject.EnumFormatEtc(DATADIR)

列挙するオブジェクトを作成、FORMATETCデータ オブジェクトの構造体。Creates an object for enumerating the FORMATETC structures for a data object. これらの構造体が呼び出しで使用されてGetData(FORMATETC, STGMEDIUM)またはSetData(FORMATETC, STGMEDIUM, Boolean)します。These structures are used in calls to GetData(FORMATETC, STGMEDIUM) or SetData(FORMATETC, STGMEDIUM, Boolean).

IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)

標準を提供します。FORMATETCより複雑な構造に論理的に相当する構造体。Provides a standard FORMATETC structure that is logically equivalent to a more complex structure. 2 つかどうかを判断するには、このメソッドを使用して異なるFORMATETC構造体は同一のデータ、重複するレンダリングの必要性を返します。Use this method to determine whether two different FORMATETC structures would return the same data, removing the need for duplicate rendering.

IDataObject.GetData(FORMATETC, STGMEDIUM) IDataObject.GetData(FORMATETC, STGMEDIUM) IDataObject.GetData(FORMATETC, STGMEDIUM) IDataObject.GetData(FORMATETC, STGMEDIUM)

ソース データ オブジェクトからデータを取得します。Obtains data from a source data object. GetData(FORMATETC, STGMEDIUM)メソッドは、データ コンシューマーによって呼び出され、指定した記述されているデータをレンダリングするFORMATETC構造体し、を指定した転送STGMEDIUM構造体。The GetData(FORMATETC, STGMEDIUM) method, which is called by a data consumer, renders the data described in the specified FORMATETC structure and transfers it through the specified STGMEDIUM structure. 呼び出し元が解放する必要性を想定し、STGMEDIUM構造体。The caller then assumes responsibility for releasing the STGMEDIUM structure.

IDataObject.GetDataHere(FORMATETC, STGMEDIUM) IDataObject.GetDataHere(FORMATETC, STGMEDIUM) IDataObject.GetDataHere(FORMATETC, STGMEDIUM) IDataObject.GetDataHere(FORMATETC, STGMEDIUM)

ソース データ オブジェクトからデータを取得します。Obtains data from a source data object. このメソッドは、データ コンシューマーによって呼び出されるとは異なります、GetData(FORMATETC, STGMEDIUM)メソッドを呼び出し元が割り当てるし、指定したストレージ メディアを解放する必要があります。This method, which is called by a data consumer, differs from the GetData(FORMATETC, STGMEDIUM) method in that the caller must allocate and free the specified storage medium.

IDataObject.QueryGetData(FORMATETC) IDataObject.QueryGetData(FORMATETC) IDataObject.QueryGetData(FORMATETC) IDataObject.QueryGetData(FORMATETC)

データ オブジェクトがで説明されているデータを表示できるかどうか、FORMATETC構造体。Determines whether the data object is capable of rendering the data described in the FORMATETC structure. オブジェクトを呼び出す前に、このメソッドを呼び出すことができます、貼り付けまたは drop 操作を行うGetData(FORMATETC, STGMEDIUM)の操作が成功する可能性があるかどうかを示す値を取得します。Objects attempting a paste or drop operation can call this method before calling GetData(FORMATETC, STGMEDIUM) to get an indication of whether the operation may be successful.

IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean) IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean) IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean) IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)

このメソッドを実装するオブジェクトにデータを転送します。Transfers data to the object that implements this method. このメソッドは、データ ソースを格納しているオブジェクトから呼び出されます。This method is called by an object that contains a data source.

適用対象

こちらもご覧ください