次の方法で共有


IDataObject.GetData メソッド

定義

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

オーバーロード

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 のトピックを参照してください。

戻り値

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

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

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 のトピックを参照してください。

戻り値

指定した形式に関連付けられているデータ、または 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

注釈

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

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

注意

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

このメソッドの実装については、「」を参照してください 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

戻り値

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

この例では、 DataObject を実装する クラスを IDataObject使用して、 メソッドの使用方法を GetData 示します。 この例では、 パラメーターを使用して に格納されている DataObjectデータを autoConvert 取得し、データ形式を変換するかどうかを指定します。 まず、 myDataObject テキスト データを使用して が作成されます。 次に、この例ではデータの取得を 2 回試みます。 最初の試用版では、その形式を文字列として指定し、 パラメーターを autoConvertfalse設定します。 この試用は失敗し、結果は "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 形式のデータが見つからない場合は、このメソッドから返されます。

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

注意

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

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

こちらもご覧ください

適用対象