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 インターフェイスの推奨される実装を提供します。 IDataObjectを実装するのではなく、DataObject クラスを使用することをお勧めします。

異なる形式の複数のデータを DataObjectに格納できます。 データは、関連付けられた形式で DataObject から取得されます。 ターゲット アプリケーションが不明な場合があるため、データを複数の形式の DataObject に配置することで、データがアプリケーションに適した形式になる可能性を高めることができます。 定義済みの形式については、 DataFormats を参照してください。 DataFormats.Format クラスのインスタンスを作成することで、独自の形式を実装できます。

DataObjectにデータを格納するには、コンストラクターにデータを渡すか、SetDataを呼び出します。 同じ DataObjectに複数の形式のデータを追加できます。 追加したデータをネイティブ形式でのみ取得する場合は、autoConvert パラメーターを false に設定してSetData(String, Boolean, Object)を呼び出します。

データは、GetDataと互換性のある任意の形式でDataObjectから取得できます。 たとえば、テキストを Unicode に変換できます。 格納された形式のデータを取得するには、autoConvert パラメーターを false に設定してGetDataを呼び出します。

データが格納されている形式を確認するには、 GetFormatsを呼び出します。 形式を使用できるかどうかを判断するには、目的の形式で GetDataPresent を呼び出します。

DataObject クラスには、一般的な形式のデータを簡単に操作できる追加のメソッドが用意されています。 特定の形式のデータを DataObjectに追加するには、適切な SetFormat メソッド ( SetText など) を使用します。 DataObjectから特定の形式のデータを取得するには、最初に適切なContainsFormat メソッド (ContainsText など) を呼び出して、DataObjectにその形式のデータが含まれているかどうかを判断してから、適切な GetFormat メソッド (GetText など) を呼び出して、DataObjectにデータが含まれている場合にデータを取得します。

こちらもご覧ください

• Clipboard
• IDataObject
• DataFormats