次の方法で共有

DataObject.GetData メソッド

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

指定したデータ形式に関連付けられたデータを返します。

オーバーロード

GetData(String, Boolean)

データを指定形式に変換するかどうかを判断するための自動変換パラメーターを使用して、指定したデータ形式に関連付けられているデータを返します。
GetData(String)

指定したデータ形式に関連付けられたデータを返します。
GetData(Type)

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

GetData(String, Boolean)

データを指定形式に変換するかどうかを判断するための自動変換パラメーターを使用して、指定したデータ形式に関連付けられているデータを返します。

public:
 virtual System::Object ^ GetData(System::String ^ format, bool autoConvert);
public virtual object GetData (string format, bool autoConvert);
public virtual object? GetData (string format, bool autoConvert);
abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj
Public Overridable Function GetData (format As String, autoConvert As Boolean) As Object

パラメーター

format
String

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

autoConvert
Boolean

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

戻り値

Object

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

実装

GetData(String, Boolean)

例

次のコード例では、 パラメーターを使用してautoConvert、 にDataObject格納されているデータを取得し、データ形式を変換するかどうかを指定します。

まず、テキスト データを使用して新しい DataObject が作成されます。 次に、データの取得を試み、その形式を文字列として指定し、形式変換を行いません。つまり、 autoConvert パラメーターは です false。 に文字列データ DataObjectがないため、この操作は失敗します。

次に、この例では、 パラメーターを に設定trueして、データの取得をautoConvert再試行します。 この操作は成功し、結果は に MessageBox表示されます。

このコードでは、 が textBox1 作成されている必要があります。

private:
   void GetMyData3()
   {
      // Creates a new data object using a string and the text format.
      String^ myString = "My new text string";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );
      
      // Prints the string in a text box with autoconvert = false.
      if ( myDataObject->GetData( "System.String", false ) != 0 )
      {
         // Prints the string in a text box.
         textBox1->Text = String::Concat(
            myDataObject->GetData( "System.String", false )->ToString(), "\n" );
      }
      else
      {
         textBox1->Text = "Could not find data of the specified format\n";
      }
      
      // Prints the string in a text box with autoconvert = true.
      textBox1->Text = String::Concat(
            textBox1->Text, myDataObject->GetData( "System.String", true )->ToString() );
   }

private void GetMyData3() {
    // Creates a new data object using a string and the text format.
    string myString = "My new text string";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);
 
    // Prints the string in a text box with autoconvert = false.
    if(myDataObject.GetData("System.String", false) != null) {
       // Prints the string in a text box.
       textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
    } else
        {
            textBox1.Text = "Could not find data of the specified format" + '\n';
        }

        // Prints the string in a text box with autoconvert = true.
        textBox1.Text += myDataObject.GetData("System.String", true).ToString();
 }

Private Sub GetMyData3()
    ' Creates a new data object using a string and the text format.
    Dim myString As String = "My new text string"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)
    
    ' Prints the string in a text box with autoconvert = false.
    If (myDataObject.GetData("System.String", False) IsNot Nothing) Then
        ' Prints the string in a text box.
        textBox1.Text = myDataObject.GetData("System.String", False).ToString() & ControlChars.Cr
    Else
        textBox1.Text = "Could not find data of the specified format" & ControlChars.Cr
    End If 
    ' Prints the string in a text box with autoconvert = true.
    textBox1.Text += myDataObject.GetData("System.String", True).ToString()
End Sub

注釈

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

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

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

注意

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

が のHtml場合format、このメソッドは.NET 4.5 以降を対象とするアプリケーションで UTF-8 エンコード文字列を返し、.NET 4.0 以降を対象とするアプリケーションでは ANSI エンコード文字列を返します。

こちらもご覧ください

適用対象

GetData(String)

指定したデータ形式に関連付けられたデータを返します。

public:
 virtual System::Object ^ GetData(System::String ^ format);
public virtual object GetData (string format);
public virtual object? GetData (string format);
abstract member GetData : string -> obj
override this.GetData : string -> obj
Public Overridable Function GetData (format As String) As Object

パラメーター

format
String

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

戻り値

Object

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

実装

GetData(String)

例

次のコード例では、 に格納されているデータを DataObject取得します。 まず、テキスト データを使用して新しい DataObject が作成されます。 次に、データが取得され、その形式が文字列として指定され、テキスト ボックスに表示されます。

このコードでは、 が textBox1 作成されている必要があります。

private:
   void AddMyData3()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a new data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds the component to the DataObject.
      myDataObject->SetData( myComponent );
      
      // Prints whether data of the specified type is in the DataObject.
      Type^ myType = myComponent->GetType();
      if ( myDataObject->GetDataPresent( myType ) )
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is present in the DataObject" );
      }
      else
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is not present in the DataObject" );
      }
   }

private void AddMyData3() {
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Creates a new data object.
    DataObject myDataObject = new DataObject();
 
    // Adds the component to the DataObject.
    myDataObject.SetData(myComponent);
 
    // Prints whether data of the specified type is in the DataObject.
    Type myType = myComponent.GetType();
    if(myDataObject.GetDataPresent(myType))
       textBox1.Text = "Data of type " + myType.ToString() + 
       " is present in the DataObject";
    else
       textBox1.Text = "Data of type " + myType.ToString() +
       " is not present in the DataObject";
 }

Private Sub AddMyData3()
    ' Creates a component to store in the data object.
    Dim myComponent As New Component()
    
    ' Creates a new data object.
    Dim myDataObject As New DataObject()
    
    ' Adds the component to the DataObject.
    myDataObject.SetData(myComponent)
    
    ' Prints whether data of the specified type is in the DataObject.
    Dim myType As Type = myComponent.GetType()
    If myDataObject.GetDataPresent(myType) Then
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is present in the DataObject"
    Else
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is not present in the DataObject"
    End If
End Sub

注釈

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

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

注意

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

が のHtml場合format、このメソッドは.NET 4.5 以降を対象とするアプリケーションで UTF-8 エンコード文字列を返し、.NET 4.0 以降を対象とするアプリケーションでは ANSI エンコード文字列を返します。

こちらもご覧ください

適用対象

GetData(Type)

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

public:
 virtual System::Object ^ GetData(Type ^ format);
public virtual object GetData (Type format);
public virtual object? GetData (Type format);
abstract member GetData : Type -> obj
override this.GetData : Type -> obj
Public Overridable Function GetData (format As Type) As Object

パラメーター

format
Type

取得するデータの形式を表す Type。

戻り値

Object

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

実装

GetData(Type)

例

次のコード例では、 に格納されているデータを DataObject取得します。 まず、コンポーネントを使用して新しい DataObject が作成されます。 その後、データが取得され、その型が指定されます。 取得したデータの種類がテキスト ボックスに表示されます。

このコードでは、 が textBox1 作成されている必要があります。

private:
   void GetMyData()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a new data object and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject( myComponent );
      
      // Creates a type 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 )
      {
         textBox1->Text = String::Format( "The data type stored in the DataObject is: {0}",
            myObject->GetType()->Name );
      }
      else
      {
         textBox1->Text = "Data of the specified type was not stored in the DataObject.";
      }
   }

private void GetMyData() {
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Creates a new data object and assigns it the component.
    DataObject myDataObject = new DataObject(myComponent);
 
    // Creates a type 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)
       textBox1.Text = "The data type stored in the DataObject is: " +
       myObject.GetType().Name;
    else
       textBox1.Text = "Data of the specified type was not stored " +
       "in the DataObject.";
 }

Private Sub GetMyData()
    ' Creates a component to store in the data object.
    Dim myComponent As New Component()
    
    ' Creates a new data object and assigns it the component.
    Dim myDataObject As New DataObject(myComponent)
    
    ' Creates a type 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
        textBox1.Text = "The data type stored in the DataObject is: " & myObject.GetType().Name
    Else
        textBox1.Text = "Data of the specified type was not stored " & "in the DataObject."
    End If
End Sub

注釈

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

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

注意

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

こちらもご覧ください

適用対象