ClipboardProxy Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет методы для управления буфером обмена.
public ref class ClipboardProxypublic class ClipboardProxytype ClipboardProxy = classPublic Class ClipboardProxy- Наследование
-
ClipboardProxy
Примеры
Этот пример считывает текст из буфера обмена в строку textOnClipboard.
Dim textOnClipboard As String = My.Computer.Clipboard.GetText()
Этот пример завершится ошибкой, если в буфере обмена нет текста.
Комментарии
Элементы, перенесенные или скопированные в буфер обмена, сохраняются даже после завершения работы приложения.
Данные в буфере обмена могут находиться в любом формате данных, который также называется форматом буфера обмена. Список стандартных форматов, используемых с буфером обмена, см. в разделе DataFormats. При перемещении или копировании элемента в буфер обмена элементы в других форматах удаляются. Чтобы сохранить другие форматы, используйте DataObject, который копирует все существующие в текущем буфере обмена, включая элементы, вставленные из других приложений. Поместите данные в буфер обмена в нескольких форматах, чтобы максимально повысить вероятность того, что целевое приложение, требования к формату которого могут не знать, может успешно получить данные.
Так как все Windows приложения совместно используют системный буфер обмена, содержимое может измениться при переходе на другое приложение.
Класс должен быть сериализуемым, чтобы он был помещен в буфер обмена. Дополнительные сведения см. в статье Serialization — C# или Serialization — Visual Basic.
При удаленном доступе к буферу обмена возникает исключение, ThreadStateException если доступ к потоку не работает в режиме STA (однопоточная квартира). Чтобы устранить эту проблему, задайте ThreadApartmentState для STAпараметра значение . Дополнительные сведения см. в разделе STAThreadAttribute.
Дополнительные сведения см. в разделе "Хранение данных в буфер обмена" и "Чтение" из буфера обмена.
Доступность по типу проекта
| тип проекта | В наличии |
|---|---|
| Приложение Windows | Yes |
| Библиотека классов | Yes |
| Консольное приложение | Yes |
| Библиотека элементов управления Windows | Yes |
| Библиотека веб-элементов управления | Нет |
| Службы Windows | Yes |
| Веб-сайт | Нет |
Методы
| Имя | Описание |
|---|---|
| Clear() |
Очищает буфер обмена. |
| ContainsAudio() |
Указывает, содержит ли буфер обмена звуковые данные. |
| ContainsData(String) |
Указывает, содержит ли буфер обмена данные в указанном пользовательском формате. |
| ContainsFileDropList() |
Возвращает значение, |
| ContainsImage() |
Возвращает значение, |
| ContainsText() |
Определяет, есть ли текст в буфере обмена. |
| ContainsText(TextDataFormat) |
Определяет, есть ли текст в буфере обмена. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetAudioStream() |
Извлекает аудиопоток из буфера обмена. |
| GetData(String) |
Устаревшие.
Извлекает данные в пользовательском формате из буфера обмена. |
| GetDataObject() |
Извлекает данные из буфера обмена в виде IDataObject. |
| GetFileDropList() |
Извлекает коллекцию строк, представляющих имена файлов из буфера обмена. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetImage() |
Извлекает изображение из буфера обмена. |
| GetText() |
Извлекает текст из буфера обмена. |
| GetText(TextDataFormat) |
Извлекает текст из буфера обмена. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| SetAudio(Byte[]) |
Записывает звуковые данные в буфер обмена. |
| SetAudio(Stream) |
Записывает звуковые данные в буфер обмена. |
| SetData(String, Object) |
Записывает данные в пользовательский формат в буфер обмена. |
| SetDataAsJson<T>(String, T) |
Предоставляет методы для управления буфером обмена. |
| SetDataObject(DataObject) |
Записывается DataObject в буфер обмена. |
| SetFileDropList(StringCollection) |
Записывает коллекцию строк, представляющих пути к файлу в буфер обмена. |
| SetImage(Image) |
Записывает изображение в буфер обмена. |
| SetText(String, TextDataFormat) |
Записывает текст в буфер обмена. |
| SetText(String) |
Записывает текст в буфер обмена. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TryGetData<T>(String, Func<TypeName,Type>, T) |
Предоставляет методы для управления буфером обмена. |
| TryGetData<T>(String, T) |
Предоставляет методы для управления буфером обмена. |
