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

[<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

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

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) с параметром , для которого autoConvert задано значение false.

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

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

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

Конструкторы

Методы

Явные реализации интерфейса

Применяется к

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

• Clipboard
• IDataObject
• DataFormats