Clipboard.SetText 메서드

  • 참조

정의

네임스페이스:
System.Windows.Forms
어셈블리:
System.Windows.Forms.dll

클립보드를 지운 다음 텍스트 데이터를 추가합니다.

오버로드

SetText(String)

클립보드를 지운 다음 운영 체제에 따라 Text 또는 UnicodeText 형식의 텍스트 데이터를 클립보드에 추가합니다.
SetText(String, TextDataFormat)

클립보드를 지운 다음 지정된 TextDataFormat 값이 나타내는 형식의 텍스트 데이터를 클립보드에 추가합니다.

SetText(String)

클립보드를 지운 다음 운영 체제에 따라 Text 또는 UnicodeText 형식의 텍스트 데이터를 클립보드에 추가합니다.

public:
 static void SetText(System::String ^ text);
public static void SetText (string text);
static member SetText : string -> unit
Public Shared Sub SetText (text As String)

매개 변수

text
String

클립보드에 추가할 텍스트입니다.

예외

ExternalException

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

ThreadStateException

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

ArgumentNullException

text이 null 또는 Empty입니다.

예제

다음 예제에서는 이 오버로드와 유사한 메서드의 SetText 오버로드를 보여 줍니다.

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

설명

이 메서드는 Windows XP Home Edition, Windows XP Professional, Windows Server 2003 및 Windows 2000에서 텍스트 데이터를 UnicodeText 형식으로 추가합니다. 그렇지 않으면 이 메서드는 텍스트 데이터를 형식으로 Text 추가합니다.

클립보드에서 텍스트 데이터를 검색하려면 먼저 메서드를 ContainsText 사용하여 검색하기 전에 GetText 클립보드에 텍스트 데이터가 포함되어 있는지 여부를 확인합니다.

참고

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

추가 정보

적용 대상

SetText(String, TextDataFormat)

클립보드를 지운 다음 지정된 TextDataFormat 값이 나타내는 형식의 텍스트 데이터를 클립보드에 추가합니다.

public:
 static void SetText(System::String ^ text, System::Windows::Forms::TextDataFormat format);
public static void SetText (string text, System.Windows.Forms.TextDataFormat format);
static member SetText : string * System.Windows.Forms.TextDataFormat -> unit
Public Shared Sub SetText (text As String, format As TextDataFormat)

매개 변수

text
String

클립보드에 추가할 텍스트입니다.

format
TextDataFormat

TextDataFormat 값 중 하나입니다.

예외

ExternalException

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

ThreadStateException

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

ArgumentNullException

text이 null 또는 Empty입니다.

InvalidEnumArgumentException

format는 유효한 TextDataFormat 값이 아닙니다.

예제

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

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

설명

클립보드에서 텍스트 데이터를 검색하려면 먼저 메서드를 ContainsText 사용하여 검색하기 전에 GetText 클립보드에 텍스트 데이터가 포함되어 있는지 여부를 확인합니다.

참고

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

추가 정보

적용 대상