IDataObject Интерфейс

Определение

Предоставляет не зависящий от формата механизм передачи данных.Provides a format-independent mechanism for transferring data.

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

Комментарии

IDataObjectИнтерфейс используется Clipboard классом и в операциях перетаскивания.The IDataObject interface is used by the Clipboard class and in drag-and-drop operations.

При реализации в классе IDataObject методы позволяют пользователю хранить данные в нескольких форматах в экземпляре класса.When implemented in a class, the IDataObject methods allow the user to store data in multiple formats in an instance of the class. Хранение данных в нескольких форматах повышает вероятность того, что целевое приложение, чьи требования к формату могут быть незнакомыми, может получить хранимые данные.Storing data in more than one format increases the chance that a target application, whose format requirements you might not know, can retrieve the stored data. Чтобы сохранить данные в экземпляре IDataObject , вызовите SetData метод и укажите формат данных в format параметре.To store data in an instance of IDataObject, call the SetData method and specify the data format in the format parameter. Установите autoConvert параметр в значение, false если не нужно, чтобы сохраненные данные были преобразованы в другой формат при извлечении.Set the autoConvert parameter to false if you do not want stored data to be converted to another format when it is retrieved. Вызовите SetData несколько раз в одном экземпляре IDataObject для хранения данных более чем в одном формате.Invoke SetData multiple times on one instance of IDataObject to store data in more than one format.

Хранимые данные извлекаются из объекта IDataObject путем вызова GetData метода и указания формата данных в format параметре.You retrieve stored data from an IDataObject by calling the GetData method and specifying the data format in the format parameter. Задайте для autoConvert параметра значение, false чтобы получить только данные, сохраненные в указанном формате.Set the autoConvert parameter to false to retrieve only data that was stored in the specified format. Для преобразования сохраненных данных в указанный формат задайте значение autoConvert true или не используйте autoConvert .To convert the stored data to the specified format, set autoConvert to true, or do not use autoConvert.

Чтобы определить форматы данных, хранящихся в IDataObject , используйте следующие IDataObject методы.To determine the formats of the data stored in an IDataObject, use the following IDataObject methods.

  • Вызовите GetFormats метод, чтобы получить массив всех форматов, в которых доступны данные.Call the GetFormats method to retrieve an array of all the formats in which the data is available. Задайте для autoConvert параметра значение, false чтобы получить только те форматы, в которых хранятся данные.Set the autoConvert parameter to false to get only the formats in which the data is stored. Чтобы получить все форматы, в которых доступны данные, задайте для значение autoConvert true или не используйте этот параметр.To get all the formats in which the data is available, set autoConvert to true, or do not use this parameter.

  • Вызовите GetDataPresent метод, чтобы определить, доступны ли сохраненные данные в определенном формате.Call the GetDataPresent method to determine whether stored data is available in a certain format. Если вы не хотите, чтобы сохраненные данные были преобразованы в указанный формат, присвойте autoConvert параметру значение false .If you do not want stored data to be converted to the specified format, set the autoConvert parameter to false.

См DataObject . класс для реализации этого интерфейса.See the DataObject class for an implementation of this interface. См DataFormats . класс для предопределенных Clipboard форматов данных.See the DataFormats class for the predefined Clipboard data formats.

Методы

GetData(String)

Получает данные, связанные с заданным форматом.Retrieves the data associated with the specified data format.

GetData(String, Boolean)

Получает данные, связанные с указанным форматом данных, используя значение типа Boolean для определения необходимости преобразования данных в этот формат.Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

GetData(Type)

Получает данные, связанные с заданным форматом типа класса.Retrieves the data associated with the specified class type format.

GetDataPresent(String)

Определяет, связаны ли хранимые в данном экземпляре данные с указанным форматом или возможно ли их преобразование в этот формат.Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetDataPresent(String, Boolean)

Определяет, связаны ли хранимые в данном экземпляре данные с указанным форматом, определяя с помощью значения типа Boolean, необходимо ли преобразовать данные в этот формат.Determines whether data stored in this instance is associated with the specified format, using a Boolean value to determine whether to convert the data to the format.

GetDataPresent(Type)

Определяет, связаны ли хранимые в данном экземпляре данные с указанным форматом или возможно ли их преобразование в этот формат.Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetFormats()

Возвращает список всех форматов, с которыми связаны данные, хранящиеся в этом экземпляре, или в которые они могут быть преобразованы.Returns a list of all formats that data stored in this instance is associated with or can be converted to.

GetFormats(Boolean)

Получает список всех форматов, с которыми связаны хранимые в этом экземпляре данные или в которые они могут быть преобразованы. С помощью значения типа Boolean определяется, необходимо ли извлечь все форматы, в которые данные могут быть преобразованы, или только собственные форматы данных.Gets a list of all formats that data stored in this instance is associated with or can be converted to, using a Boolean value to determine whether to retrieve all formats that the data can be converted to or only native data formats.

SetData(Object)

Сохраняет указанные данные в этом экземпляре, используя класс данных для формата.Stores the specified data in this instance, using the class of the data for the format.

SetData(String, Boolean, Object)

Сохраняет указанные данные и связанный с ними формат в этом экземпляре и в значении типа Boolean задает, возможно ли преобразование данных в другой формат.Stores the specified data and its associated format in this instance, using a Boolean value to specify whether the data can be converted to another format.

SetData(String, Object)

Сохраняет указанные данные и связанный с ними формат в этом экземпляре.Stores the specified data and its associated format in this instance.

SetData(Type, Object)

Сохраняет указанные данные и связанный с ними тип класса в этом экземпляре.Stores the specified data and its associated class type in this instance.

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

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