DataObject Classe

Definição

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

Public Class DataObject
Implements IDataObject

Public Class DataObject
Implements IDataObject, IDataObject

Herança

Object

DataObject

Atributos

ClassInterfaceAttribute

Implementações

IDataObject IDataObject

Exemplos

O exemplo de código a seguir adiciona dados em um DataObject. Primeiro, um novo DataObject é criado e um componente é armazenado nele. Em seguida, verifica se há dados no tipo apropriado no DataObject. O resultado é exibido em uma caixa de texto. Esse código requer que textBox1 tenha sido criado.

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

O próximo exemplo recupera os dados armazenados em um DataObject. Primeiro, um novo DataObject é criado com dados de texto. Em seguida, os dados são recuperados, especificando seu formato como uma cadeia de caracteres e exibidos em uma caixa de texto. O formato de dados é convertido automaticamente de texto em cadeia de caracteres. Esse código requer que textBox1 tenha sido criado.

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

Comentários

DataObject implementa a IDataObject interface, cujos métodos fornecem um mecanismo independente de formato para transferência de dados.

Um DataObject é normalmente usado com as Clipboard operações de arrastar e soltar. A DataObject classe fornece a implementação recomendada da IDataObject interface. É sugerido que você use a DataObject classe em vez de IDataObject implementar a si mesmo.

Várias partes de dados em formatos diferentes podem ser armazenadas em um DataObject. Os dados são recuperados de um DataObject por seu formato associado. Como o aplicativo de destino pode não ser conhecido, você pode aumentar a probabilidade de que os dados estejam no formato apropriado para um aplicativo colocando os dados em vários DataObject formatos. Consulte DataFormats os formatos predefinidos. Você pode implementar seu próprio formato criando uma instância da DataFormats.Format classe.

Para armazenar dados em um DataObject, passe os dados para o construtor ou chame SetData. Você pode adicionar dados em vários formatos ao mesmo DataObject. Se você quiser que os dados adicionados sejam recuperados somente em seu formato nativo, chame SetData(String, Boolean, Object) com o autoConvert parâmetro definido como false.

Os dados podem ser recuperados de um DataObject formato compatível com GetData. Por exemplo, o texto pode ser convertido em Unicode. Para recuperar dados no formato em que foram armazenados, chame GetData com o autoConvert parâmetro definido como false.

Para determinar em quais formatos os dados são armazenados, chame GetFormats. Para determinar se um formato está disponível, chame GetDataPresent com o formato desejado.

A DataObject classe fornece métodos adicionais que facilitam o trabalho com dados em formatos comuns. Para adicionar dados de um formato específico ao DataObjectmétodo , use o método format apropriadoSet, como SetText. Para recuperar dados de um formato específico, DataObjectprimeiro chame o método format apropriado Contains (como ContainsText) para determinar se os DataObject dados contêm nesse formato e chame o método format apropriado Get (como GetText) para recuperar os dados se eles os DataObject contiverem.

Confira também

• Clipboard
• IDataObject
• DataFormats