IDataObject Interfaz

Definición

Proporciona un mecanismo para transferir datos que es independiente del formato.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
Derivado
Atributos

Comentarios

La IDataObject Clipboard clase utiliza la interfaz y en las operaciones de arrastrar y colocar.The IDataObject interface is used by the Clipboard class and in drag-and-drop operations.

Cuando se implementa en una clase, IDataObject los métodos permiten al usuario almacenar datos en varios formatos en una instancia de la clase.When implemented in a class, the IDataObject methods allow the user to store data in multiple formats in an instance of the class. El almacenamiento de datos en más de un formato aumenta la posibilidad de que una aplicación de destino, cuyos requisitos de formato no sepa, pueda recuperar los datos almacenados.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. Para almacenar datos en una instancia de IDataObject, llame al SetData método y especifique el formato de los datos format en el parámetro.To store data in an instance of IDataObject, call the SetData method and specify the data format in the format parameter. Establezca el autoConvert parámetro en false si no desea que los datos almacenados se conviertan a otro formato cuando se recupere.Set the autoConvert parameter to false if you do not want stored data to be converted to another format when it is retrieved. Invocar SetData varias veces en una instancia IDataObject de para almacenar datos en más de un formato.Invoke SetData multiple times on one instance of IDataObject to store data in more than one format.

Recupera los datos almacenados de un IDataObject GetData llamando al método y especificando el formato de datos en el format parámetro.You retrieve stored data from an IDataObject by calling the GetData method and specifying the data format in the format parameter. Establezca el autoConvert parámetro en false para recuperar únicamente los datos que se almacenaron en el formato especificado.Set the autoConvert parameter to false to retrieve only data that was stored in the specified format. Para convertir los datos almacenados al formato especificado, establezca autoConvert en trueo no use autoConvert.To convert the stored data to the specified format, set autoConvert to true, or do not use autoConvert.

Para determinar los formatos de los datos almacenados en IDataObject, utilice los métodos siguientes. IDataObjectTo determine the formats of the data stored in an IDataObject, use the following IDataObject methods.

  • Llame al GetFormats método para recuperar una matriz de todos los formatos en los que los datos están disponibles.Call the GetFormats method to retrieve an array of all the formats in which the data is available. Establezca el autoConvert false parámetro en para obtener solo los formatos en los que se almacenan los datos.Set the autoConvert parameter to false to get only the formats in which the data is stored. Para obtener todos los formatos en los que los datos están disponibles, autoConvert establezca trueen o no use este parámetro.To get all the formats in which the data is available, set autoConvert to true, or do not use this parameter.

  • Llame al GetDataPresent método para determinar si los datos almacenados están disponibles en un formato determinado.Call the GetDataPresent method to determine whether stored data is available in a certain format. Si no desea que los datos almacenados se conviertan al formato especificado, establezca el autoConvert parámetro en false.If you do not want stored data to be converted to the specified format, set the autoConvert parameter to false.

Vea la DataObject clase para obtener una implementación de esta interfaz.See the DataObject class for an implementation of this interface. Vea la DataFormats clase para obtener los formatos Clipboard de datos predefinidos.See the DataFormats class for the predefined Clipboard data formats.

Métodos

GetData(String)

Recupera los datos asociados al formato de datos especificado.Retrieves the data associated with the specified data format.

GetData(String, Boolean)

Recupera los datos asociados al formato de datos especificado, usando un tipo booleano para determinar si se deben convertir a dicho formato los datos.Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

GetData(Type)

Recupera los datos asociados al formato de tipo de clase especificado.Retrieves the data associated with the specified class type format.

GetDataPresent(String)

Determina si los datos almacenados en esta instancia están asociados al formato especificado o pueden convertirse al formato especificado.Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetDataPresent(String, Boolean)

Determina si los datos almacenados en esta instancia están asociados al formato especificado, usando un valor de tipo booleano para establecer si se deben convertir a ese formato.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)

Determina si los datos almacenados en esta instancia están asociados al formato especificado o pueden convertirse al formato especificado.Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetFormats()

Devuelve una lista de todos los formatos a los que se asocian o a los que pueden convertirse los datos almacenados en esta instancia.Returns a list of all formats that data stored in this instance is associated with or can be converted to.

GetFormats(Boolean)

Obtiene una lista con todos los formatos a los que están asociados o se pueden convertir los datos almacenados en esta instancia, usando un valor de tipo booleano para determinar si se recuperarán sólo los formatos de datos nativos o todos los formatos a los que pueden convertirse los datos.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)

Almacena los datos especificados en esta instancia utilizando la clase de los datos para el formato.Stores the specified data in this instance, using the class of the data for the format.

SetData(String, Boolean, Object)

Almacena los datos especificados y el formato que tienen asociado en esta instancia, usando un valor de tipo booleano para indicar si pueden convertirse los datos a otro formato.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)

Almacena en esta instancia los datos especificados y el formato asociado a estos datos.Stores the specified data and its associated format in this instance.

SetData(Type, Object)

Almacena en esta instancia los datos especificados y el tipo de clase asociado a estos datos.Stores the specified data and its associated class type in this instance.

Se aplica a

Consulte también: