Clipboard.GetText 메서드

정의

클립보드에서 텍스트 데이터를 검색합니다.Retrieves text data from the Clipboard.

오버로드

GetText()

운영 체제에 따라 Text 또는 UnicodeText 형식의 텍스트 데이터를 클립보드에서 검색합니다.Retrieves text data from the Clipboard in the Text or UnicodeText format, depending on the operating system.

GetText(TextDataFormat)

지정된 TextDataFormat 값이 나타내는 형식의 텍스트 데이터를 클립보드에서 검색합니다.Retrieves text data from the Clipboard in the format indicated by the specified TextDataFormat value.

GetText()

운영 체제에 따라 Text 또는 UnicodeText 형식의 텍스트 데이터를 클립보드에서 검색합니다.Retrieves text data from the Clipboard in the Text or UnicodeText format, depending on the operating system.

public:
 static System::String ^ GetText();
public static string GetText ();
static member GetText : unit -> string
Public Shared Function GetText () As String

반환

클립보드 텍스트 데이터이거나, 운영 체제에 따라 Empty 또는 Text 형식의 데이터가 클립보드에 없으면 UnicodeText입니다.The Clipboard text data or Empty if the Clipboard does not contain data in the Text or UnicodeText format, depending on the operating system.

예외

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

예제

다음 예제에서는 오버 로드는 GetText 메서드는이 오버 로드와 비슷합니다.The following example demonstrates an overload of the GetText method that is similar to this overload.

// 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

설명

이 메서드는 텍스트 데이터를 반환 합니다 UnicodeText 서식 Windows XP Home Edition, Windows XP Professional, Windows Server 2003Windows XP Home Edition, Windows XP Professional, Windows Server 2003Windows 2000Windows 2000합니다.This method returns text data in the UnicodeText format on Windows XP Home Edition, Windows XP Professional, Windows Server 2003Windows XP Home Edition, Windows XP Professional, Windows Server 2003 and Windows 2000Windows 2000. 이 메서드가 있는 텍스트 데이터를 반환 하는 고, 그렇지는 Text 형식입니다.Otherwise, this method returns text data in the Text format.

사용 된 ContainsText 이 메서드를 사용 하 여 검색 하기 전에 클립보드에 텍스트 데이터가 포함 되어 있는지 여부를 결정 하는 방법입니다.Use the ContainsText method to determine whether the Clipboard contains text data before retrieving it with this method.

사용 된 SetText 클립보드에 텍스트 데이터를 추가 하는 방법입니다.Use the SetText method to add text data to the Clipboard.

참고

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

추가 정보

GetText(TextDataFormat)

지정된 TextDataFormat 값이 나타내는 형식의 텍스트 데이터를 클립보드에서 검색합니다.Retrieves text data from the Clipboard in the format indicated by the specified TextDataFormat value.

public:
 static System::String ^ GetText(System::Windows::Forms::TextDataFormat format);
public static string GetText (System.Windows.Forms.TextDataFormat format);
static member GetText : System.Windows.Forms.TextDataFormat -> string
Public Shared Function GetText (format As TextDataFormat) As String

매개 변수

format
TextDataFormat

TextDataFormat 값 중 하나입니다.One of the TextDataFormat values.

반환

클립보드 텍스트 데이터이거나, 클립보드에 지정된 형식의 데이터가 없으면 Empty입니다.The Clipboard text data or Empty if the Clipboard does not contain data in the specified format.

예외

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

format는 유효한 TextDataFormat 값이 아닙니다.format is not a valid TextDataFormat value.

예제

다음 예제에서는이 멤버를 보여 줍니다.The following example demonstrates this member.

// 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 이 메서드를 사용 하 여 검색 하기 전에 클립보드에 텍스트 데이터가 포함 되어 있는지 여부를 결정 하는 방법입니다.Use the ContainsText method to determine whether the Clipboard contains text data before retrieving it with this method.

사용 된 SetText 클립보드에 텍스트 데이터를 추가 하는 방법입니다.Use the SetText method to add text data to the Clipboard.

참고

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

추가 정보

적용 대상