Clipboard.GetText Метод

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

Извлекает текстовые данные из буфера обмена.

Перегрузки

Имя Описание
GetText(TextDataFormat)

Извлекает текстовые данные из буфера обмена в формате, указанном указанным значением TextDataFormat .
GetText()

Извлекает текстовые данные из буфера обмена в Text зависимости UnicodeText от операционной системы.

GetText(TextDataFormat)

Исходный код:
Clipboard.cs
Исходный код:
Clipboard.cs
Исходный код:
Clipboard.cs
Исходный код:
Clipboard.cs
Исходный код:
Clipboard.cs

Извлекает текстовые данные из буфера обмена в формате, указанном указанным значением TextDataFormat .

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 .

Возвращаемое значение

String

Текстовые данные буфера обмена или Empty если буфер обмена не содержит данные в указанном формате.

Исключения

ExternalException

Не удалось очистить буфер обмена. Обычно это происходит, когда буфер обмена используется другим процессом.

ThreadStateException

Текущий поток не находится в режиме однопоточной квартиры (STA). Добавьте его в STAThreadAttribute метод приложения Main .

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 Используйте метод, чтобы определить, содержит ли буфер обмена текстовые данные перед получением этого метода.

SetText Используйте метод для добавления текстовых данных в буфер обмена.

Note

Класс Clipboard можно использовать только в потоках, настроенных на режим однопотоковой модели (STA). Чтобы использовать этот класс, убедитесь, что метод Main помечен атрибутом STAThreadAttribute.

См. также раздел

Применяется к

GetText()

Исходный код:
Clipboard.cs
Исходный код:
Clipboard.cs
Исходный код:
Clipboard.cs
Исходный код:
Clipboard.cs
Исходный код:
Clipboard.cs

Извлекает текстовые данные из буфера обмена в Text зависимости UnicodeText от операционной системы.

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

Возвращаемое значение

String

Текстовые данные буфера обмена или Empty если буфер обмена не содержит данные в Text формате или UnicodeText в зависимости от операционной системы.

Исключения

ExternalException

Не удалось очистить буфер обмена. Обычно это происходит, когда буфер обмена используется другим процессом.

ThreadStateException

Текущий поток не находится в режиме однопоточной квартиры (STA). Добавьте его в STAThreadAttribute метод приложения Main .

Примеры

В следующем примере показана перегрузка GetText метода, аналогичного этой перегрузке.

// 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 2003 и Windows 2000. В противном случае этот метод возвращает текстовые Text данные в формате.

ContainsText Используйте метод, чтобы определить, содержит ли буфер обмена текстовые данные перед получением этого метода.

SetText Используйте метод для добавления текстовых данных в буфер обмена.

Note

Класс Clipboard можно использовать только в потоках, настроенных на режим однопотоковой модели (STA). Чтобы использовать этот класс, убедитесь, что метод Main помечен атрибутом STAThreadAttribute.

См. также раздел

Применяется к