DataObject.GetData メソッド (String)

  • [アーティクル]

指定したデータ形式に関連付けられたデータを返します。

Overloads Public Overridable Function GetData( _
   ByVal format As String _) As Object Implements IDataObject.GetData
[C#]
public virtual object GetData(stringformat);
[C++]
public: virtual Object* GetData(String* format);
[JScript]
public function GetData(
   format : String) : Object;

パラメータ

  • format
    取得するデータの形式。定義済みの形式については、 DataFormats のトピックを参照してください。

戻り値

指定した形式に関連付けられているデータ、または null 参照 (Visual Basic では Nothing) 。

実装

IDataObject.GetData

解説

指定した形式のデータが見つからない場合、このメソッドはデータをその形式に変換しようとします。データを指定した形式に変換できない場合や、データの格納時に自動変換に false が設定されていた場合は、このメソッドは null 参照 (Visual Basic では Nothing) を返します。

データが特定の形式に関連付けられているかどうか、またはデータをその形式に変換できるかどうかを確認するには、 GetData を呼び出す前に GetDataPresent を呼び出します。インスタンスに格納されているデータに対して有効な形式のリストを取得するには、 GetFormats を呼び出します。

メモ   形式変換を有効にしてデータが格納されている場合、要求した形式が、格納されている形式と互換性があれば、そのデータを別の形式に変換できます。たとえば、Unicode として格納されたデータをテキストに変換できます。

使用例

[Visual Basic, C#, C++] DataObject に格納されているデータを取得する例を次に示します。まず、テキスト データを含む新しい DataObject が作成されます。次に、そのデータが取得され、形式が文字列に指定されてテキスト ボックスに表示されます。

[Visual Basic, C#, C++] このコードは、 textBox1 が作成されていることを前提にしています。

 
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 'AddMyData3


[C#] 
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";
 }

[C++] 
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 = String::Format( S"Data of type {0} is present in the DataObject", myType );
    else
       textBox1->Text = String::Format( S"Data of type {0} is not present in the DataObject", myType );
 }

[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.GetData オーバーロードの一覧 | SetData | GetDataPresent | DataFormats | GetFormats