DataObject Класс

Ссылка

Определение

Пространство имен:: System.Windows

Сборка:: PresentationCore.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет базовую реализацию интерфейса IDataObject, которая определяет не зависимый от формата механизм передачи данных.

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

Наследование: Object
DataObject

Реализации: IDataObject IDataObject

Примеры

В следующем примере показано, как использовать этот класс.

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)

Вызов методов этого класса для ненадежных данных представляет угрозу безопасности. Вызывайте методы класса только для надежных данных. Дополнительные сведения см. в разделе Проверка всех входных данных.

Конструкторы

DataObject()	Инициализирует новый экземпляр класса DataObject.
DataObject(Object)	Инициализирует новый экземпляр класса DataObject, который содержит указанные данные.
DataObject(String, Object)	Инициализирует новый экземпляр класса DataObject, содержащий указанные данные и связанный с ними формат; формат задается строкой.
DataObject(String, Object, Boolean)	Инициализирует новый экземпляр класса DataObject, содержащий указанные данные и связанный с ними формат; формат задается строкой. Эта перегруженная версия включает флаг `Boolean`, указывающий, могут ли данные быть преобразованы в другой формат при извлечении.
DataObject(Type, Object)	Инициализирует новый экземпляр класса DataObject, который содержит указанные данные и связанный с ними формат; формат данных указывается объектом Type.

Поля

CopyingEvent	Идентифицирует присоединенное событие Copying.
PastingEvent	Идентифицирует присоединенное событие Pasting.
SettingDataEvent	Идентифицирует присоединенное событие SettingData.

Методы

AddCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Добавляет обработчик событий Copying к заданному объекту зависимости.
AddPastingHandler(DependencyObject, DataObjectPastingEventHandler)	Добавляет обработчик событий Pasting к заданному объекту зависимости.
AddSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Добавляет обработчик событий SettingData к заданному объекту зависимости.
ContainsAudio()	Запрашивает объект данных на наличие данных в формате WaveAudio.
ContainsFileDropList()	Запрашивает объект данных на наличие данных в формате FileDrop.
ContainsImage()	Запрашивает объект данных на наличие данных в формате Bitmap.
ContainsText()	Запрашивает объект данных на наличие данных в формате UnicodeText.
ContainsText(TextDataFormat)	Запрашивает объект данных на наличие данных в текстовом формате.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetAudioStream()	Возвращает поток, содержащий данные в формате WaveAudio.
GetData(String)	Возвращает данные в формате, указанном строкой.
GetData(String, Boolean)	Возвращает объект данных в указанном формате, при необходимости преобразуя данные в этот формат.
GetData(Type)	Возвращает объект данных в формате, указанном объектом Type.
GetDataPresent(String)	Определяет, доступны ли данные в указанном формате, или возможность их преобразования в формат, указанный строкой.
GetDataPresent(String, Boolean)	Определяет, доступны ли данные в указанном формате, или возможность их преобразования в указанный формат. Флаг `Boolean` указывает, проверить ли возможность преобразования данных в указанный формат, если они не доступны в этом формате.
GetDataPresent(Type)	Определяет, доступны ли данные в указанном формате, или возможность их преобразования в формат, указанный объектом Type.
GetFileDropList()	Возвращает коллекцию строк, содержащую список перенесенных файлов.
GetFormats()	Возвращает список форматов, в которых данные хранятся в этом объекте данных или в которые их можно преобразовать.
GetFormats(Boolean)	Возвращает список форматов, в которых данные хранятся в этом объекте данных. Флаг `Boolean` указывает, следует ли также включать форматы, в которые данные могут быть автоматически преобразованы.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetImage()	Возвращает объект BitmapSource, содержащий данные в формате Bitmap.
GetText()	Возвращает строку, содержащую данные UnicodeText в этом объекте данных.
GetText(TextDataFormat)	Возвращает строку, содержащую текстовые данные указанного формата в этот объект данных.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Удаляет обработчик событий Copying из заданного объекта зависимости.
RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)	Удаляет обработчик событий Pasting из заданного объекта зависимости.
RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Удаляет обработчик событий SettingData из заданного объекта зависимости.
SetAudio(Byte[])	Сохраняет аудиоданные (формат данных WaveAudio) в этом объекте данных. Аудиоданные указываются в виде массива байтов.
SetAudio(Stream)	Сохраняет аудиоданные (формат данных WaveAudio) в этом объекте данных. Аудиоданные указываются в виде потока.
SetData(Object)	Сохраняет указанные данные в этом объекте данных, автоматически определяя формат данных на основе исходного типа объекта.
SetData(String, Object)	Сохраняет указанные данные в этом объекте данных, а также один или несколько указанных форматов данных. Формат данных задается строкой.
SetData(String, Object, Boolean)	Сохраняет указанные данные в этом объекте данных, вместе с одним или несколькими указанными форматами данных. Данная перегруженная версия включает в себя флаг `Boolean`, указывающий, могут ли быть преобразованы данные в другой формат при извлечении.
SetData(Type, Object)	Сохраняет указанные данные в этом объекте данных, наряду с одним или несколькими указанными форматами данных; формат данных указывается объектом Type.
SetFileDropList(StringCollection)	Сохраняет данные FileDrop в этом объекте данных. Список перенесенных файлов указывается в виде коллекции строк.
SetImage(BitmapSource)	Сохраняет данные Bitmap в этом объекте данных. Данные изображения обрабатываются как BitmapSource.
SetText(String)	Сохраняет данные UnicodeText, указанные в виде строки, в этом объекте данных.
SetText(String, TextDataFormat)	Сохраняет текстовые данные в этом объекте данных. Формат текстовых данных для хранения указывается членом TextDataFormat.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Присоединенные события

Copying	Происходит, когда связанный объект зависимости подготовил соответствующие форматы данных, представляющие копирование выбранного фрагмента, добавил форматы копирования выбранного фрагмента в DataObject и готов разместить DataObject на Clipboard или начать операцию перетаскивания.
Pasting	Происходит, когда связанный объект зависимости готов к вставке данных.
SettingData	Происходит, когда связанный объект зависимости пытается добавить новый формат данных в DataObject.

Явные реализации интерфейса

IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)	Создает соединение между объектом данных и приемником уведомлений. Этот метод вызывается объектом, который поддерживает приемник уведомлений и позволяет уведомлять приемник об изменениях в данных объекта.
IDataObject.DUnadvise(Int32)	Разрывает соединение уведомления, которое было ранее установлено.
IDataObject.EnumDAdvise(IEnumSTATDATA)	Создает объект, который может использоваться для перечисления текущих соединений для рекомендаций.
IDataObject.EnumFormatEtc(DATADIR)	Создает объект для перечисления структур FORMATETC для объекта данных. Эти структуры используются в вызовах GetData(FORMATETC, STGMEDIUM) или SetData(FORMATETC, STGMEDIUM, Boolean).
IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)	Предоставляет стандартную структуру FORMATETC, которая логически эквивалентна более сложной структуре. Этот метод применяется, чтобы определить, будут ли две различные структуры FORMATETC возвращать одинаковые данные, что позволяет избежать ненужной повторной отрисовки.
IDataObject.GetData(FORMATETC, STGMEDIUM)	Получает данные из исходного объекта данных. Метод GetData(FORMATETC, STGMEDIUM), который вызывается объектом-получателем данных, обрабатывает данные, описанные в заданной структуре FORMATETC, и передает их через заданную структуру STGMEDIUM. Затем вызывающий объект несет ответственность за освобождение структуры STGMEDIUM.
IDataObject.GetDataHere(FORMATETC, STGMEDIUM)	Получает данные из исходного объекта данных. Этот метод, который вызывается объектом-получателем данных, отличается от метода GetData(FORMATETC, STGMEDIUM), в котором вызывающий объект должен выделить и освободить заданную среду хранения.
IDataObject.QueryGetData(FORMATETC)	Определяет, способен ли объект данных выполнять отрисовку данных, описанных в структуре FORMATETC. Объекты, пытающиеся выполнять операцию вставки или перетаскивания, могут вызывать этот метод перед вызовом GetData(FORMATETC, STGMEDIUM), чтобы получить указание о том, может ли операция быть успешной.
IDataObject.SetData(FORMATETC, STGMEDIUM, Boolean)	Передает данные в объект, реализующий этот метод. Этот метод вызывается объектом, содержащим источник данных.

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

См. также раздел

Загрузка примера удаленного файла