DataObject Classe

Definizione

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

Ereditarietà

Object

DataObject

Attributi

ClassInterfaceAttribute

Implementazioni

IDataObject IDataObject

Esempio

Nell'esempio di codice seguente vengono aggiunti dati in un oggetto DataObject. Prima di tutto, viene creato un nuovo DataObject oggetto e ne viene archiviato un componente. Verifica quindi se i dati nel tipo appropriato sono presenti in DataObject. Il risultato viene visualizzato in una casella di testo. Questo codice richiede che textBox1 sia stato creato.

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

Nell'esempio seguente vengono recuperati i dati archiviati in un oggetto DataObject. Prima di tutto, viene creato un nuovo DataObject oggetto con dati di testo. I dati vengono quindi recuperati, specificandone il formato come stringa e visualizzati in una casella di testo. Il formato dei dati viene convertito automaticamente da testo a stringa. Questo codice richiede che textBox1 sia stato creato.

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

Commenti

DataObject implementa l'interfaccia IDataObject , i cui metodi forniscono un meccanismo indipendente dal formato per il trasferimento dei dati.

Un DataObject oggetto viene in genere usato con e Clipboard nelle operazioni di trascinamento della selezione. La DataObject classe fornisce l'implementazione consigliata dell'interfaccia IDataObject . È consigliabile usare la DataObject classe anziché implementare IDataObject manualmente.

È possibile archiviare più parti di dati in formati diversi in un oggetto DataObject. I dati vengono recuperati da un DataObject oggetto in base al formato associato. Poiché l'applicazione di destinazione potrebbe non essere nota, è possibile aumentare la probabilità che i dati siano nel formato appropriato per un'applicazione inserendo i dati in un DataObject oggetto in più formati. Vedere DataFormats per i formati predefiniti. È possibile implementare un formato personalizzato creando un'istanza della DataFormats.Format classe .

Per archiviare i dati in un DataObjectoggetto , passare i dati al costruttore o chiamare SetData. È possibile aggiungere dati in più formati allo stesso DataObjectoggetto . Se si desidera che i dati aggiunti vengano recuperati solo nel formato nativo, chiamare SetData(String, Boolean, Object) con il autoConvert parametro impostato su false.

I dati possono essere recuperati da un DataObject oggetto in qualsiasi formato compatibile con GetData. Ad esempio, il testo può essere convertito in Unicode. Per recuperare i dati nel formato in cui è stato archiviato, chiamare GetData con il autoConvert parametro impostato su false.

Per determinare i formati in cui vengono archiviati i dati, chiamare GetFormats. Per determinare se è disponibile un formato, chiamare GetDataPresent con il formato desiderato.

In .NET Framework 2.0 la DataObject classe fornisce metodi aggiuntivi che semplificano l'uso dei dati in formati comuni. Per aggiungere dati di un formato specifico a DataObject, utilizzare il metodo Format appropriatoSet, ad esempio SetText. Per recuperare i dati di un formato specifico da DataObject, chiamare innanzitutto il metodo Format appropriato (ad esempio ContainsText) per determinare se DataObject contiene dati in tale formato, quindi chiamare il metodo Format appropriato GetContains (ad esempio GetText) per recuperare i dati se DataObject contiene.

Costruttori

Metodi

Implementazioni dell'interfaccia esplicita

Si applica a

Vedi anche

• Clipboard
• IDataObject
• DataFormats