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 seguinte exemplo de código adiciona dados num DataObject. Primeiro, um novo DataObject é criado e um componente é armazenado nele. Depois, verifica se existem dados do tipo apropriado no DataObject. O resultado é apresentado numa caixa de texto. Este código exige que isso 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 exemplo seguinte recupera os dados armazenados num DataObject. Primeiro, é criado um novo DataObject com dados de texto. Depois, os dados são recuperados, especificando o seu formato como uma cadeia de caracteres, e apresentados numa caixa de texto. O formato de dados é automaticamente convertido de texto para string. Este código exige que isso 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

Observações

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

A DataObject é normalmente usado com e Clipboard em operações de arrastar e largar. A DataObject classe fornece a implementação recomendada da IDataObject interface. Sugere-se que use a DataObject disciplina em vez de se aplicar IDataObject a si próprio.

Múltiplos dados em diferentes formatos podem ser armazenados num DataObject. Os dados são recuperados de a DataObject pelo formato associado. Como a aplicação alvo pode não ser conhecida, pode aumentar a probabilidade de os dados estarem no formato apropriado para uma aplicação colocando os dados em DataObject vários formatos. Veja DataFormats os formatos pré-definidos. Podes implementar o teu próprio formato criando uma instância da DataFormats.Format classe.

Para armazenar dados num DataObject, passe os dados ao construtor ou chame SetData. Pode adicionar dados em vários formatos ao mesmo DataObject. Se quiser que os dados que adiciona sejam recuperados apenas no seu formato nativo, ligue SetData(String, Boolean, Object) com o autoConvert parâmetro definido como false.

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

Para determinar em que formatos os dados estão armazenados, chame GetFormats. Para determinar se existe um formato disponível, ligue GetDataPresent pelo formato desejado.

A DataObject aula fornece métodos adicionais que facilitam o trabalho com dados em formatos comuns. Para adicionar dados de um determinado formato ao DataObject, use o método Format apropriadoSet, como SetText. Para recuperar dados de um determinado formato a partir do DataObject, chame primeiro o método Format apropriado Contains (como ContainsText) para determinar se o DataObject contém dados nesse formato, depois chame o método Format apropriado Get (como GetText) para recuperar os dados se o DataObject contiver.

Ver também

• Clipboard
• IDataObject
• DataFormats