DataObject Klasse

Definition

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

Vererbung

Object

DataObject

Attribute

ClassInterfaceAttribute

Implementiert

IDataObject IDataObject

Beispiele

Im folgenden Codebeispiel werden Daten in einem DataObjecthinzugefügt. Zunächst wird ein neues DataObject erstellt und eine Komponente darin gespeichert. Anschließend wird überprüft, ob daten im entsprechenden Typ vorhanden sind DataObject. Das Ergebnis wird in einem Textfeld angezeigt. Dieser Code erfordert, dass textBox1 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 einem DataObjectgespeicherten Daten abgerufen. Zunächst wird ein neues DataObject mit Textdaten erstellt. Anschließend werden die Daten abgerufen, ihr Format als Zeichenfolge angegeben und in einem Textfeld angezeigt. Das Datenformat wird automatisch von Text in Zeichenfolge konvertiert. Dieser Code erfordert, dass textBox1 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 und Clipboard in Drag-and-Drop-Vorgängen verwendet. Die DataObject -Klasse stellt die empfohlene Implementierung der Schnittstelle bereit IDataObject . Es wird empfohlen, die DataObject -Klasse zu verwenden, anstatt sich selbst zu implementieren IDataObject .

Mehrere Datenteile in unterschiedlichen Formaten können in einem DataObjectgespeichert werden. Daten werden aus einem DataObject durch das zugehörige Format abgerufen. Da die Zielanwendung möglicherweise nicht bekannt ist, können Sie die Wahrscheinlichkeit erhöhen, dass die Daten im für eine Anwendung geeigneten Format vorliegen, indem Sie die Daten in einem DataObject in mehreren Formaten platzieren. Die vordefinierten Formate finden Sie unter DataFormats . Sie können Ihr eigenes Format implementieren, indem Sie eine instance der DataFormats.Format -Klasse erstellen.

Um Daten in einem DataObjectzu speichern, übergeben Sie die Daten an den Konstruktor, oder rufen Sie auf SetData. Sie können Demselben DataObjectDaten in mehreren Formaten hinzufügen. Wenn die hinzugefügten Daten nur im nativen Format abgerufen werden sollen, rufen Sie SetData(String, Boolean, Object) auf, wobei der autoConvert Parameter auf falsefestgelegt ist.

Daten können aus einem in einem DataObject beliebigen Format abgerufen werden, das mit GetDatakompatibel ist. Beispielsweise kann Text in Unicode konvertiert werden. Um Daten in dem Format abzurufen, in dem sie gespeichert wurden, rufen Sie GetData auf, wobei der autoConvert Parameter auf falsefestgelegt ist.

Rufen GetFormatsSie auf, um zu bestimmen, in welchen Formaten die Daten gespeichert werden. Um zu ermitteln, ob ein Format verfügbar ist, rufen Sie GetDataPresent mit dem gewünschten Format auf.

In .NET Framework 2.0 stellt die DataObject -Klasse zusätzliche Methoden bereit, die das Arbeiten mit Daten in gängigen Formaten erleichtern. Um Daten eines bestimmten Formats zu hinzufügen, verwenden Sie die DataObjectentsprechende SetFormat-Methode , z SetText. B. . Um Daten eines bestimmten Formats aus DataObjectabzurufen, rufen Sie zuerst die entsprechende ContainsFormat-Methode (z ContainsText. B. ) auf, um zu bestimmen, ob die DataObject Daten in diesem Format enthält, und rufen Sie dann die entsprechende GetFormat-Methode (z GetText. B. ) auf, um die Daten abzurufen, wenn die DataObject diese enthält.

Konstruktoren

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

• Clipboard
• IDataObject
• DataFormats