DataObject Třída

Definice

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

Dědičnost

Object

DataObject

Atributy

ClassInterfaceAttribute

Implementuje

IDataObject IDataObject

Příklady

Následující příklad kódu přidá data do DataObject. Nejprve se vytvoří nový DataObject objekt a uloží se do něj komponenta. Pak zkontroluje, jestli v objektu existují data příslušného DataObjecttypu. Výsledek se zobrazí v textovém poli. Tento kód vyžaduje, aby textBox1 byl vytvořen.

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

Další příklad načte data uložená v .DataObject Nejprve se vytvoří nový DataObject s textovými daty. Potom se data načtou, určí se jejich formát jako řetězec a zobrazí se v textovém poli. Formát dat se automaticky převede z textu na řetězec. Tento kód vyžaduje, aby textBox1 byl vytvořen.

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

Poznámky

DataObject implementuje IDataObject rozhraní, jehož metody poskytují mechanismus přenosu dat nezávislý na formátu.

A DataObject se obvykle používá s Clipboard a při operacích přetažení. Třída DataObject poskytuje doporučenou implementaci IDataObject rozhraní. Doporučujeme, abyste místo vlastní implementace IDataObject použili DataObject třídu .

Do souboru lze uložit DataObjectvíce dat v různých formátech. Data se načítají z objektu DataObject v přidruženém formátu. Vzhledem k tomu, že cílová aplikace nemusí být známa, můžete zvýšit pravděpodobnost, že data budou ve vhodném formátu pro aplikaci, a to umístěním dat do objektu DataObject ve více formátech. Informace o předdefinovaných formátech najdete v tématu DataFormats . Můžete implementovat vlastní formát vytvořením instance DataFormats.Format třídy .

Chcete-li uložit data v DataObject, předejte data konstruktoru nebo volejte SetData. Do stejného DataObjectmůžete přidat data ve více formátech. Pokud chcete, aby se data, která přidáte, načítala pouze v nativním formátu, volejte s SetData(String, Boolean, Object) parametrem nastaveným autoConvert na false.

Data je možné načíst z souboru DataObject v libovolném formátu, který je kompatibilní s GetData. Text lze například převést na kódování Unicode. Pokud chcete načíst data ve formátu, ve kterém byla uložena, volejte s GetData parametrem nastaveným autoConvert na false.

Pokud chcete zjistit, ve jakých formátech jsou data uložená, zavolejte .GetFormats Pokud chcete zjistit, jestli je k dispozici formát, zavolejte GetDataPresent s požadovaným formátem.

V rozhraní .NET Framework 2.0 třída poskytuje další metody, DataObject které usnadňují práci s daty v běžných formátech. Pokud chcete do DataObjectpřidat data určitého formátu, použijte příslušnou Set metodu Format, například SetText. Chcete-li načíst data určitého formátu z objektu DataObject, nejprve zavolejte příslušnou Contains metodu Format (například ContainsText), abyste zjistili, zda DataObject objekt obsahuje data v tomto formátu, a pak voláním příslušné Get metody Format (například GetText) načtěte data, pokud DataObject je obsahuje.

Konstruktory

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

• Clipboard
• IDataObject
• DataFormats