DataObject Clase

Definición

public ref class DataObject : System::Windows::Forms::IDataObject

public ref class DataObject : System::Runtime::InteropServices::ComTypes::IDataObject, System::Windows::Forms::IDataObject

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
public class DataObject : System.Windows.Forms.IDataObject

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
public class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.Forms.IDataObject

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type DataObject = class
    interface IDataObject
    interface UnsafeNativeMethods.IOleDataObject

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type DataObject = class
    interface IDataObject
    interface IDataObject

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type DataObject = class
    interface IDataObject
    interface IDataObject
    interface IDataObject.Interface

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type DataObject = class
    interface IDataObject
    interface IDataObject.Interface
    interface IDataObject

Public Class DataObject
Implements IDataObject

Public Class DataObject
Implements IDataObject, IDataObject

Herencia

Object

DataObject

Atributos

ClassInterfaceAttribute

Implementaciones

IDataObject IDataObject

Ejemplos

En el ejemplo de código siguiente se agregan datos en .DataObject En primer lugar, se crea un nuevo DataObject y se almacena un componente en él. A continuación, comprueba si existen datos en el tipo adecuado en .DataObject El resultado se muestra en un cuadro de texto. Este código requiere que textBox1 se haya creado.

private:
   void AddMyData3()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a new data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds the component to the DataObject.
      myDataObject->SetData( myComponent );
      
      // Prints whether data of the specified type is in the DataObject.
      Type^ myType = myComponent->GetType();
      if ( myDataObject->GetDataPresent( myType ) )
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is present in the DataObject" );
      }
      else
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is not present in the DataObject" );
      }
   }

private void AddMyData3() {
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Creates a new data object.
    DataObject myDataObject = new DataObject();
 
    // Adds the component to the DataObject.
    myDataObject.SetData(myComponent);
 
    // Prints whether data of the specified type is in the DataObject.
    Type myType = myComponent.GetType();
    if(myDataObject.GetDataPresent(myType))
       textBox1.Text = "Data of type " + myType.ToString() + 
       " is present in the DataObject";
    else
       textBox1.Text = "Data of type " + myType.ToString() +
       " is not present in the DataObject";
 }

Private Sub AddMyData3()
    ' Creates a component to store in the data object.
    Dim myComponent As New Component()
    
    ' Creates a new data object.
    Dim myDataObject As New DataObject()
    
    ' Adds the component to the DataObject.
    myDataObject.SetData(myComponent)
    
    ' Prints whether data of the specified type is in the DataObject.
    Dim myType As Type = myComponent.GetType()
    If myDataObject.GetDataPresent(myType) Then
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is present in the DataObject"
    Else
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is not present in the DataObject"
    End If
End Sub

En el ejemplo siguiente se recuperan los datos almacenados en .DataObject En primer lugar, se crea un nuevo DataObject con datos de texto. A continuación, los datos se recuperan, especifican su formato como una cadena y se muestran en un cuadro de texto. El formato de datos se convierte automáticamente de texto a cadena. Este código requiere que textBox1 se haya creado.

void GetMyData2()
{
   // Creates a new data object using a string and the text format.
   DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"Text to Store" );
   
   // Prints the string in a text box.
   textBox1->Text = myDataObject->GetData( DataFormats::Text )->ToString();
}

private void GetMyData2() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "Text to Store");
 
    // Prints the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString();
 }

Private Sub GetMyData2()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "Text to Store")
    
    ' Prints the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString()
End Sub

Comentarios

DataObject implementa la IDataObject interfaz , cuyos métodos proporcionan un mecanismo independiente del formato para la transferencia de datos.

DataObject Normalmente se usa con las operaciones de Clipboard arrastrar y colocar. La DataObject clase proporciona la implementación recomendada de la IDataObject interfaz . Se recomienda usar la DataObject clase en lugar de implementarse IDataObject usted mismo.

Varios fragmentos de datos en distintos formatos se pueden almacenar en .DataObject Los datos se recuperan de un DataObject objeto mediante su formato asociado. Dado que es posible que no se conozca la aplicación de destino, puede aumentar la probabilidad de que los datos estén en el formato adecuado para una aplicación colocando los datos en un DataObject en varios formatos. Consulte DataFormats para conocer los formatos predefinidos. Puede implementar su propio formato creando una instancia de la DataFormats.Format clase .

Para almacenar datos en , DataObjectpase los datos al constructor o llame SetDataa . Puede agregar datos en varios formatos al mismo DataObject. Si desea que los datos que agregue se recuperen solo en su formato nativo, llame a SetData(String, Boolean, Object) con el autoConvert parámetro establecido en false.

Los datos se pueden recuperar de en DataObject cualquier formato que sea compatible con GetData. Por ejemplo, el texto se puede convertir en Unicode. Para recuperar datos en el formato en el que se almacenó, llame a GetData con el autoConvert parámetro establecido falseen .

Para determinar en qué formatos se almacenan los datos, llame a GetFormats. Para determinar si hay un formato disponible, llame a GetDataPresent con el formato deseado.

En .NET Framework 2.0, la DataObject clase proporciona métodos adicionales que facilitan el trabajo con datos en formatos comunes. Para agregar datos de un formato determinado a DataObject, use el método Format adecuadoSet, como SetText. Para recuperar datos de un formato determinado de DataObject, primero llame al método Format adecuado Contains (por ContainsTextejemplo, ) para determinar si DataObject contiene datos en ese formato y, a continuación, llame al método Format adecuado Get (por GetTextejemplo, ) para recuperar los datos si lo DataObject contiene.

Constructores

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

• Clipboard
• IDataObject
• DataFormats