IDataObject Интерфейс

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Предоставляет не зависящий от формата механизм передачи данных.

public interface class IDataObject

public interface IDataObject

type IDataObject = interface

Public Interface IDataObject

Производный

System.Windows.Forms.DataObject

Комментарии

Интерфейс IDataObject используется классом Clipboard и в операциях перетаскивания.

При реализации в классе IDataObject методы позволяют пользователю хранить данные в нескольких форматах в экземпляре класса . Хранение данных в нескольких форматах повышает вероятность того, что целевое приложение, требования к формату которого не известны, сможет получить сохраненные данные. Чтобы сохранить данные в экземпляре IDataObject, вызовите SetData метод и укажите формат данных в параметре format . Присвойте параметру autoConvert значение , false если вы не хотите, чтобы сохраненные данные при их извлечении преобразовылись в другой формат. Вызовите SetData несколько раз в одном экземпляре для хранения данных в нескольких IDataObject форматах.

Вы извлекаете сохраненные данные из , IDataObject вызывая GetData метод и указывая формат данных в параметре format . Присвойте autoConvert параметру значение , false чтобы получить только данные, хранящиеся в указанном формате. Чтобы преобразовать сохраненные данные в указанный формат, задайте значение autoConverttrueили не используйте autoConvert.

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

• Вызовите метод , GetFormats чтобы получить массив всех форматов, в которых доступны данные. autoConvert Задайте для параметра значение , false чтобы получить только форматы, в которых хранятся данные. Чтобы получить все форматы, в которых доступны данные, задайте значение autoConverttrueили не используйте этот параметр.

• Вызовите метод , GetDataPresent чтобы определить, доступны ли сохраненные данные в определенном формате. Если вы не хотите преобразовывать сохраненные данные в указанный формат, задайте autoConvert для параметра значение false.

См. DataObject класс для реализации этого интерфейса. Стандартные форматы данных см. в DataFormatsClipboard классе .

Методы

GetData(String)	Получает данные, связанные с заданным форматом.
GetData(String, Boolean)	Получает данные, связанные с указанным форматом данных, используя значение типа Boolean для определения необходимости преобразования данных в этот формат.
GetData(Type)	Получает данные, связанные с заданным форматом типа класса.
GetDataPresent(String)	Определяет, связаны ли хранимые в данном экземпляре данные с указанным форматом или возможно ли их преобразование в этот формат.
GetDataPresent(String, Boolean)	Определяет, связаны ли хранимые в данном экземпляре данные с указанным форматом, определяя с помощью значения типа Boolean, необходимо ли преобразовать данные в этот формат.
GetDataPresent(Type)	Определяет, связаны ли хранимые в данном экземпляре данные с указанным форматом или возможно ли их преобразование в этот формат.
GetFormats()	Возвращает список всех форматов, с которыми связаны данные, хранящиеся в этом экземпляре, или в которые они могут быть преобразованы.
GetFormats(Boolean)	Получает список всех форматов, с которыми связаны хранимые в этом экземпляре данные или в которые они могут быть преобразованы. С помощью значения типа Boolean определяется, необходимо ли извлечь все форматы, в которые данные могут быть преобразованы, или только собственные форматы данных.
SetData(Object)	Сохраняет указанные данные в этом экземпляре, используя класс данных для формата.
SetData(String, Boolean, Object)	Сохраняет указанные данные и связанный с ними формат в этом экземпляре и в значении типа Boolean задает, возможно ли преобразование данных в другой формат.
SetData(String, Object)	Сохраняет указанные данные и связанный с ними формат в этом экземпляре.
SetData(Type, Object)	Сохраняет указанные данные и связанный с ними тип класса в этом экземпляре.

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

• DataObject
• DataFormats