IDataObject.SetData メソッド (String, Object)

  • [アーティクル]

指定したデータおよびそのデータに関連付けられている形式をインスタンスに格納します。

Sub SetData( _
   ByVal format As String, _   ByVal data As Object _)
[C#]
void SetData(
   stringformat,objectdata);
[C++]
void SetData(
   String* format,Object* data);
[JScript]
function SetData(
   format : String,data : Object);

パラメータ

  • format
    データに関連付けられている形式。定義済みの形式については、 DataFormats のトピックを参照してください。
  • data
    格納するデータ。

解説

データを取り出す側のアプリケーションの形式が不明な場合は、このメソッドを使用して、データを複数の形式で格納しておくことができます。

このメソッドを使用して格納されたデータは、取得時に互換性のある形式に変換できます。

このメソッドの実装については、 DataObject.SetData のトピックを参照してください。

使用例

[Visual Basic, C#, C++] この例では、 IDataObject を実装する DataObject クラスを使用して、 SetData メソッドの使用法を示します。最初に、データ オブジェクト (myDataObject) を作成し、 UnicodeText 形式を指定して、このオブジェクトに文字列を格納します。次に、 Text 形式を指定して、オブジェクトに格納されているデータを取得します。この場合、データは Text 形式に変換されます。結果はメッセージ ボックスに表示されます。この例は、 Form1 という名前の Form を作成済みであることを前提にしています。

 
Private Sub SetData2()
   ' Creates a data object.
   Dim myDataObject As New DataObject()
   
   ' Stores a string, specifying the UnicodeText format.
   myDataObject.SetData(DataFormats.UnicodeText, "Hello World!")
   
   ' Retrieves the data by specifying the Text format.
   Dim myMessageText As String = "The data type is " & _
             myDataObject.GetData(DataFormats.Text).GetType().Name
   
   ' Displays the result.
   MessageBox.Show(myMessageText, "The Test Result")
End Sub 'SetData2

[C#] 
private void SetData2() 
{
    // Creates a data object.
    DataObject myDataObject = new DataObject();
 
    // Stores a string, specifying the UnicodeText format.
    myDataObject.SetData(DataFormats.UnicodeText, "Hello World!");
 
    // Retrieves the data by specifying the Text format.
    string myMessageText = "The data type is " + myDataObject.GetData(DataFormats.Text).GetType().Name;

    // Displays the result.
    MessageBox.Show(myMessageText, "The Test Result");
}

[C++] 
private:
    void SetData2() {
        // Creates a data object.
        DataObject* myDataObject = new DataObject();

        // Stores a string, specifying the UnicodeText format.
        myDataObject->SetData(DataFormats::UnicodeText, S"Hello World!");

        // Retrieves the data by specifying the Text format.
        String* myMessageText = String::Concat(S"The data type is ", 
            myDataObject->GetData(DataFormats::Text)->GetType()->Name);

        // Displays the result.
        MessageBox::Show(myMessageText, S"The Test Result");
    }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

IDataObject インターフェイス | IDataObject メンバ | System.Windows.Forms 名前空間 | IDataObject.SetData オーバーロードの一覧 | IDataObject.GetData | IDataObject.GetDataPresent | DataObject.SetData