Clipboard.ContainsData(String) 메서드

정의

지정된 형식으로 되어 있거나 해당 형식으로 변환될 수 있는 데이터가 클립보드에 있는지 여부를 나타냅니다.Indicates whether there is data on the Clipboard that is in the specified format or can be converted to that format.

public:
 static bool ContainsData(System::String ^ format);
public static bool ContainsData (string format);
static member ContainsData : string -> bool
Public Shared Function ContainsData (format As String) As Boolean

매개 변수

format
String

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

반환

클립보드에 지정된 format으로 되어 있거나 해당 형식으로 변환될 수 있는 데이터가 있으면 true이고, 그렇지 않으면 false입니다.true if there is data on the Clipboard that is in the specified format or can be converted to that format; otherwise, false.

예외

클립보드를 지울 수 없는 경우.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

설명

DataFormats 클래스에이 메서드를 사용 하 여 사용할 수 있는 미리 정의 된 형식 이름이 포함 되어 있습니다.The DataFormats class contains pre-defined format names that you can use with this method.

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

참고

데이터는 변환이 가능 하도록 지정 합니다. 저장 된 경우 및 요청된 된 형식으로 저장 된 형식과 호환 되는 경우 다른 형식으로 변환할 수 있습니다.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.

보안

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

적용 대상

추가 정보