IDataObject.GetData メソッド (String)

  • [アーティクル]

指定したデータ形式に関連付けられているデータを取得します。

Function GetData( _
   ByVal format As String _) As Object
[C#]
object GetData(
   stringformat);
[C++]
Object* GetData(
   String* format);
[JScript]
function GetData(
   format : String) : Object;

パラメータ

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

戻り値

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

解説

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

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

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

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

使用例

[Visual Basic, C#, C++] この例では、 IDataObject, を実装する DataObject クラスを使用して、 GetData メソッドの使用法を示します。このメソッドは、 Text 形式に関連付けられている、 myDataObject に格納されているデータを取得するために使用します。この例は、 Form1 という名前の Form と textBox1 という名前の TextBox が既に作成されていることを前提にしています。

 
Private Sub GetData1()
    ' Creates a new data object using a string and the text format.
    Dim myString As String = "My text string"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString()
End Sub 'GetData1

[C#] 
private void GetData1() 
{
    // Creates a new data object using a string and the text format.
    string myString = "My text string";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);

    // Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString();
}

[C++] 
private:
    void GetData1() {
        // Creates a new data object using a string and the text format.
        String* myString = S"My text string";
        DataObject* myDataObject = new DataObject(DataFormats::Text, myString);

        // Displays the string in a text box.
        textBox1->Text = myDataObject->GetData(DataFormats::Text)->ToString();
    }

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