DataObject 클래스

정의

public ref class DataObject : System::Windows::Forms::IDataObject

public ref class DataObject : System::Runtime::InteropServices::ComTypes::IDataObject, System::Windows::Forms::IDataObject

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
public class DataObject : System.Windows.Forms.IDataObject

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
public class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.Forms.IDataObject

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type DataObject = class
    interface IDataObject
    interface UnsafeNativeMethods.IOleDataObject

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type DataObject = class
    interface IDataObject
    interface IDataObject

Public Class DataObject
Implements IDataObject

Public Class DataObject
Implements IDataObject, IDataObject

상속

Object

DataObject

특성

ClassInterfaceAttribute

구현

IDataObject IDataObject

예제

다음 코드 예제에서는 에 데이터를 추가합니다 DataObject. 먼저 새 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

다음 예제에서는 에 저장된 DataObject데이터를 검색합니다. 첫째, 텍스트 데이터를 사용하여 새 DataObject 텍스트가 만들어집니다. 그런 다음 데이터를 검색하여 해당 형식을 문자열로 지정하고 텍스트 상자에 표시합니다. 데이터 형식은 텍스트에서 문자열로 자동으로 변환됩니다. 이 코드를 만들려면 이 코드가 textBox1 필요합니다.

void GetMyData2()
{
   // Creates a new data object using a string and the text format.
   DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"Text to Store" );
   
   // Prints the string in a text box.
   textBox1->Text = myDataObject->GetData( DataFormats::Text )->ToString();
}

private void GetMyData2() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "Text to Store");
 
    // Prints the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString();
 }

Private Sub GetMyData2()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "Text to Store")
    
    ' Prints the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString()
End Sub

설명

DataObject 는 메서드가 IDataObject 데이터 전송을 위한 형식 독립적 메커니즘을 제공하는 인터페이스를 구현합니다.

A DataObject 는 일반적으로 끌어서 놓기 작업과 함께 Clipboard 사용됩니다. 클래스는 DataObject 인터페이스의 권장 구현을 IDataObject 제공합니다. 자신을 구현 IDataObject 하는 대신 클래스를 DataObject 사용하는 것이 좋습니다.

다양한 형식의 여러 데이터 조각을 에 저장할 DataObject수 있습니다. 데이터는 연결된 형식으로 DataObject 검색됩니다. 대상 애플리케이션을 알 수 없으므로 데이터를 여러 형식으로 배치 DataObject 하여 데이터가 애플리케이션에 적합한 형식이 될 가능성을 높일 수 있습니다. 미리 정의된 형식은 참조 DataFormats 하세요. 클래스의 인스턴스를 만들어 고유한 형식을 구현할 DataFormats.Format 수 있습니다.

데이터를 저장 DataObject하려면 생성자에 데이터를 전달하거나 호출 SetData합니다. 여러 형식의 데이터를 동일한 DataObject형식으로 추가할 수 있습니다. 추가한 데이터를 네이티브 형식으로만 검색하려면 매개 변수를 />로 설정하여 호출 합니다.

와 호환GetData되는 모든 형식으로 DataObject 데이터를 검색할 수 있습니다. 예를 들어 텍스트를 유니코드로 변환할 수 있습니다. 저장된 형식으로 데이터를 검색하려면 매개 변수를 />로 설정하여 호출 합니다.

데이터가 저장되는 형식을 확인하려면 다음을 호출 GetFormats합니다. 형식을 사용할 수 있는지 확인하려면 원하는 형식으로 호출 GetDataPresent 합니다.

이 클래스는 DataObject 공통 형식의 데이터를 더 쉽게 작업할 수 있는 추가 메서드를 제공합니다. 특정 형식DataObject의 데이터를 추가하려면 다음과 같은 SetText적절한 SetFormat 메서드를 사용합니다. 특정 형식 DataObject의 데이터를 검색하려면 먼저 적절한 ContainsFormat 메서드(예: ContainsText)를 호출하여 해당 형식의 데이터를 포함하는지 여부를 DataObject 확인한 다음 적절한 GetFormat 메서드(예: GetText)를 호출하여 데이터가 포함된 경우 DataObject 데이터를 검색합니다.

추가 정보

• Clipboard
• IDataObject
• DataFormats