Clipboard.SetDataObject 메서드

정의

네임스페이스:

System.Windows

어셈블리:

PresentationCore.dll

시스템 클립보드에 지정된 데이터 개체를 저장합니다.

오버로드

SetDataObject(Object)	시스템 클립보드에 지정된 비영구 데이터 개체를 배치합니다.
SetDataObject(Object, Boolean)	시스템 클립보드에 지정된 데이터 개체를 배치하고, 애플리케이션 종료 시 데이터 개체를 클립보드에 남겨 둘지 여부를 나타내는 부울 매개 변수를 적용합니다.

SetDataObject(Object)

시스템 클립보드에 지정된 비영구 데이터 개체를 배치합니다.

public:
 static void SetDataObject(System::Object ^ data);

[System.Security.SecurityCritical]
public static void SetDataObject (object data);

public static void SetDataObject (object data);

[<System.Security.SecurityCritical>]
static member SetDataObject : obj -> unit

static member SetDataObject : obj -> unit

Public Shared Sub SetDataObject (data As Object)

매개 변수

data

Object

시스템 클립보드에 배치할 데이터 개체(IDataObject를 구현하는 개체)입니다.

특성

SecurityCriticalAttribute

예외

ArgumentNullException

data이(가) null인 경우

ExternalException

클립보드에 액세스하는 동안 오류가 발생한 경우. 예외 정보에는 구체적인 오류를 식별하는 HResult가 포함됩니다. ErrorCode를 참조하십시오.

설명

기본적으로 데이터를 시스템 클립보드에 배치 된 SetDataObject 애플리케이션이 종료 되 면 클립보드에서 자동으로 지워집니다.

참고

기본적으로 애플리케이션 종료 시 클립보드 지우기 데이터 기본적으로 선택 취소 하는 것이 아니라 애플리케이션 종료에 클립보드에 남겨 두는 다른 구현에서 다를 수 있습니다. 사용 하 여는 SetDataObject 오버 로드 하 고 지정 합니다 copy 매개 변수에 true 애플리케이션 종료 시 클립보드의 선택을 취소 하는 데이터를 원하지 않는 경우.

DataObject 기본 구현을 제공 합니다 IDataObject 인터페이스입니다.

추가 정보

• GetDataObject()

SetDataObject(Object, Boolean)

시스템 클립보드에 지정된 데이터 개체를 배치하고, 애플리케이션 종료 시 데이터 개체를 클립보드에 남겨 둘지 여부를 나타내는 부울 매개 변수를 적용합니다.

public:
 static void SetDataObject(System::Object ^ data, bool copy);

[System.Security.SecurityCritical]
public static void SetDataObject (object data, bool copy);

public static void SetDataObject (object data, bool copy);

[<System.Security.SecurityCritical>]
static member SetDataObject : obj * bool -> unit

static member SetDataObject : obj * bool -> unit

Public Shared Sub SetDataObject (data As Object, copy As Boolean)

매개 변수

data

Object

시스템 클립보드에 배치할 데이터 개체(IDataObject를 구현하는 개체)입니다.

copy

Boolean

애플리케이션 종료 시 시스템 클립보드에 데이터를 남겨 두려면 true이고, 애플리케이션 종료 시 시스템 클립보드에서 데이터를 지우려면 false입니다.

특성

SecurityCriticalAttribute

예외

ArgumentNullException

data이(가) null인 경우

ExternalException

클립보드에 액세스하는 동안 오류가 발생한 경우. 예외 정보에는 구체적인 오류를 식별하는 HResult가 포함됩니다. ErrorCode를 참조하십시오.

예제

다음 예제에서는이 메서드를 사용 하는 방법을 보여 줍니다.

               // For this example, the data to be placed on the clipboard is a simple
               // string.
               string textData = "I want to put this string on the clipboard.";
               // The example will enable auto-conversion of data for this data object.
               bool autoConvert = true;

               // Create a new data object, specifying the data format, data to encapsulate, and enabling
               // auto-conversion services.
               DataObject data = new DataObject(DataFormats.UnicodeText, (Object)textData, autoConvert);
               
               // If the data to be copied is supposed to be persisted after the application ends, 
               // then set the second parameter of SetDataObject to true.
               if(persistentData)
               {
                   // Place the persisted data on the clipboard.
                   Clipboard.SetDataObject(data, true);
               }
               else
               {
                   // Place the non-persisted data on the clipboard.
                   Clipboard.SetDataObject(data, false);
               }

               // If you keep a copy of the source data object, you can use the IsCurrent method to see if
               // the data object is still on the clipboard.
               bool isOriginalDataObject = Clipboard.IsCurrent(data);

' For this example, the data to be placed on the clipboard is a simple
' string.
Dim textData As String = "I want to put this string on the clipboard."
' The example will enable auto-conversion of data for this data object.
Dim autoConvert As Boolean = True

' Create a new data object, specifying the data format, data to encapsulate, and enabling
' auto-conversion services.
Dim data As New DataObject(DataFormats.UnicodeText, CType(textData, Object), autoConvert)

' If the data to be copied is supposed to be persisted after the application ends, 
' then set the second parameter of SetDataObject to true.
If persistentData Then
    ' Place the persisted data on the clipboard.
    Clipboard.SetDataObject(data, True)
Else
    ' Place the non-persisted data on the clipboard.
    Clipboard.SetDataObject(data, False)
End If

' If you keep a copy of the source data object, you can use the IsCurrent method to see if
' the data object is still on the clipboard.
Dim isOriginalDataObject As Boolean = Clipboard.IsCurrent(data)

설명

DataObject 기본 구현을 제공 합니다 IDataObject 인터페이스입니다. IsCurrent 데이터 개체를 마지막으로 이전에 클립보드에 배치 결정 SetDataObject 호출 합니다.

추가 정보

• GetDataObject()