Метод My.Computer.Clipboard.SetText

Статья
11/05/2008

Обновлен: Ноябрь 2007

Для записи текста в буфер обмена.

' Usage
My.Computer.Clipboard.SetText(text)
My.Computer.Clipboard.SetText(text ,format)
' Declaration
Public Sub SetText( _
   ByVal text As String _
)
' -or-
Public Sub SetText( _
   ByVal text As String, _
   ByVal format As System.Windows.Forms.TextDataFormat _
)

Параметры

text
String. Текст, который требуется записать. Требуется.
format
TextDataFormat. Формат, который требуется использовать при записи текста. По умолчанию используется значение UnicodeText. Требуется.

Исключения

Исключение может возникнуть при следующих условиях.

Параметр text является пустой строкой (ArgumentException).
text равно Nothing (ArgumentNullException).

Заметки

Возможные форматы — CommaSeparatedValue, Html, Rtf и UnicodeText.

Метод требует AllClipboard.

Предыдущий формат буфера обмена не сохраняется.

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

Задачи

В приведенной ниже таблице показаны примеры задач, в которых используется метод My.Computer.Clipboard.SetText.

To	См. раздел
Запись текста в буфер обмена	Практическое руководство. Запись в буфер обмена в Visual Basic

Пример

В этом примере в буфер обмена записывается строка This is a test string..

My.Computer.Clipboard.SetText("This is a test string.")

Требования

Пространство имен:Microsoft.VisualBasic.MyServices

Класс:ClipboardProxy (предоставляет доступ к Clipboard)

**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Тип проекта	Доступность
Приложение Windows	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Нет
Служба Windows	Да
Веб-узел	Нет