Clipboard Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет статические методы, упрощающие передачу данных в системный буфер обмена и из нее.
public ref class Clipboard abstract sealedpublic static class Clipboardtype Clipboard = classPublic Class Clipboard- Наследование
-
Clipboard
Примеры
В следующем примере показано, как добавить данные в системный буфер обмена.
// For this example, the data to be placed on the clipboard is a simple
// string.
string textData = "I want to put this string on the clipboard.";
// After this call, the data (string) is placed on the clipboard and tagged
// with a data format of "Text".
Clipboard.SetData(DataFormats.Text, (Object)textData);
' For this example, the data to be placed on the clipboard is a simple
' string.
Dim textData As String = "I want to put this string on the clipboard."
' After this call, the data (string) is placed on the clipboard and tagged
' with a data format of "Text".
Clipboard.SetData(DataFormats.Text, CType(textData, Object))
Комментарии
Все приложения для Windows совместно используют системный буфер обмена, поэтому содержимое может изменяться при переходе на другое приложение.
Список стандартных форматов, доступных для использования с Clipboard классом, см. в DataFormats этом классе.
Оповещение системы безопасности: В целях безопасности следует учитывать следующие моменты.
Операции вставки должны быть инициированы пользователем (CTRL-V, меню вставки).
Копирование может быть только на выбранном пользователем содержимом.
При копировании или вырезать код частичного доверия помещает в буфер обмена открытый текст и расширяемый язык разметки приложений (XAML). Обычный текст включает текст, текст Юникода, текст OEM (объектная Exchange модель) и CSV-файл (разделенные запятыми значения).
При вставке Windows Presentation Foundation (WPF) вставляется в язык разметки расширяемых приложений (XAML), если источник этого содержимого является равно доверенным или более доверенным сайтом. Specifically:
Приложение с частичным доверием может вставить расширяемый язык разметки приложений (XAML) из приложения с полным доверием.
Приложение с частичным доверием может вставить язык разметки расширяемых приложений (XAML) из приложения с частичным доверием.
Приложение с полным доверием может вставить XAML только из другого полностью доверенного приложения.
Приложение, отличное от Windows Presentation Foundation (WPF) с полным доверием, может проверить формат ApplicationTrust в буфере обмена и отключить XAML при необходимости.
Методы
| Имя | Описание |
|---|---|
| Clear() |
Очищает все данные из системного буфера обмена. |
| ContainsAudio() |
Запрашивает буфер обмена для присутствия данных в WaveAudio формате данных. |
| ContainsData(String) |
Запрашивает буфер обмена для присутствия данных в указанном формате данных. |
| ContainsFileDropList() |
Запрашивает буфер обмена для присутствия данных в FileDrop формате данных. |
| ContainsImage() |
Запрашивает буфер обмена для присутствия данных в Bitmap формате данных. |
| ContainsText() |
Запрашивает буфер обмена для присутствия данных в UnicodeText формате. |
| ContainsText(TextDataFormat) |
Запрашивает буфер обмена для присутствия данных в текстовом формате данных. |
| Flush() |
Постоянно добавляет данные, расположенные на Clipboard том, чтобы оно было доступно после закрытия исходного приложения данных. |
| GetAudioStream() |
Возвращает поток данных буфера обмена в WaveAudio формате данных. |
| GetData(String) |
Извлекает данные в указанном формате из буфера обмена. |
| GetDataObject() |
Возвращает объект данных, представляющий все содержимое буфера обмена. |
| GetFileDropList() |
Возвращает строковую коллекцию, содержащую список удаленных файлов, доступных в буфере обмена. |
| GetImage() |
BitmapSource Возвращает объект из буфера обмена, содержащий данные в Bitmap формате. |
| GetText() |
Возвращает строку, UnicodeText содержащую данные в буфере обмена. |
| GetText(TextDataFormat) |
Возвращает строку, содержащую текстовые данные в буфере обмена. |
| IsCurrent(IDataObject) |
Сравнивает указанный объект данных с содержимым буфера обмена. |
| SetAudio(Byte[]) |
Хранит звуковые данные (WaveAudio формат данных) в буфере обмена. Звуковые данные указываются в виде массива байтов. |
| SetAudio(Stream) |
Хранит звуковые данные (WaveAudio формат данных) в буфере обмена. Звуковые данные указываются в виде потока. |
| SetData(String, Object) |
Сохраняет указанные данные в буфере обмена в указанном формате. |
| SetDataAsJson<T>(String, T) |
Предоставляет статические методы, упрощающие передачу данных в системный буфер обмена и из нее. |
| SetDataObject(Object, Boolean) |
Помещает указанный объект данных в системный буфер обмена и принимает логический параметр, указывающий, должен ли объект данных оставить в буфере обмена при выходе приложения. |
| SetDataObject(Object) |
Помещает в системный буфер обмена указанный не постоянный объект данных. |
| SetFileDropList(StringCollection) |
Хранит FileDrop данные в буфере обмена. Список удаленных файлов указывается в виде коллекции строк. |
| SetImage(BitmapSource) |
Хранит Bitmap данные в буфере обмена. Данные изображения указываются как .BitmapSource |
| SetText(String, TextDataFormat) |
Сохраняет текстовые данные в буфере обмена в указанном формате текстовых данных. Данные UnicodeText для хранения указываются в виде строки. |
| SetText(String) |
Хранит UnicodeText данные в буфере обмена. |
| TryGetData<T>(String, Func<TypeName,Type>, T) |
Предоставляет статические методы, упрощающие передачу данных в системный буфер обмена и из нее. |
| TryGetData<T>(String, T) |
Предоставляет статические методы, упрощающие передачу данных в системный буфер обмена и из нее. |
