Бөлісу құралы:

Clipboard.ContainsData(String) Метод

  • Ссылка

Определение

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

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

public:
 static bool ContainsData(System::String ^ format);
public static bool ContainsData (string format);
public static bool ContainsData (string? format);
static member ContainsData : string -> bool
Public Shared Function ContainsData (format As String) As Boolean

Параметры

format
String

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

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

Boolean

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

Исключения

ExternalException

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

ThreadStateException

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

Примеры

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

// Demonstrates SetData, ContainsData, and GetData.
public Object SwapClipboardFormattedData(String format, Object data)
{
    Object returnObject = null;
    if (Clipboard.ContainsData(format))
    {
        returnObject = Clipboard.GetData(format);
        Clipboard.SetData(format, data);
    }
    return returnObject;
}

' Demonstrates SetData, ContainsData, and GetData.
Public Function SwapClipboardFormattedData( _
    ByVal format As String, ByVal data As Object) As Object

    Dim returnObject As Object = Nothing

    If (Clipboard.ContainsData(format)) Then
        returnObject = Clipboard.GetData(format)
        Clipboard.SetData(format, data)
    End If

    Return returnObject

End Function

Комментарии

Класс DataFormats содержит предварительно определенные имена форматов, которые можно использовать с этим методом.

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

Примечание

Данные можно преобразовать в другой формат, если он был сохранен, указывая, что преобразование разрешено, и если запрошенный формат совместим с сохраненным форматом. Например, данные, хранящиеся в Юникоде, можно преобразовать в текст.

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

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

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