IDataObject.GetData メソッド (String)

[アーティクル]
03/28/2008

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

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.GetData メソッド (String)

パラメータ

戻り値

解説

使用例

必要条件

参照

その他のリソース