DataObject Класс

Определение

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

Public Class DataObject
Implements IDataObject

Public Class DataObject
Implements IDataObject, IDataObject

Наследование

Object

DataObject

Атрибуты

ClassInterfaceAttribute

Реализации

IDataObject IDataObject

Примеры

В следующем примере кода добавляются данные в объект DataObject. Во-первых, создается новое DataObject и компонент хранится в нем. Затем он проверяет наличие данных в соответствующем типе в объекте DataObject. Результат отображается в текстовом поле. Этот код требует textBox1 создания.

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

В следующем примере извлекаются данные, хранящиеся в объекте DataObject. Сначала создается новое DataObject с текстовыми данными. Затем данные извлекаются, указывая его формат в виде строки и отображаясь в текстовом поле. Формат данных автоматически преобразуется из текста в строку. Этот код требует textBox1 создания.

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

Комментарии

DataObject IDataObject реализует интерфейс, методы которого предоставляют независимый от формата механизм передачи данных.

Обычно используется DataObject с операциями Clipboard перетаскивания и перетаскивания. Класс DataObject предоставляет рекомендуемую реализацию IDataObject интерфейса. Предполагается, что вы используете DataObject класс, а не реализуете IDataObject себя.

В разных DataObjectформатах можно хранить несколько фрагментов данных. Данные извлекаются из связанного DataObject формата. Так как целевое приложение может быть не известно, вы можете увеличить вероятность того, что данные будут иметь соответствующий формат для приложения, разместив данные в DataObject нескольких форматах. См DataFormats . стандартные форматы. Вы можете реализовать собственный формат, создав экземпляр DataFormats.Format класса.

Чтобы сохранить данные в DataObjectобъекте, передайте данные конструктору или вызову SetData. Вы можете добавлять данные в несколько форматов в один и тот же DataObjectформат. Если требуется, чтобы добавляемые данные были получены только в собственном формате, вызовите SetData(String, Boolean, Object) параметр с заданным параметром autoConvertfalse.

Данные можно извлечь из DataObject любого формата, совместимого с GetData. Например, текст можно преобразовать в Юникод. Чтобы получить данные в формате, в котором он был сохранен, вызовите GetData параметр с заданным параметром autoConvertfalse.

Чтобы определить форматы, в которые хранятся данные, вызовите GetFormats. Чтобы определить, доступен ли формат, вызовите GetDataPresent нужный формат.

Класс DataObject предоставляет дополнительные методы, упрощающие работу с данными в общих форматах. Чтобы добавить данные определенного формата в DataObjectформат, используйте соответствующий Set метод Format, напримерSetText. Чтобы получить данные определенного формата из DataObjectопределенного формата, сначала вызовите соответствующий Contains метод Format (напримерContainsText), чтобы определить, содержат ли DataObject содержащиеся данные в этом формате, а затем вызовите соответствующий Get метод Format (напримерGetText), чтобы получить данные, если DataObject он содержится.

См. также раздел

• Clipboard
• IDataObject
• DataFormats