IDataObject.GetData メソッド

定義

指定したデータ形式に関連付けられているデータを取得します。Retrieves the data associated with the specified data format.

オーバーロード

GetData(String)

指定したデータ形式に関連付けられているデータを取得します。Retrieves the data associated with the specified data format.

GetData(Type)

指定したクラス型形式に関連付けられているデータを取得します。Retrieves the data associated with the specified class type format.

GetData(String, Boolean)

指定したデータ形式に関連付けられているデータを取得します。データを指定形式に変換できるかどうかを確認するためにブール値を使用します。Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

GetData(String)

指定したデータ形式に関連付けられているデータを取得します。Retrieves the data associated with the specified data format.

public:
 System::Object ^ GetData(System::String ^ format);
public object GetData (string format);
abstract member GetData : string -> obj
Public Function GetData (format As String) As Object

パラメーター

format
String

取得するデータの形式。The format of the data to retrieve. 定義済みの形式については、DataFormats のトピックを参照してください。See DataFormats for predefined formats.

戻り値

指定した形式に関連付けられているデータ、または nullThe data associated with the specified format, or null.

この例では、GetData メソッドの使用方法を示すために IDataObject, を実装する DataObject クラスを使用します。This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. メソッドは、Text 形式に関連付けられている myDataObjectに格納されているデータを取得するために使用されます。The method is used to retrieve the data stored in myDataObject, which is associated with the Text format. この例では、Form1 という名前の FormtextBox1という名前の TextBox が既に作成されていることを前提としています。The example assumes that you have already created a Form named Form1 and a TextBox named textBox1.

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

注釈

このメソッドは、指定された形式でデータを見つけることができない場合、データの形式への変換を試みます。If this method cannot find data in the specified format, it attempts to convert the data to the format. データを指定した形式に変換できない場合、このメソッドは nullを返します。If the data cannot be converted to the specified format, this method returns null.

データがに関連付けられているかどうか、または形式に変換できるかどうかを判断するには、GetDataを呼び出す前に GetDataPresent を呼び出します。To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. このインスタンスに格納されているデータの有効な形式の一覧については、GetFormats を呼び出してください。Call GetFormats for a list of valid formats for the data stored in this instance.

注意

変換が許可されているかどうか、および要求された形式が格納されている形式と互換性があるかどうかを指定するようにデータを格納している場合は、別の形式に変換できます。Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. たとえば、Unicode として格納されているデータをテキストに変換できます。For example, data stored as Unicode can be converted to text.

このメソッドの実装については、「DataObject.GetData」を参照してください。For an implementation of this method, see DataObject.GetData.

こちらもご覧ください

GetData(Type)

指定したクラス型形式に関連付けられているデータを取得します。Retrieves the data associated with the specified class type format.

public:
 System::Object ^ GetData(Type ^ format);
public object GetData (Type format);
abstract member GetData : Type -> obj
Public Function GetData (format As Type) As Object

パラメーター

format
Type

取得するデータの形式を表す TypeA Type representing the format of the data to retrieve. 定義済みの形式については、DataFormats のトピックを参照してください。See DataFormats for predefined formats.

戻り値

指定した形式に関連付けられているデータ、または nullThe data associated with the specified format, or null.

この例では、IDataObjectを実装する DataObject クラスを使用して、GetData メソッドの使用方法を示します。This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. メソッドは、特定の種類の myTypeに関連付けられている myObjectに格納されているデータを取得するために使用されます。The method is used to retrieve the data stored in myObject, which is associated with a specific type, myType. 取得したデータの型がメッセージボックスに表示されます。The type of the retrieved data is displayed in a message box. この例では、Form1という名前の Form が既に作成されていることを前提としています。The example assumes that you have already created a Form named Form1.

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

注釈

このメソッドは、指定された形式でデータを見つけることができない場合、データの形式への変換を試みます。If this method cannot find data in the specified format, it attempts to convert the data to the format. データを指定した形式に変換できない場合、このメソッドは nullを返します。If the data cannot be converted to the specified format, this method returns null.

データがに関連付けられているかどうか、または形式に変換できるかどうかを判断するには、GetDataを呼び出す前に GetDataPresent を呼び出します。To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. このインスタンスに格納されているデータの有効な形式の一覧については、GetFormats を呼び出してください。Call GetFormats for a list of valid formats for the data stored in this instance.

注意

変換が許可されているかどうか、および要求された形式が格納されている形式と互換性があるかどうかを指定するようにデータを格納している場合は、別の形式に変換できます。Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. たとえば、Unicode として格納されているデータをテキストに変換できます。For example, data stored as Unicode can be converted to text.

このメソッドの実装については、「DataObject.GetData」を参照してください。For an implementation of this method, see DataObject.GetData.

こちらもご覧ください

GetData(String, Boolean)

指定したデータ形式に関連付けられているデータを取得します。データを指定形式に変換できるかどうかを確認するためにブール値を使用します。Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

public:
 System::Object ^ GetData(System::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

取得するデータの形式。The format of the data to retrieve. 定義済みの形式については、DataFormats のトピックを参照してください。See DataFormats for predefined formats.

autoConvert
Boolean

指定した形式にデータを変換する場合は true。それ以外の場合は falsetrue to convert the data to the specified format; otherwise, false.

戻り値

指定した形式に関連付けられているデータ、または nullThe data associated with the specified format, or null.

この例では、IDataObjectを実装する DataObject クラスを使用して、GetData メソッドの使用方法を示します。This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. この例では、autoConvert パラメーターを使用して、データ形式を変換するかどうかを指定する DataObjectに格納されているデータを取得します。The example retrieves the data stored in a DataObject, using the autoConvert parameter to specify whether or not to convert the data format. まず、テキストデータを使用して myDataObject が作成されます。First, myDataObject is created with text data. 次に、この例では、データを取得するために2回試行します。Then the example tries twice to retrieve the data. 最初の評価では、書式を文字列として指定し、autoConvert パラメーターを falseに設定します。In the first trial, it specifies its format as a string and sets the autoConvert parameter to false. この評価は失敗し、結果は "Message #1" という名前のメッセージボックスに表示されます。This trial fails, and the result is displayed in a message box labeled "Message #1." 2番目の試用版では、この例では、autoConvert パラメーターを trueに設定して同じデータを取得します。In the second trial, the example retrieves the same data with the autoConvert parameter set to true. この評価は成功し、結果は "Message #2" という名前のメッセージボックスに表示されます。This trial succeeds, and the result is displayed in a message box labeled "Message #2." この例では、Form1という名前の Form が作成されていることを前提としています。The example assumes that you have created a Form named Form1.

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 で、このメソッドが指定された形式でデータを見つけることができない場合は、データを形式に変換しようとします。If the autoConvert parameter is true and this method cannot find data in the specified format, it attempts to convert the data to the format. データを指定した形式に変換できない場合、またはデータが autoConvert パラメーターを falseに設定して格納されている場合、このメソッドは nullを返します。If the data cannot be converted to the specified format, or if the data was stored with the autoConvert parameter set to false, this method returns null.

autoConvert パラメーターが falseの場合、このメソッドは指定された形式でデータを返すか、またはこの形式のデータが見つからない場合は null します。If the autoConvert parameter is false, this method returns data in the specified format, or null if no data in this format can be found.

データがに関連付けられているかどうか、または形式に変換できるかどうかを判断するには、GetDataを呼び出す前に GetDataPresent を呼び出します。To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. このインスタンスに格納されているデータの有効な形式の一覧については、GetFormats を呼び出してください。Call GetFormats for a list of valid formats for the data stored in this instance.

注意

変換が許可されているかどうか、および要求された形式が格納されている形式と互換性があるかどうかを指定するようにデータを格納している場合は、別の形式に変換できます。Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. たとえば、Unicode として格納されているデータをテキストに変換できます。For example, data stored as Unicode can be converted to text.

このメソッドの実装については、「DataObject.GetData」を参照してください。For an implementation of this method, see DataObject.GetData.

こちらもご覧ください

適用対象