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.

戻り値

Object

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

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

データがに関連付けられているか、形式に変換できるかどうかを判断するには、を GetDataPresent 呼び出す前にを呼び出し GetData ます。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.GetDataFor an implementation of this method, see DataObject.GetData.

こちらもご覧ください

適用対象

製品 Introduced

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.

戻り値

Object

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

この例では DataObject 、を実装するクラスを使用 IDataObject して、メソッドの使用方法を示し GetData ます。This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. メソッドは、特定の型に関連付けられているに格納されているデータを取得するために使用され myObject myType ます。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. この例では、という名前のを既に作成していることを前提としてい Form Form1 ます。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.

データがに関連付けられているか、形式に変換できるかどうかを判断するには、を GetDataPresent 呼び出す前にを呼び出し GetData ます。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.GetDataFor an implementation of this method, see DataObject.GetData.

こちらもご覧ください

適用対象

製品 Introduced

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.

戻り値

Object

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

この例では DataObject 、を実装するクラスを使用 IDataObject して、メソッドの使用方法を示し GetData ます。This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. この例では、 DataObject パラメーターを使用して、 autoConvert データ形式を変換するかどうかを指定する、に格納されているデータを取得します。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." この例では、という名前のを作成していることを前提としてい Form Form1 ます。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.

データがに関連付けられているか、形式に変換できるかどうかを判断するには、を GetDataPresent 呼び出す前にを呼び出し GetData ます。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.GetDataFor an implementation of this method, see DataObject.GetData.

こちらもご覧ください

適用対象

製品 Introduced