IDataObject Интерфейс

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

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

public interface class IDataObject
[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject
[<System.Runtime.InteropServices.ComVisible(true)>]
type IDataObject = interface
Public Interface IDataObject
Производный
Атрибуты
ComVisibleAttribute

Комментарии

Интерфейс 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 класс для реализации этого интерфейса. См. DataFormats класс для стандартных Clipboard форматов данных.

Методы

Имя Описание
GetData(String, Boolean)

Извлекает данные, связанные с указанным форматом данных, используя логическое значение, чтобы определить, следует ли преобразовать данные в формат.
GetData(String)

Извлекает данные, связанные с указанным форматом данных.
GetData(Type)

Извлекает данные, связанные с указанным форматом типа класса.
GetDataPresent(String, Boolean)

Определяет, связаны ли данные, хранящиеся в этом экземпляре, с указанным форматом, используя логическое значение, чтобы определить, следует ли преобразовать данные в формат.
GetDataPresent(String)

Определяет, связаны ли данные, хранящиеся в этом экземпляре, или можно ли преобразовать в указанный формат.
GetDataPresent(Type)

Определяет, связаны ли данные, хранящиеся в этом экземпляре, или можно ли преобразовать в указанный формат.
GetFormats()

Возвращает список всех форматов, в которые данные, хранящиеся в этом экземпляре, связаны или могут быть преобразованы в.
GetFormats(Boolean)

Получает список всех форматов, с которыми данные, хранящиеся в этом экземпляре, связаны или могут быть преобразованы, используя логическое значение для определения того, можно ли получить все форматы, которые данные можно преобразовать в или только собственные форматы данных.
SetData(Object)

Хранит указанные данные в этом экземпляре, используя класс данных для формата.
SetData(String, Boolean, Object)

Сохраняет указанные данные и связанный с ним формат в этом экземпляре, используя логическое значение, чтобы указать, можно ли преобразовать данные в другой формат.
SetData(String, Object)

Хранит указанные данные и связанный с ним формат в этом экземпляре.
SetData(Type, Object)

Хранит указанные данные и связанный с ним тип класса в этом экземпляре.

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

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