IDataObject.GetData メソッド

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

GetData(String)	指定したデータ形式に関連付けられているデータを取得します。
GetData(Type)	指定したクラス型形式に関連付けられているデータを取得します。
GetData(String, Boolean)	指定したデータ形式に関連付けられているデータを取得します。データを指定形式に変換できるかどうかを確認するためにブール値を使用します。

GetData(String)

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

public:
 System::Object ^ GetData(System::String ^ format);

public object GetData (string format);

public object? GetData (string format);

abstract member GetData : string -> obj

Public Function GetData (format As String) As Object

パラメーター

format: String

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

戻り値

Object

指定した形式に関連付けられているデータ、または null。

例

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

private:
   void GetData1()
   {
      // Creates a new data object using a string and the text format.
      String^ myString = "My text string";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

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

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();
}

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

注釈

このメソッドは、指定された形式のデータを見つけることができない場合は、データを形式に変換しようとします。データを指定した形式に変換できない場合、このメソッドはを返します null。

データがに関連付けられているか、または形式に変換できるかどうかを判断するには、を呼び出す前にを呼び出 GetDataPresent します GetData。このインスタンスに格納されているデータの有効な形式の一覧を呼び出 GetFormats します。

注意

データは、その変換が許可されることを指定して格納されている場合、および要求された形式が格納された形式と互換性がある場合は、別の形式に変換できます。たとえば、Unicode として格納されているデータをテキストに変換できます。

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

こちらもご覧ください

適用対象

GetData(Type)

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

public:
 System::Object ^ GetData(Type ^ format);

public object GetData (Type format);

public object? GetData (Type format);

abstract member GetData : Type -> obj

Public Function GetData (format As Type) As Object

パラメーター

format: Type

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

戻り値

Object

指定した形式に関連付けられているデータ、または null。

例

この例では、 DataObject を実装するクラスを IDataObject使用して、メソッドの使用方法を GetData 示します。メソッドは、に格納されているデータを取得するために使用されます myObject。これは、特定の型に myType関連付けられています。取得したデータの種類がメッセージボックスに表示されます。この例では、という名前Form1のが既にForm作成されていることを前提としています。

private:
   void GetData2()
   {
      // Creates a component.
      Component^ myComponent = gcnew Component;

      // Creates a data object, and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject( myComponent );

      // Creates a type, myType, to store the type of data.
      Type^ myType = myComponent->GetType();

      // Retrieves the data using myType to represent its type.
      Object^ myObject = myDataObject->GetData( myType );
      if ( myObject != nullptr )
            MessageBox::Show( "The data type stored in the data object is " +
                  myObject->GetType()->Name + "." );
      else
            MessageBox::Show( "Data of the specified type was not stored in the data object." );
   }

       private void GetData2() 
       {
           // Creates a component.
           Component myComponent = new Component();

           // Creates a data object, and assigns it the component.
           DataObject myDataObject = new DataObject(myComponent);

           // Creates a type, myType, to store the type of data.
           Type myType = myComponent.GetType();

           // Retrieves the data using myType to represent its type.
           Object myObject = myDataObject.GetData(myType);
           if(myObject != null)
               MessageBox.Show("The data type stored in the data object is " +
                   myObject.GetType().Name + ".");
           else
               MessageBox.Show("Data of the specified type was not stored " +
                   "in the data object.");
       }

Private Sub GetData2()
    ' Creates a component.
    Dim myComponent As New System.ComponentModel.Component()

    ' Creates a data object, and assigns it the component.
    Dim myDataObject As New DataObject(myComponent)

    ' Creates a type, myType, to store the type of data.
    Dim myType As Type = myComponent.GetType()

    ' Retrieves the data using myType to represent its type.
    Dim myObject As [Object] = myDataObject.GetData(myType)
    If (myObject IsNot Nothing) Then
        MessageBox.Show("The data type stored in the data object is " + myObject.GetType().Name + ".")
    Else
        MessageBox.Show("Data of the specified type was not stored " + "in the data object.")
    End If
End Sub

注釈

注意

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

こちらもご覧ください

適用対象

GetData(String, Boolean)

指定したデータ形式に関連付けられているデータを取得します。データを指定形式に変換できるかどうかを確認するためにブール値を使用します。

public:
 System::Object ^ GetData(System::String ^ format, bool autoConvert);

public object GetData (string format, bool autoConvert);

public object? GetData (string format, bool autoConvert);

abstract member GetData : string * bool -> obj

Public Function GetData (format As String, autoConvert As Boolean) As Object

パラメーター

format: String

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

autoConvert: Boolean

指定した形式にデータを変換する場合は true。それ以外の場合は false。

戻り値

Object

指定した形式に関連付けられているデータ、または null。

例

この例では、 DataObject を実装するクラスを IDataObject使用して、メソッドの使用方法を GetData 示します。この例では、パラメーターを使用してに格納されている DataObjectデータを autoConvert 取得し、データ形式を変換するかどうかを指定します。まず、 myDataObject テキストデータを使用してが作成されます。次に、この例ではデータの取得を 2 回試みます。最初の試用版では、その形式を文字列として指定し、パラメーターを autoConvert に false設定します。この試用は失敗し、結果は "Message #1" というラベルの付いたメッセージボックスに表示されます。2 回目の試用版では、パラメーターをに設定して同じデータをautoConverttrue取得します。この試用は成功し、結果は "Message #2" というラベルの付いたメッセージボックスに表示されます。この例では、という名前Form1のがForm作成されていることを前提としています。

private:
   void GetData3()
   {
      // Creates a new data object using a text string.
      String^ myString = "Hello World!";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Displays the string with autoConvert equal to false.
      if ( myDataObject->GetData( "System::String", false ) != nullptr )
      {
         // Displays the string in a message box.
         MessageBox::Show( myDataObject->GetData( "System::String", false ) + ".", "Message #1" );
      }
      else
            MessageBox::Show( "Could not find data of the specified format.", "Message #1" );

      // Displays a not found message in a message box.
      // Displays the string in a text box with autoConvert equal to true.
      String^ myData = "The data is " + myDataObject->GetData( "System::String", true ) + ".";
      MessageBox::Show( myData, "Message #2" );
   }

       private void GetData3() 
       {
           // Creates a new data object using a text string.
           string myString = "Hello World!";
           DataObject myDataObject = new DataObject(DataFormats.Text, myString);

           // Displays the string with autoConvert equal to false.
           if (myDataObject.GetData("System.String", false) != null) 
           {
               // Displays the string in a message box.
               MessageBox.Show(myDataObject.GetData("System.String", false).ToString() + ".", "Message #1");
           } 
           else
           {
               // Displays a not found message in a message box.
               MessageBox.Show("Could not find data of the specified format.", "Message #1");
           }

           // Displays the string in a text box with autoConvert equal to true.
           string myData = "The data is " + myDataObject.GetData("System.String", true).ToString() +".";
           MessageBox.Show(myData,"Message #2");
       }

Private Sub GetData3()
    ' Creates a new data object using a text string.
    Dim myString As String = "Hello World!"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string with autoConvert equal to false.
    If (myDataObject.GetData("System.String", False) IsNot Nothing) Then
        ' Displays the string in a message box.
        MessageBox.Show(myDataObject.GetData("System.String", False).ToString() + ".", "Message #1")
        ' Displays a not found message in a message box.
    Else
        MessageBox.Show("Could not find data of the specified format.", "Message #1")
    End If

    ' Displays the string in a text box with autoConvert equal to true.
    Dim myData As String = "The data is " + myDataObject.GetData("System.String", True).ToString()
    MessageBox.Show(myData, "Message #2")
End Sub

注釈

パラメーターが autoConvert で、このメソッドが true 指定した形式のデータを見つけることができない場合、データを形式に変換しようとします。指定した形式にデータを変換できない場合、またはパラメーターをにfalse設定してデータがautoConvert格納されている場合、このメソッドはを返しますnull。

パラメーターが autoConvert の場合、このメソッドは false指定された形式のデータを返します。この null 形式のデータが見つからない場合は、このメソッドから返されます。

注意

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

こちらもご覧ください

適用対象

IDataObject.GetData メソッド

定義

オーバーロード

GetData(String)

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

GetData(Type)

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

GetData(String, Boolean)

パラメーター

戻り値

例

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース