Clipboard Clipboard Clipboard Clipboard Class

Определение

Предоставляет статические методы, которые способствуют двунаправленной передаче данных в системный буфер обмена.Provides static methods that facilitate transferring data to and from the system Clipboard.

public ref class Clipboard abstract sealed
public static class Clipboard
type Clipboard = class
Public Class Clipboard
Наследование
ClipboardClipboardClipboardClipboard

Примеры

В следующем примере показано, как для добавления данных в системном буфере обмена.The following example shows how to add data to the system 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))

Комментарии

Все приложения для WindowsWindows совместное использование системного буфера обмена, поэтому содержимое изменяется при переходе в другое приложение.All applications for WindowsWindows share the system Clipboard, so the contents are subject to change when you switch to another application.

Список стандартных форматов, доступных для использования с Clipboard , представлена в разделе DataFormats класса.For a list of predefined formats available to use with the Clipboard class, see the DataFormats class.

Оповещение системы безопасности: В целях безопасности следующие моменты следует иметь в виду.Security Alert: For security purposes, the following points should be kept in mind.

  • Операции вставки должны быть инициированной пользователем (Ctrl + V, меню вставки).Paste operations need to be user initiated (Ctrl-V, Paste Menu).

  • Копировать можно только выбранное пользователем содержимого.Copy can only be on user selected content.

  • При копировании или вырезании, частично доверяемый код помещает открытый текст и Язык XAMLExtensible Application Markup Language (XAML) в буфер обмена.On copy or cut, partial trust code puts plaintext and Язык XAMLExtensible Application Markup Language (XAML) on to the clipboard. Открытый текст содержит текст, текст в формате Юникод, текст OEM (Exchange объектной модели) и CSV (значения с разделителями запятыми).Plaintext includes text, Unicode text, OEM (Object Exchange Model) text, and CSV (Comma-separated values).

  • При вставке Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) будет вставлено Язык XAMLExtensible Application Markup Language (XAML) ли источник содержимого с сайта столь же или более высоким доверием.On paste, Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) will paste in Язык XAMLExtensible Application Markup Language (XAML) if the source of that content is from a equally trusted or more trusted site. В частности:Specifically:

    • Приложение с частичным доверием можно вставить Язык XAMLExtensible Application Markup Language (XAML) из приложение с полным доверием.A partial trust application can paste Язык XAMLExtensible Application Markup Language (XAML) from a full trust application.

    • Приложение с частичным доверием можно вставить Язык XAMLExtensible Application Markup Language (XAML) из приложения с частичным доверием.A partial trust application can paste Язык XAMLExtensible Application Markup Language (XAML) from a partial trust application.

    • Приложение с полным доверием можно вставить XAML только из другого приложения, полностью доверенным.A full trust application can paste XAML only from another fully trusted application.

    • Отличный отWindows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) полный уровень доверия приложения можно проверить формат ApplicationTrust в буфер обмена и очистить XAML, при необходимости.A non-Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) full trust application can examine the ApplicationTrust format on the clipboard and sanitize the XAML if appropriate.

Методы

Clear() Clear() Clear() Clear()

Очищает любые данные из системного буфера обмена.Clears any data from the system Clipboard.

ContainsAudio() ContainsAudio() ContainsAudio() ContainsAudio()

Запрашивает буфер обмена на наличие данных в формате WaveAudio.Queries the Clipboard for the presence of data in the WaveAudio data format.

ContainsData(String) ContainsData(String) ContainsData(String) ContainsData(String)

Запрашивает буфер обмена на наличие данных в указанном формате.Queries the Clipboard for the presence of data in a specified data format.

ContainsFileDropList() ContainsFileDropList() ContainsFileDropList() ContainsFileDropList()

Запрашивает буфер обмена на наличие данных в формате FileDrop.Queries the Clipboard for the presence of data in the FileDrop data format.

ContainsImage() ContainsImage() ContainsImage() ContainsImage()

Запрашивает буфер обмена на наличие данных в формате Bitmap.Queries the Clipboard for the presence of data in the Bitmap data format.

ContainsText() ContainsText() ContainsText() ContainsText()

Запрашивает буфер обмена на наличие данных в формате UnicodeText.Queries the Clipboard for the presence of data in the UnicodeText format.

ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat) ContainsText(TextDataFormat)

Запрашивает буфер обмена на наличие данных в текстовом формате.Queries the Clipboard for the presence of data in a text data format.

Flush() Flush() Flush() Flush()

Окончательно добавляет данные из Clipboard, чтобы они были доступны после закрытия исходного приложения.Permanently adds the data that is on the Clipboard so that it is available after the data's original application closes.

GetAudioStream() GetAudioStream() GetAudioStream() GetAudioStream()

Возвращает поток данных из буфера обмена в формате WaveAudio.Returns a stream of Clipboard data in the WaveAudio data format.

GetData(String) GetData(String) GetData(String) GetData(String)

Извлекает данные в указанном формате из буфера обмена.Retrieves data in a specified format from the Clipboard.

GetDataObject() GetDataObject() GetDataObject() GetDataObject()

Возвращает объект данных, представляющий все содержимое буфера обмена.Returns a data object that represents the entire contents of the Clipboard.

GetFileDropList() GetFileDropList() GetFileDropList() GetFileDropList()

Возвращает коллекцию строк, содержащую список перенесенных файлов, доступный в буфере обмена.Returns a string collection that contains a list of dropped files available on the Clipboard.

GetImage() GetImage() GetImage() GetImage()

Возвращает объект BitmapSource из буфера обмена, содержащий данные в формате Bitmap.Returns a BitmapSource object from the Clipboard that contains data in the Bitmap format.

GetText() GetText() GetText() GetText()

Возвращает строку, содержащую данные UnicodeText из буфера обмена.Returns a string containing the UnicodeText data on the Clipboard.

GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat) GetText(TextDataFormat)

Возвращает строку, содержащую текстовые данные из буфера обмена.Returns a string containing text data on the Clipboard.

IsCurrent(IDataObject) IsCurrent(IDataObject) IsCurrent(IDataObject) IsCurrent(IDataObject)

Сравнивает указанный объект данных с содержимым буфера обмена.Compares a specified data object to the contents of the Clipboard.

SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[]) SetAudio(Byte[])

Сохраняет аудиоданные (в формате WaveAudio) в буфере обмена.Stores audio data (WaveAudio data format) on the Clipboard. Аудиоданные указываются в виде массива байтов.The audio data is specified as a byte array.

SetAudio(Stream) SetAudio(Stream) SetAudio(Stream) SetAudio(Stream)

Сохраняет аудиоданные (в формате WaveAudio) в буфере обмена.Stores audio data (WaveAudio data format) on the Clipboard. Аудиоданные указываются в виде потока.The audio data is specified as a stream.

SetData(String, Object) SetData(String, Object) SetData(String, Object) SetData(String, Object)

Сохраняет указанные данные в буфере обмена в указанном формате.Stores the specified data on the Clipboard in the specified format.

SetDataObject(Object) SetDataObject(Object) SetDataObject(Object) SetDataObject(Object)

Размещает указанный непостоянный объект данных в системном буфере обмена.Places a specified non-persistent data object on the system Clipboard.

SetDataObject(Object, Boolean) SetDataObject(Object, Boolean) SetDataObject(Object, Boolean) SetDataObject(Object, Boolean)

Размещает указанный объект данных в системном буфере обмена и принимает логический параметр, указывающий, следует ли оставлять этот объект в буфере обмена при выходе из приложения.Places a specified data object on the system Clipboard and accepts a Boolean parameter that indicates whether the data object should be left on the Clipboard when the application exits.

SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection) SetFileDropList(StringCollection)

Сохраняет в буфере обмена данные FileDrop.Stores FileDrop data on the Clipboard. Список перенесенных файлов указывается в виде коллекции строк.The dropped file list is specified as a string collection.

SetImage(BitmapSource) SetImage(BitmapSource) SetImage(BitmapSource) SetImage(BitmapSource)

Сохраняет в буфере обмена данные Bitmap.Stores Bitmap data on the Clipboard. Данные изображения обрабатываются как BitmapSource.The image data is specified as a BitmapSource.

SetText(String) SetText(String) SetText(String) SetText(String)

Сохраняет в буфере обмена данные UnicodeText.Stores UnicodeText data on the Clipboard.

SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat) SetText(String, TextDataFormat)

Сохраняет текстовые данные в буфере обмена в указанном текстовом формате.Stores text data on the Clipboard in a specified text data format. Данные UnicodeText для сохранения указываются в виде строки.The UnicodeText data to store is specified as a string.

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

Дополнительно