IDataObject IDataObject IDataObject IDataObject Interface

Определение

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

public interface class IDataObject
[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject
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) GetData(String) GetData(String) GetData(String)

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

GetData(Type) GetData(Type) GetData(Type) GetData(Type)

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

GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean) 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.

GetDataPresent(String) GetDataPresent(String) GetDataPresent(String) GetDataPresent(String)

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

GetDataPresent(Type) GetDataPresent(Type) GetDataPresent(Type) GetDataPresent(Type)

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

GetDataPresent(String, Boolean) GetDataPresent(String, Boolean) GetDataPresent(String, Boolean) 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.

GetFormats() GetFormats() GetFormats() GetFormats()

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

GetFormats(Boolean) GetFormats(Boolean) GetFormats(Boolean) 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) SetData(Object) SetData(Object) SetData(Object)

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

SetData(String, Object) SetData(String, Object) SetData(String, Object) SetData(String, Object)

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

SetData(Type, Object) SetData(Type, Object) SetData(Type, Object) SetData(Type, Object)

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

SetData(String, Boolean, Object) SetData(String, Boolean, Object) SetData(String, Boolean, Object) 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.

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

Дополнительно