DataObject Класс

Определение

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

System.Windows

Сборка:

PresentationCore.dll

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

public ref class DataObject sealed : System::Runtime::InteropServices::ComTypes::IDataObject, System::Windows::ITypedDataObject

public sealed class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.ITypedDataObject

type DataObject = class
    interface IDataObject
    interface IDataObject
    interface ITypedDataObject

Public NotInheritable Class DataObject
Implements IDataObject, ITypedDataObject

Наследование

Object

DataObject

Реализации

IDataObject IDataObject ITypedDataObject

Примеры

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

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)

Комментарии

Important

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

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

Имя	Описание
DataObject()	Инициализирует новый экземпляр класса DataObject.
DataObject(Object)	Инициализирует новый экземпляр DataObject класса, содержащего указанные данные.
DataObject(String, Object, Boolean)	Инициализирует новый экземпляр DataObject класса, содержащего указанные данные и связанный с ним формат. Формат указывается строкой. Эта перегрузка включает флаг, указывающий Boolean , могут ли данные быть преобразованы в другой формат при извлечении.
DataObject(String, Object)	Инициализирует новый экземпляр DataObject класса, содержащего указанные данные и связанный с ним формат. Формат указывается строкой.
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)	Запрашивает объект данных для присутствия данных в текстовом формате данных.
GetAudioStream()	Возвращает поток, содержащий данные в WaveAudio формате данных.
GetData(String, Boolean)	Возвращает объект данных в указанном формате, при необходимости преобразуя данные в указанный формат.
GetData(String)	Возвращает данные в формате, указанном строкой.
GetData(Type)	Возвращает объект данных в формате, указанном Type объектом.
GetDataPresent(String, Boolean)	Определяет, доступны ли данные или могут быть преобразованы в указанный формат. Флаг Boolean указывает, можно ли проверить, можно ли преобразовать данные в указанный формат, если он недоступен в этом формате.
GetDataPresent(String)	Определяет, доступны ли данные в строке или могут быть преобразованы в формат, указанный строкой.
GetDataPresent(Type)	Определяет, доступны ли данные в объекте или могут быть преобразованы в формат, указанный Type объектом.
GetFileDropList()	Возвращает коллекцию строк, содержащую список удаленных файлов.
GetFormats()	Возвращает список форматов, в которых хранятся данные в этом объекте данных или в них можно преобразовать.
GetFormats(Boolean)	Возвращает список форматов, в которых хранятся данные в этом объекте данных. Флаг Boolean указывает, следует ли также включать форматы, в которые можно автоматически преобразовать данные.
GetImage()	BitmapSource Возвращает объект, содержащий данные в Bitmap формате.
GetText()	Возвращает строку, содержащую UnicodeText данные в этом объекте данных.
GetText(TextDataFormat)	Возвращает строку, содержащую текстовые данные указанного формата в этом объекте данных.
RemoveCopyingHandler(DependencyObject, DataObjectCopyingEventHandler)	Удаляет Copying обработчик событий из указанного объекта зависимостей.
RemovePastingHandler(DependencyObject, DataObjectPastingEventHandler)	Удаляет Pasting обработчик событий из указанного объекта зависимостей.
RemoveSettingDataHandler(DependencyObject, DataObjectSettingDataEventHandler)	Удаляет SettingData обработчик событий из указанного объекта зависимостей.
SetAudio(Byte[])	Хранит звуковые данные (WaveAudio формат данных) в этом объекте данных. Звуковые данные указываются в виде массива байтов.
SetAudio(Stream)	Хранит звуковые данные (WaveAudio формат данных) в этом объекте данных. Звуковые данные указываются в виде потока.
SetData(Object)	Сохраняет указанные данные в этом объекте данных, автоматически определяя формат данных из исходного типа объекта.
SetData(String, Object, Boolean)	Сохраняет указанные данные в этом объекте данных, а также один или несколько указанных форматов данных. Эта перегрузка содержит флаг, указывающий Boolean , можно ли преобразовать данные в другой формат при извлечении.
SetData(String, Object)	Сохраняет указанные данные в этом объекте данных, а также один или несколько указанных форматов данных; Формат данных указывается строкой.
SetData(Type, Object)	Сохраняет указанные данные в этом объекте данных, а также один или несколько указанных форматов данных; Формат данных указывается Type объектом.
SetDataAsJson<T>(String, T)	Предоставляет базовую реализацию IDataObject интерфейса, который определяет механизм передачи данных независимо от формата.
SetDataAsJson<T>(T)	Предоставляет базовую реализацию IDataObject интерфейса, который определяет механизм передачи данных независимо от формата.
SetFileDropList(StringCollection)	Хранит FileDrop данные в этом объекте данных. Список удаленных файлов указывается в виде коллекции строк.
SetImage(BitmapSource)	Хранит Bitmap данные в этом объекте данных. Данные изображения указываются как .BitmapSource
SetText(String, TextDataFormat)	Сохраняет текстовые данные в этом объекте данных. Формат текстовых данных, хранящегося в хранилище, указывается с элементом TextDataFormat.
SetText(String)	Хранит UnicodeText данные, указанные в виде строки, в этом объекте данных.
TryGetData<T>(String, Boolean, T)	Предоставляет базовую реализацию IDataObject интерфейса, который определяет механизм передачи данных независимо от формата.
TryGetData<T>(String, Func<TypeName,Type>, Boolean, T)	Предоставляет базовую реализацию IDataObject интерфейса, который определяет механизм передачи данных независимо от формата.
TryGetData<T>(String, T)	Предоставляет базовую реализацию IDataObject интерфейса, который определяет механизм передачи данных независимо от формата.
TryGetData<T>(T)	Предоставляет базовую реализацию IDataObject интерфейса, который определяет механизм передачи данных независимо от формата.

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

Имя	Описание
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)	Передает данные в объект, реализующий этот метод. Этот метод вызывается объектом, содержащим источник данных.

Методы расширения

Имя	Описание
TryGetData<T>(IDataObject, String, Boolean, T)	Предоставляет базовую реализацию IDataObject интерфейса, который определяет механизм передачи данных независимо от формата.
TryGetData<T>(IDataObject, String, Func<TypeName,Type>, Boolean, T)	Предоставляет базовую реализацию IDataObject интерфейса, который определяет механизм передачи данных независимо от формата.
TryGetData<T>(IDataObject, String, T)	Предоставляет базовую реализацию IDataObject интерфейса, который определяет механизм передачи данных независимо от формата.
TryGetData<T>(IDataObject, T)	Предоставляет базовую реализацию IDataObject интерфейса, который определяет механизм передачи данных независимо от формата.

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

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