DataObject Klasse

Definition

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

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

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

[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)]
public class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.Forms.ITypedDataObject

[<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 ITypedDataObject
    interface IDataObject
    interface IDataObject.Interface
    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

Public Class DataObject
Implements IDataObject, ITypedDataObject

Vererbung

Object

DataObject

Attribute

ClassInterfaceAttribute

Implementiert

IDataObject IDataObject ITypedDataObject

Beispiele

Im folgenden Codebeispiel werden Daten in einer DataObject. Zunächst wird eine neue DataObject erstellt und eine Komponente darin gespeichert. Anschließend wird überprüft, ob Daten im entsprechenden Typ in der DataObjectDatei vorhanden sind. Das Ergebnis wird in einem Textfeld angezeigt. Dieser Code erfordert, dass textBox1 er erstellt wurde.

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

Im nächsten Beispiel werden die in einer DataObjectDatei gespeicherten Daten abgerufen. Zunächst wird ein neues DataObject mit Textdaten erstellt. Anschließend werden die Daten abgerufen, das Format als Zeichenfolge angegeben und in einem Textfeld angezeigt. Das Datenformat wird automatisch von Text in Zeichenfolge konvertiert. Dieser Code erfordert, dass textBox1 er erstellt wurde.

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

Hinweise

DataObject implementiert die IDataObject Schnittstelle, deren Methoden einen formatunabhängigen Mechanismus für die Datenübertragung bereitstellen.

A DataObject wird in der Regel mit den Clipboard Drag-and-Drop-Vorgängen verwendet. Die DataObject Klasse stellt die empfohlene Implementierung der IDataObject Schnittstelle bereit. Es wird empfohlen, die DataObject Klasse zu verwenden, anstatt sich selbst zu implementieren IDataObject .

Mehrere Datenteile in unterschiedlichen Formaten können in einem DataObject. Daten werden aus einem DataObject zugeordneten Format abgerufen. Da die Zielanwendung möglicherweise nicht bekannt ist, können Sie die Wahrscheinlichkeit erhöhen, dass die Daten im geeigneten Format für eine Anwendung vorliegen, indem Sie die Daten in mehreren DataObject Formaten platzieren. Siehe DataFormats die vordefinierten Formate. Sie können Ihr eigenes Format implementieren, indem Sie eine Instanz der DataFormats.Format Klasse erstellen.

Zum Speichern von Daten in einem DataObject, übergeben Sie die Daten an den Konstruktor oder Aufruf SetData. Sie können Daten in mehreren Formaten zu demselben DataObjecthinzufügen. Wenn die Daten, die Sie hinzufügen, nur im systemeigenen Format abgerufen werden sollen, rufen SetData(String, Boolean, Object) Sie den autoConvert Parameter auf .false

Daten können aus einem DataObject beliebigen Format abgerufen werden, das mit GetDatadem Format kompatibel ist. Beispielsweise kann Text in Unicode konvertiert werden. Rufen Sie auf GetData , um Daten im Format abzurufen, in dem sie gespeichert wurde, den autoConvert Parameter auf false.

Rufen Sie auf, um GetFormatszu bestimmen, in welchen Formaten die Daten gespeichert werden. Um festzustellen, ob ein Format verfügbar ist, rufen Sie GetDataPresent das gewünschte Format auf.

Die DataObject Klasse bietet zusätzliche Methoden, die das Arbeiten mit Daten in gängigen Formaten vereinfachen. Verwenden Sie zum Hinzufügen von Daten eines bestimmten Formats zur DataObjectentsprechenden SetFormatmethode , z SetText. B. . Rufen Sie zum Abrufen von Daten eines bestimmten Formats zuerst DataObjectdie entsprechende ContainsFormatmethode (z ContainsText. B. ) auf, um zu bestimmen, ob die Daten in diesem DataObject Format enthalten sind, und rufen Sie dann die entsprechende GetFormatmethode (z GetText. B. ) auf, um die Daten abzurufen, wenn sie DataObject enthalten sind.

Weitere Informationen

• Clipboard
• IDataObject
• DataFormats