DataFormats

.NET Framework クラス ライブラリ リファレンス

DataFormats クラス

static な定義済み Clipboard 形式名を提供します。これらを使用して IDataObject に格納するデータの形式を識別します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Class DataFormats

Visual Basic (使用法)

Dim instance As DataFormats

C#

public class DataFormats

C++

public ref class DataFormats

J#

public class DataFormats

JScript

public class DataFormats

解説

IDataObject クラスと DataObject クラスでも、static 形式リストを使用し、システム Clipboard から取得したデータか、またはドラッグ アンド ドロップ操作で転送したデータかを判断します。

GetFormat メソッドを使用すると、次の処理を実行できます。

• 形式名または ID 番号に対して定義済みの DataFormats.Format オブジェクトを取得します。

• ユーザーが形式名を渡すとき、このクラスの static リストに形式名と ID 番号の新しいペアを追加し、Windows レジストリにこの形式を Clipboard 形式として登録します。

DataFormats.Format インスタンスの適切なプロパティから Id 番号または形式の Name を取得できます。

使用例

myFormat という名前の新しいデータ形式を作成するコード例を次に示します。このコードは MyNewObject を作成して DataObject に格納します。DataObject は Clipboard にコピーされます。

次に DataObject が Clipboard から取得され、MyNewObject が復元されます。MyNewObject の値はテキスト ボックスに表示されます。このコードでは、textBox1 が作成されており、フォーム上に配置されている必要があります。

Visual Basic

Option Explicit
Option Strict

Imports System
Imports System.Windows.Forms

Public Class MyClass1
    Inherits Form
    Private textBox1 As TextBox

    Public Sub MyClipboardMethod()
        ' Creates a new data format.
        Dim myFormat As DataFormats.Format
 = _
            DataFormats.GetFormat("myFormat")
        
        ' Creates a new object and store it in a DataObject using myFormat
 
        ' as the type of format. 
        Dim myObject As New
 MyNewObject()
        Dim myDataObject As New
 DataObject(myFormat.Name, myObject)
        
        ' Copies myObject into the clipboard.
        Clipboard.SetDataObject(myDataObject)
        
        ' Performs some processing steps.
        ' Retrieves the data from the clipboard.
        Dim myRetrievedObject As IDataObject
 = Clipboard.GetDataObject()
        
        ' Converts the IDataObject type to MyNewObject type. 
        Dim myDereferencedObject As MyNewObject
 = _
            CType(myRetrievedObject.GetData(myFormat.Name), MyNewObject)
        
        ' Print the value of the Object in a textBox.
        textBox1.Text = myDereferencedObject.MyObjectValue
    End Sub 'MyClipboardMethod
End Class 'MyClass


' Creates a new type.
<Serializable()> Public Class MyNewObject
    Inherits Object
    Private myValue As String
    
    
    ' Creates a default constructor for the class.
    Public Sub New()
        myValue = "This is the value of the class"
    End Sub 'New
    
    ' Creates a property to retrieve or set the value.
    
    Public Property MyObjectValue() As
 String
        Get
            Return myValue
        End Get
        Set
            myValue = value
        End Set
    End Property
End Class 'MyNewObject

C#

using System;
using System.Windows.Forms;

public class MyClass : Form {
    protected TextBox textBox1;
    
    public void MyClipboardMethod() {
       // Creates a new data format.
       DataFormats.Format myFormat = DataFormats.GetFormat("myFormat");
       
       /* Creates a new object and stores it in
 a DataObject using myFormat 
        * as the type of format. */
       MyNewObject myObject = new MyNewObject();
       DataObject myDataObject = new DataObject(myFormat.Name,
 myObject);
 
       // Copies myObject into the clipboard.
       Clipboard.SetDataObject(myDataObject);
 
       // Performs some processing steps.
 
       // Retrieves the data from the clipboard.
       IDataObject myRetrievedObject = Clipboard.GetDataObject();
 
       // Converts the IDataObject type to MyNewObject type. 
       MyNewObject myDereferencedObject = (MyNewObject)myRetrievedObject.GetData(myFormat.Name);
 
       // Prints the value of the Object in a textBox.
       textBox1.Text = myDereferencedObject.MyObjectValue;
    }
 }
 
 // Creates a new type.
 [Serializable]
 public class MyNewObject : Object {
    private string myValue;
 
    // Creates a default constructor for the class.
    public MyNewObject() {
       myValue = "This is the value of the class";
    }
 
    // Creates a property to retrieve or set the value.
    public string MyObjectValue {
       get {
          return myValue;
       }
       set {
          myValue = value;
       }
    }
 }

 

C++

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;

// Creates a new type.

[Serializable]
public ref class MyNewObject: public
 Object
{
private:
   String^ myValue;

public:

   // Creates a default constructor for the class.
   MyNewObject()
   {
      myValue = "This is the value of the class";
   }


   property String^ MyObjectValue 
   {

      // Creates a property to retrieve or set the value.
      String^ get()
      {
         return myValue;
      }

      void set( String^ value )
      {
         myValue = value;
      }

   }

};

public ref class MyClass: public
 Form
{
protected:
   TextBox^ textBox1;

public:
   void MyClipboardMethod()
   {
      
      // Creates a new data format.
      DataFormats::Format^ myFormat = DataFormats::GetFormat( "myFormat"
 );
      
      /* Creates a new object and stores it in
 a DataObject using myFormat 
               * as the type of format. */
      MyNewObject^ myObject = gcnew MyNewObject;
      DataObject^ myDataObject = gcnew DataObject( myFormat->Name,myObject );
      
      // Copies myObject into the clipboard.
      Clipboard::SetDataObject( myDataObject );
      
      // Performs some processing steps.
      // Retrieves the data from the clipboard.
      IDataObject^ myRetrievedObject = Clipboard::GetDataObject();
      
      // Converts the IDataObject type to MyNewObject type. 
      MyNewObject^ myDereferencedObject = dynamic_cast<MyNewObject^>(myRetrievedObject->GetData(
 myFormat->Name ));
      
      // Prints the value of the Object in a textBox.
      textBox1->Text = myDereferencedObject->MyObjectValue;
   }

};

J#

import System.*;
import System.Windows.Forms.*;

public class MyClass extends Form
{
    protected TextBox textBox1;

    public void MyClipboardMethod()
    {
        // Creates a new data format.
        DataFormats.Format myFormat = DataFormats.GetFormat("myFormat");
        /*  Creates a new object and stores it in
 a DataObject using myFormat 
            as the type of format. 
         */
        MyNewObject myObject = new MyNewObject();
        DataObject myDataObject = new DataObject(myFormat.get_Name()
,myObject);

        // Copies myObject into the clipboard.
        Clipboard.SetDataObject(myDataObject);

        // Performs some processing steps.
        // Retrieves the data from the clipboard.
        IDataObject myRetrievedObject = Clipboard.GetDataObject();

        // Converts the IDataObject type to MyNewObject type. 
        MyNewObject myDereferencedObject = 
            (MyNewObject)(myRetrievedObject.GetData(myFormat.get_Name()));

        // Prints the value of the Object in a textBox.
        textBox1.set_Text(myDereferencedObject.get_MyObjectValue());
    } //MyClipboardMethod
} //MyClass

// Creates a new type.
/** @attribute Serializable()
 */
public class MyNewObject extends Object
{
    private String myValue;
    // Creates a default constructor for the class.
    public MyNewObject()
    {
        myValue = "This is the value of the class";
    } //MyNewObject

    // Creates a property to retrieve or set the value.
    /** @property 
     */
    public String get_MyObjectValue()
    {
        return myValue;
    } //get_MyObjectValue

    /** @property 
     */
    public void set_MyObjectValue(String value)
    {
        myValue = value;
    } //set_MyObjectValue
} //MyNewObject

JScript

import System;
import System.Windows.Forms;

public class MyClass extends
 Form {
    protected var textBox1 : TextBox;
    
    public function MyClipboardMethod() {
       // Create a new data format.
       var myFormat : DataFormats.Format = DataFormats.GetFormat("myFormat");
       
       /* Create a new object and store it in a DataObject import
 the myFormat 
        * as the type of format. */
       var myObject : MyNewObject = new MyNewObject();
       var myDataObject : DataObject = new
 DataObject("myFormat", myObject);
 
       // Copy myObject into the clipboard.
       Clipboard.SetDataObject(myDataObject);
 
       // Perform some processing steps.
 
       // Retrieve the data from the clipboard.
       var myRetrievedObject : IDataObject = Clipboard.GetDataObject();
 
       // Convert the IDataObject type to MyNewObject type. 
       var myDereferencedObject : MyNewObject = MyNewObject(myRetrievedObject.GetData("myFormat"));
 
       // Print the value of the Object in a textBox.
       textBox1.Text = myDereferencedObject.MyObjectValue;
    }
 }
 
 // Create a new type.
Serializable public class MyNewObject extends
 Object {
    private var myValue : String;
 
    // Create a default constructor for the class.
    public function MyNewObject() {
       myValue = "This is the value of the class";
    }
 
    // Create a property to retrieve or set the value.
    public function get
 MyObjectValue() : String {
          return myValue;
    }
       
    public function set
 MyObjectValue(value : String) {
          myValue = value;
    }
 }
 

継承階層

System.Object
  System.Windows.Forms.DataFormats

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
DataFormats メンバ
System.Windows.Forms 名前空間
Clipboard クラス
DataObject
DataFormats.Format
IDataObject
SetData
GetData
GetFormats
GetDataPresent
GetData
GetDataPresent
GetFormats
SetData

DataFormats フィールド

パブリック フィールド

	名前	説明
	CommaSeparatedValue	コンマ区切り (CSV: Comma-Separated Value) 形式を指定します。この形式はスプレッドシートで使用する交換形式です。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	Dib	Windows のデバイスに依存しないビットマップ (DIB: Device-Independent Bitmap) 形式を指定します。static フィールドは読み取り専用です。
	Dif	Windows DIF (Data Interchange Format) を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	EnhancedMetafile	Windows 拡張メタファイル形式を指定します。static フィールドは読み取り専用です。
	FileDrop	Windows ファイル ドロップ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	Html	HTML データで構成されるテキストを指定します。static フィールドは読み取り専用です。
	Locale	Windows のカルチャで使用する形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	MetafilePict	Windows メタファイル形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	OemText	標準の Windows OEM (Original Equipment Manufacturer) テキスト形式を指定します。static フィールドは読み取り専用です。
	Palette	Windows パレット形式を指定します。static フィールドは読み取り専用です。
	PenData	手書きソフトウェアのペン ストロークで形成される Windows ペン データ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	Riff	RIFF (Resource Interchange File Format) オーディオ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	Rtf	RTF (Rich Text Format) データで構成されるテキストを指定します。static フィールドは読み取り専用です。
	Serializable	任意の種類の Windows フォーム オブジェクトをカプセル化する形式を指定します。static フィールドは読み取り専用です。
	SymbolicLink	Windows シンボリック リンク形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	Tiff	TIFF (Tagged Image File Format) を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	WaveAudio	WAVE オーディオ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。

参照

関連項目

DataFormats クラス
System.Windows.Forms 名前空間
Clipboard クラス
DataObject
DataFormats.Format
IDataObject
SetData
GetData
GetFormats
GetDataPresent
GetData
GetDataPresent
GetFormats
SetData

DataFormats メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetFormat	オーバーロードされます。 Windows クリップボード数値 ID および名前と共に DataFormats.Format を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

DataFormats クラス
System.Windows.Forms 名前空間
Clipboard クラス
DataObject
DataFormats.Format
IDataObject
SetData
GetData
GetFormats
GetDataPresent
GetData
GetDataPresent
GetFormats
SetData

DataFormats メンバ

static な定義済み Clipboard 形式名を提供します。これらを使用して IDataObject に格納するデータの形式を識別します。

DataFormats データ型で公開されるメンバを以下の表に示します。

パブリック フィールド

	名前	説明
	CommaSeparatedValue	コンマ区切り (CSV: Comma-Separated Value) 形式を指定します。この形式はスプレッドシートで使用する交換形式です。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	Dib	Windows のデバイスに依存しないビットマップ (DIB: Device-Independent Bitmap) 形式を指定します。static フィールドは読み取り専用です。
	Dif	Windows DIF (Data Interchange Format) を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	EnhancedMetafile	Windows 拡張メタファイル形式を指定します。static フィールドは読み取り専用です。
	FileDrop	Windows ファイル ドロップ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	Html	HTML データで構成されるテキストを指定します。static フィールドは読み取り専用です。
	Locale	Windows のカルチャで使用する形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	MetafilePict	Windows メタファイル形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	OemText	標準の Windows OEM (Original Equipment Manufacturer) テキスト形式を指定します。static フィールドは読み取り専用です。
	Palette	Windows パレット形式を指定します。static フィールドは読み取り専用です。
	PenData	手書きソフトウェアのペン ストロークで形成される Windows ペン データ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	Riff	RIFF (Resource Interchange File Format) オーディオ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	Rtf	RTF (Rich Text Format) データで構成されるテキストを指定します。static フィールドは読み取り専用です。
	Serializable	任意の種類の Windows フォーム オブジェクトをカプセル化する形式を指定します。static フィールドは読み取り専用です。
	SymbolicLink	Windows シンボリック リンク形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	Tiff	TIFF (Tagged Image File Format) を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。
	WaveAudio	WAVE オーディオ形式を指定します。Windows フォームでは、この形式が直接使用されることはありません。static フィールドは読み取り専用です。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetFormat	オーバーロードされます。 Windows クリップボード数値 ID および名前と共に DataFormats.Format を返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

DataFormats クラス
System.Windows.Forms 名前空間
Clipboard クラス
DataObject
DataFormats.Format
IDataObject
SetData
GetData
GetFormats
GetDataPresent
GetData
GetDataPresent
GetFormats
SetData