Clipboard.ContainsData(String) 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

지정된 형식으로 되어 있거나 해당 형식으로 변환될 수 있는 데이터가 클립보드에 있는지 여부를 나타냅니다.

public:
 static bool ContainsData(System::String ^ format);

public static bool ContainsData (string format);

public static bool ContainsData (string? format);

static member ContainsData : string -> bool

Public Shared Function ContainsData (format As String) As Boolean

매개 변수

format

String

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

반환

Boolean

클립보드에 지정된 format으로 되어 있거나 해당 형식으로 변환될 수 있는 데이터가 있으면 true이고, 그렇지 않으면 false입니다.

예외

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

설명

클래스에는 DataFormats 이 메서드와 함께 사용할 수 있는 미리 정의된 형식 이름이 포함되어 있습니다.

이 메서드를 사용하여 클립보드에 지정된 형식의 데이터가 포함되어 있는지 또는 호환되는 형식으로 데이터를 포함하는지 확인한 후 메서드를 사용하여 GetData 데이터를 검색합니다.

참고

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

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

추가 정보

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