DataObject Klass

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

Arv

Object

DataObject

Attribut

ClassInterfaceAttribute

Implementeringar

IDataObject IDataObject ITypedDataObject

Exempel

Följande kodexempel lägger till data i en DataObject. Först skapas en ny DataObject och en komponent lagras i den. Sedan kontrollerar den om data i lämplig typ finns i DataObject. Resultatet visas i en textruta. Den här koden kräver att den textBox1 har skapats.

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

I nästa exempel hämtas data som lagras i en DataObject. Först skapas en ny DataObject med textdata. Sedan hämtas data, anger dess format som en sträng och visas i en textruta. Dataformatet konverteras automatiskt från text till sträng. Den här koden kräver att den textBox1 har skapats.

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

Kommentarer

DataObject implementerar IDataObject gränssnittet, vars metoder tillhandahåller en formatoberoende mekanism för dataöverföring.

A DataObject används vanligtvis med Clipboard och i dra och släpp-åtgärder. Klassen DataObject tillhandahåller den rekommenderade implementeringen av IDataObject gränssnittet. Vi föreslår att du använder DataObject klassen i stället för att implementera IDataObject dig själv.

Flera datadelar i olika format kan lagras i en DataObject. Data hämtas från en DataObject med dess associerade format. Eftersom målprogrammet kanske inte är känt kan du öka sannolikheten för att data kommer att vara i rätt format för ett program genom att placera data i flera DataObject format. Se DataFormats för de fördefinierade formaten. Du kan implementera ditt eget format genom att skapa en instans av DataFormats.Format klassen.

Om du vill lagra data i en DataObjectskickar du data till konstruktorn eller anropar SetData. Du kan lägga till data i flera format till samma DataObject. Om du vill att de data som du lägger till endast ska hämtas i dess interna format anropar du SetData(String, Boolean, Object) med parametern autoConvert inställd på false.

Data kan hämtas från en DataObject i valfritt format som är kompatibelt med GetData. Text kan till exempel konverteras till Unicode. Om du vill hämta data i det format som den lagrades i anropar du GetData med parametern autoConvert inställd på false.

Om du vill ta reda på vilka format data lagras i anropar du GetFormats. För att avgöra om ett format är tillgängligt anropar du GetDataPresent med önskat format.

Klassen DataObject innehåller ytterligare metoder som gör det enklare att arbeta med data i vanliga format. Om du vill lägga till data i ett visst format i DataObjectanvänder du lämplig Setformatmetod , till exempel SetText. Om du vill hämta data med ett visst format från DataObjectanropar du först lämplig ContainsFormat-metod (till exempel ContainsText) för att avgöra om DataObject innehåller data i det formatet och anropar sedan lämplig Getformatmetod (till exempel GetText) för att hämta data om innehåller DataObject dem.

Se även

• Clipboard
• IDataObject
• DataFormats