Clipboard.GetData(String) 메서드

정의

클립보드에서 지정된 형식의 데이터를 검색합니다.Retrieves data from the Clipboard in the specified format.

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

매개 변수

format
String

검색할 데이터의 형식입니다.The format of the data to retrieve. 미리 정의된 형식에 대한 자세한 내용은 DataFormats를 참조하십시오.See DataFormats for predefined formats.

반환

클립보드 데이터를 나타내는 Object이거나, 클립보드에 지정된 format으로 되어 있거나 해당 형식으로 변환될 수 있는 데이터가 없으면 null입니다.An Object representing the Clipboard data or null if the Clipboard does not contain any data that is in the specified format or can be converted to that format.

예외

클립보드를 지울 수 없는 경우.The Clipboard could not be cleared. 이 예외는 일반적으로 다른 프로세스에서 클립보드를 사용하고 있는 경우 발생합니다.This typically occurs when the Clipboard is being used by another process.

현재 스레드가 STA(단일 스레드 아파트) 모드에 있지 않은 경우.The current thread is not in single-threaded apartment (STA) mode. STAThreadAttribute를 애플리케이션의 Main 메서드에 추가합니다.Add the STAThreadAttribute to your application's Main method.

예제

다음 예제에서는이 멤버를 보여 줍니다.The following example demonstrates this member.

// Demonstrates SetData, ContainsData, and GetData.
public Object SwapClipboardFormattedData(String format, Object data)
{
    Object returnObject = null;
    if (Clipboard.ContainsData(format))
    {
        returnObject = Clipboard.GetData(format);
        Clipboard.SetData(format, data);
    }
    return returnObject;
}
' Demonstrates SetData, ContainsData, and GetData.
Public Function SwapClipboardFormattedData( _
    ByVal format As String, ByVal data As Object) As Object

    Dim returnObject As Object = Nothing

    If (Clipboard.ContainsData(format)) Then
        returnObject = Clipboard.GetData(format)
        Clipboard.SetData(format, data)
    End If

    Return returnObject

End Function

설명

사용 된 ContainsData 이 메서드를 사용 하 여 검색 하기 전에 지정된 된 형식 또는 호환 되는 형식의 데이터가 클립보드에 포함 되는지 여부를 결정 하는 방법입니다.Use the ContainsData method to determine whether the Clipboard contains data in the specified format or a compatible format before retrieving it with this method.

이 메서드는 지정 된 형식의 데이터를 찾을 수 없으면, 데이터 형식으로 변환 하려고 합니다.If this method cannot find data in the specified format, it attempts to convert the data to the format. 지정 된 형식으로 데이터를 변환할 수 없는 경우 또는 자동 변환 하 여 데이터를 저장 한 경우 false,이 메서드는 반환 null합니다.If the data cannot be converted to the specified format, or if the data was stored with automatic conversion set to false, this method returns null.

참고

데이터는 변환이 가능 하도록 지정 합니다. 저장 된 경우 및 요청된 된 형식으로 저장 된 형식과 호환 되는 경우 다른 형식으로 변환할 수 있습니다.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. 유니코드 텍스트로 변환할 수로 저장 된 데이터 예For example, data stored as Unicode can be converted to text.

Clipboard 단일 스레드 아파트 (STA) 모드를 설정 하는 스레드의 클래스 에서만 사용할 수 있습니다.The Clipboard class can only be used in threads set to single thread apartment (STA) mode. 이 클래스를 사용 하려면 프로그램 Main 표시 된 메서드가 STAThreadAttribute 특성입니다.To use this class, ensure that your Main method is marked with the STAThreadAttribute attribute.

사용 된 SetData 특정 형식으로 클립보드에 데이터를 추가 하는 방법입니다.Use the SetData method to add data to the Clipboard in a particular format.

보안

UIPermission
시스템 클립보드에 액세스 합니다.for access to the system Clipboard. 연결 된 열거형: AllClipboardAssociated enumeration: AllClipboard

적용 대상

추가 정보