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. Boolean フラグは、データが指定した形式で使用できない場合に、指定した形式への変換が可能であるかどうかのチェックの有無を示します。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. Boolean フラグは、データの自動変換先として有効な形式も含めるかどうかを示します。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. 貼り付け操作またはドロップ操作をしようとしているオブジェクトは、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.

適用対象

こちらもご覧ください