Clipboard.GetData(String) 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

클립보드에서 지정된 형식의 데이터를 검색합니다.

public:
 static System::Object ^ GetData(System::String ^ format);

public static object GetData (string format);

public static object? GetData (string format);

static member GetData : string -> obj

Public Shared Function GetData (format As String) As Object

매개 변수

format

String

검색할 데이터의 형식입니다. 미리 정의된 형식에 대한 자세한 내용은 DataFormats를 참조하십시오.

반환

Object

클립보드 데이터를 나타내는 Object이거나, 클립보드에 지정된 format으로 되어 있거나 해당 형식으로 변환될 수 있는 데이터가 없으면 null입니다.

예외

ExternalException

클립보드를 지울 수 없는 경우. 이 예외는 일반적으로 다른 프로세스에서 클립보드를 사용하고 있는 경우 발생합니다.

ThreadStateException

현재 스레드가 STA(단일 스레드 아파트) 모드에 있지 않은 경우. STAThreadAttribute를 애플리케이션의 Main 메서드에 추가합니다.

예제

다음 예제에서는 이 멤버를 보여 줍니다.

// 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 사용하여 클립보드를 검색하기 전에 클립보드에 지정된 형식의 데이터가 포함되어 있는지 또는 호환 가능한 형식으로 포함되어 있는지 여부를 확인할 수 있습니다.

이 메서드가 지정된 형식의 데이터를 찾을 수 없는 경우 데이터를 형식으로 변환하려고 시도합니다. 데이터를 지정된 형식으로 변환할 수 없거나 데이터가 자동 변환으로 설정된 false상태에서 저장된 경우 이 메서드는 반환합니다 null.

참고

변환이 허용되도록 지정하고 요청된 형식이 저장된 형식과 호환되는 경우 데이터를 다른 형식으로 변환할 수 있습니다. 예를 들어 유니코드로 저장된 데이터를 텍스트로 변환할 수 있습니다.

클래스는 Clipboard STA(단일 스레드 아파트) 모드로 설정된 스레드에서만 사용할 수 있습니다. 이 클래스를 사용하려면 메서드가 Main 특성으로 STAThreadAttribute 표시되어 있는지 확인합니다.

메서드를 SetData 사용하여 특정 형식의 클립보드에 데이터를 추가합니다.

추가 정보

• Object
• DataFormats
• ContainsData(String)
• SetData(String, Object)