Clipboard.ContainsText Метод

Определение

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

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

Перегрузки

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

Указывает, есть ли данные в буфере обмена в Text формате или UnicodeText в зависимости от операционной системы.
ContainsText(TextDataFormat)

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

ContainsText()

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

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

public:
 static bool ContainsText();
public static bool ContainsText();
static member ContainsText : unit -> bool
Public Shared Function ContainsText () As Boolean

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

Boolean

true Значение , если в буфере обмена есть текстовые данные; falseв противном случае .

Исключения

ExternalException

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

ThreadStateException

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

Примеры

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

// 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 формате.

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

Note

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

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

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

ContainsText(TextDataFormat)

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

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

public:
 static bool ContainsText(System::Windows::Forms::TextDataFormat format);
public static bool ContainsText(System.Windows.Forms.TextDataFormat format);
static member ContainsText : System.Windows.Forms.TextDataFormat -> bool
Public Shared Function ContainsText (format As TextDataFormat) As Boolean

Параметры

format
TextDataFormat

Одно из значений TextDataFormat .

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

Boolean

trueЗначение , если в буфере обмена есть текстовые данные в значении, formatуказанном для false; в противном случае.

Исключения

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

Комментарии

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

Note

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

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

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