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)

Сохраняет указанные данные в этом объекте данных, наряду с одним или несколькими указанными форматами данных; формат данных указывается строкой.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)

Сохраняет указанные данные в этом объекте данных, вместе с одним или несколькими указанными форматами данных.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)

Сохраняет указанные данные в этом объекте данных, наряду с одним или несколькими указанными форматами данных; формат данных указывается объектом 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 и готов разместить DataObject на Clipboard или начать операцию перетаскивания.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. Этот метод применяется, чтобы определить, будут ли две различные структуры 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.

Применяется к

Дополнительно