IDataObject 인터페이스

정의

데이터를 전송하기 위한 형식 독립적 메커니즘을 제공합니다.Provides a format-independent mechanism for transferring data.

public interface class IDataObject
[System.Runtime.InteropServices.ComVisible(true)]
public interface IDataObject
type IDataObject = interface
Public Interface IDataObject
파생
특성

설명

IDataObject 인터페이스를 사용 합니다 Clipboard 클래스 및 끌어서 놓기 작업 합니다.The IDataObject interface is used by the Clipboard class and in drag-and-drop operations.

클래스에서 구현 되는 경우는 IDataObject 메서드 클래스의 인스턴스에서 여러 형식의 데이터를 저장 하는 데 사용할 수 있습니다.When implemented in a class, the IDataObject methods allow the user to store data in multiple formats in an instance of the class. 둘 이상의 형식으로 데이터를 저장 하면 대상 애플리케이션을 모를 수도 형식 요구 사항을 가진가 저장된 된 데이터를 검색할 수 있습니다.Storing data in more than one format increases the chance that a target application, whose format requirements you might not know, can retrieve the stored data. 인스턴스의 데이터를 저장 하 IDataObject를 호출 합니다 SetData 메서드 데이터 형식을 지정 하 고는 format 매개 변수.To store data in an instance of IDataObject, call the SetData method and specify the data format in the format parameter. 설정 된 autoConvert 매개 변수를 false 경우 원하지 않는 저장 된 데이터를 검색할 때 다른 형식으로 변환할 수 있습니다.Set the autoConvert parameter to false if you do not want stored data to be converted to another format when it is retrieved. 호출할 SetData 인스턴스 중 하나에서 여러 번 IDataObject 둘 이상의 형식에 데이터를 저장 합니다.Invoke SetData multiple times on one instance of IDataObject to store data in more than one format.

저장 된 데이터를 검색 하는 IDataObject 호출 하 여를 GetData 에서 서식 메서드 및 데이터를 지정 하는 format 매개 변수.You retrieve stored data from an IDataObject by calling the GetData method and specifying the data format in the format parameter. 설정 합니다 autoConvert 매개 변수를 false 만 지정 된 형식으로 저장 된 데이터를 검색 합니다.Set the autoConvert parameter to false to retrieve only data that was stored in the specified format. 저장 된 데이터가 지정 된 형식으로 변환 하려면 설정 autoConverttrue, 또는 사용 하지 마십시오 autoConvert합니다.To convert the stored data to the specified format, set autoConvert to true, or do not use autoConvert.

저장 된 데이터의 형식을 결정 하는 IDataObject, 다음을 사용 하 여 IDataObject 메서드.To determine the formats of the data stored in an IDataObject, use the following IDataObject methods.

  • 호출 된 GetFormats 는 데이터를 사용할 수 있는 모든 형식의 배열을 검색 하는 방법입니다.Call the GetFormats method to retrieve an array of all the formats in which the data is available. 설정 된 autoConvert 매개 변수를 false 저장 되는 데이터 형식만 가져오려고 합니다.Set the autoConvert parameter to false to get only the formats in which the data is stored. 설정 데이터를 사용할 수 있는 모든 형식을 가져오려고 autoConverttrue, 또는이 매개 변수를 사용 하지 마십시오.To get all the formats in which the data is available, set autoConvert to true, or do not use this parameter.

  • 호출 된 GetDataPresent 저장 된 데이터를 특정 형식으로 사용할 수 있는지 확인 하는 방법입니다.Call the GetDataPresent method to determine whether stored data is available in a certain format. 지정 된 형식으로 변환할 데이터를 저장된 하지 않으려면 설정 합니다 autoConvert 매개 변수를 false입니다.If you do not want stored data to be converted to the specified format, set the autoConvert parameter to false.

참조 된 DataObject 이 인터페이스의 구현에 대 한 클래스입니다.See the DataObject class for an implementation of this interface. 참조 된 DataFormats 미리 정의 된에 대 한 클래스 Clipboard 데이터 형식입니다.See the DataFormats class for the predefined Clipboard data formats.

메서드

GetData(String)

지정된 데이터 형식과 관련된 데이터를 검색합니다.Retrieves the data associated with the specified data 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(Type)

지정된 클래스 형식과 관련된 데이터를 검색합니다.Retrieves the data associated with the specified class type format.

GetDataPresent(String)

이 인스턴스에 저장된 데이터가 지정된 형식과 관련되어 있거나 해당 형식으로 변환될 수 있는지 여부를 확인합니다.Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetDataPresent(String, Boolean)

부울 값을 통해 데이터를 해당 형식으로 변환할지 여부를 확인하여 이 인스턴스에 저장된 데이터가 지정한 형식과 관련되어 있는지 여부를 확인합니다.Determines whether data stored in this instance is associated with the specified format, using a Boolean value to determine whether to convert the data to the format.

GetDataPresent(Type)

이 인스턴스에 저장된 데이터가 지정된 형식과 관련되어 있거나 해당 형식으로 변환될 수 있는지 여부를 확인합니다.Determines whether data stored in this instance is associated with, or can be converted to, the specified format.

GetFormats()

이 인스턴스에 저장된 데이터와 관련되어 있거나 해당 데이터를 변환할 수 있는 모든 형식의 목록을 반환합니다.Returns a list of all formats that data stored in this instance is associated with or can be converted to.

GetFormats(Boolean)

부울 값을 통해 데이터가 변환될 수 있는 모든 형식을 검색할지 또는 네이티브 데이터 형식만 검색할지를 결정하여 이 인스턴스에 저장된 데이터와 관련되어 있거나 해당 데이터를 변환할 수 있는 모든 형식의 목록을 가져옵니다.Gets a list of all formats that data stored in this instance is associated with or can be converted to, using a Boolean value to determine whether to retrieve all formats that the data can be converted to or only native data formats.

SetData(Object)

지정된 데이터를 이 형식에 대한 데이터 클래스를 사용하여 이 인스턴스에 저장합니다.Stores the specified data in this instance, using the class of the data for the format.

SetData(String, Boolean, Object)

부울 값을 통해 데이터를 다른 형식으로 변환할 수 있는지 여부를 지정하여 선택한 데이터 및 관련된 형식을 이 인스턴스에 저장합니다.Stores the specified data and its associated format in this instance, using a Boolean value to specify whether the data can be converted to another format.

SetData(String, Object)

지정된 데이터 및 관련된 형식을 이 인스턴스에 저장합니다.Stores the specified data and its associated format in this instance.

SetData(Type, Object)

지정된 데이터 및 관련된 클래스 형식을 이 인스턴스에 저장합니다.Stores the specified data and its associated class type in this instance.

적용 대상

추가 정보