Exportar (0) Imprimir
Expandir todo

IDataObject (Interfaz)

Proporciona un mecanismo para transferir datos que es independiente del formato.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

[ComVisibleAttribute(true)] 
public interface IDataObject
/** @attribute ComVisibleAttribute(true) */ 
public interface IDataObject
ComVisibleAttribute(true) 
public interface IDataObject
No aplicable.

La clase IDataObject utiliza la interfaz Clipboard y además también se utiliza en las operaciones de arrastrar y colocar.

Cuando se implementan en una clase, los métodos de IDataObject permiten al usuario almacenar datos en varios formatos en una instancia de la clase. Al almacenar los datos en más de un formato, existen más posibilidades de que una aplicación de destino, cuyos requisitos de formato es posible que se desconozcan, pueda recuperar los datos almacenados. Para almacenar los datos en una instancia de IDataObject, hay que llamar al método SetData y especificar el formato de los datos en el parámetro format. Establezca el parámetro autoConvert en false si no desea que los datos almacenados se conviertan a otro formato cuando se recuperen. Para almacenar los datos en más de un formato, hay que invocar a SetData varias veces en una instancia de IDataObject.

Para recuperar los datos almacenados desde IDataObject, hay que llamar al método GetData y especificar el formato de los datos en el parámetro format. Para recuperar sólo los datos que se almacenaron en el formato especificado, establezca el parámetro autoConvert en false. Para convertir los datos almacenados al formato especificado, hay que establecer autoConvert en true o no utilizar autoConvert.

Para determinar los formatos de los datos almacenados en IDataObject, hay que utilizar los siguientes métodos IDataObject.

  • Se llama al método GetFormats para recuperar una matriz de todos los formatos en los que están disponibles los datos. Para obtener sólo aquellos formatos donde se han almacenado los datos, establezca el parámetro autoConvert en false. Para obtener todos los formatos en que están disponibles los datos, establezca autoConvert en true o no utilice este parámetro.

  • Para determinar si los datos almacenados están disponibles en un formato concreto, hay que llamar al método GetDataPresent. Establezca el parámetro autoConvert en false si no desea que los datos almacenados se conviertan al formato especificado.

Vea una implementación de esta interfaz en la clase DataObject. Vea en la clase DataFormats los formatos de datos Clipboard predefinidos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0
Mostrar:
© 2014 Microsoft