Clipboard.SetData(String, Object) 메서드

정의

클립보드를 지운 다음 지정된 형식으로 데이터를 추가합니다.Clears the Clipboard and then adds data in the specified format.

public:
 static void SetData(System::String ^ format, System::Object ^ data);
public static void SetData (string format, object data);
static member SetData : string * obj -> unit
Public Shared Sub SetData (format As String, data As Object)

매개 변수

format
String

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

data
Object

추가할 데이터를 나타내는 Object입니다.An Object representing the data to add.

예외

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

datanull인 경우data is null.

예제

다음 예제에서는이 멤버를 보여 줍니다.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

설명

대상 애플리케이션의 형식을 모르는 경우이 메서드를 사용 하 여 여러 형식의 데이터를 저장할 수 있습니다.If you do not know the format of the target application, you can store data in multiple formats using this method.

이 메서드를 사용 하 여 저장 된 데이터를 검색할 때 호환 형식으로 변환할 수 있습니다.Data stored using this method can be converted to a compatible format when it is retrieved.

특정 형식으로 클립보드의 데이터를 검색 하려면 먼저 사용 합니다 ContainsData 검색 하기 전에 해당 형식의 데이터가 클립보드에 포함 되는지 여부를 결정 하는 방법의 GetData 메서드.To retrieve data from the Clipboard in a particular format, first use the ContainsData method to determine whether the Clipboard contains data in that format before retrieving it with the GetData method.

참고

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 adding data of any type or format to the system Clipboard. 연결 된 열거형: AllClipboardAssociated enumeration: AllClipboard

적용 대상

추가 정보