IDataObject Интерфейс

Определение

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

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

Комментарии

Интерфейс 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)

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

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

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