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

指定した形式およびデータをこのインスタンスに格納します。

Overloads Public Overridable Sub SetData( _
   ByVal format As String, _   ByVal data As Object _) Implements IDataObject.SetData
[C#]
public virtual void SetData(stringformat,objectdata);
[C++]
public: virtual void SetData(String* format,Object* data);
[JScript]
public function SetData(
   format : String,data : Object);

パラメータ

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

実装

IDataObject.SetData

解説

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

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

使用例

[Visual Basic, C#, C++] データの形式を Unicode に指定して、 DataObject に格納する例を次に示します。

[Visual Basic, C#, C++] 次に、テキスト形式を指定してデータを取得します。最終形式に互換性があると、既定でそのデータに変換されます。結果はテキスト ボックスに表示されます。このコードは、 textBox1 が作成されていることを前提にしています。

 
Private Sub AddMyData()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject()
    
    ' Stores a string, specifying the Unicode format.
    myDataObject.SetData(DataFormats.UnicodeText, "Text string")
    
    ' Retrieves the data by specifying Text.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).GetType().Name
End Sub 'AddMyData

[C#] 
private void AddMyData() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject();
 
    // Stores a string, specifying the Unicode format.
    myDataObject.SetData(DataFormats.UnicodeText, "Text string");
 
    // Retrieves the data by specifying Text.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).GetType().Name;
 }
 

[C++] 
private:
void AddMyData() {
    // Creates a new data object using a string and the text format.
    DataObject* myDataObject = new DataObject();
 
    // Stores a string, specifying the Unicode format.
    myDataObject->SetData(DataFormats::UnicodeText, S"Text string");
 
    // Retrieves the data by specifying Text.
    textBox1->Text = myDataObject->GetData(DataFormats::Text)->GetType()->Name;
 }
 

[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 ファミリ

参照

DataObject クラス | DataObject メンバ | System.Windows.Forms 名前空間 | DataObject.SetData オーバーロードの一覧 | GetData | GetDataPresent | GetFormats | DataFormats