My.Computer.Clipboard.SetText (Método)

Artículo
08/23/2008

Actualización: noviembre 2007

Escribe texto en el Portapapeles.

' 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 _
)

Parámetros

text
String. Texto que se va a escribir. Requerido.
format
TextDataFormat. Formato que se va a utilizar al escribir texto. El valor predeterminado es UnicodeText. Requerido.

Excepciones

Las condiciones siguientes pueden producir una excepción:

text es una cadena vacía (ArgumentException).
text es Nothing (ArgumentNullException).

Comentarios

Los formatos posibles son CommaSeparatedValue, Html, Rtf y UnicodeText.

El método requiere AllClipboard.

No se conservan formatos anteriores del Portapapeles.

Nota de seguridad:
Como otros usuarios pueden tener acceso al Portapapeles, no se debe utilizar para almacenar información confidencial, como contraseñas o datos reservados.

Tareas

La tabla siguiente muestra una lista de ejemplos de tareas en las que está implicado el método My.Computer.Clipboard.SetText.

Para	Vea
Escribir texto en el Portapapeles	Cómo: Escribir en el Portapapeles en Visual Basic

Ejemplo

Este ejemplo escribe la cadena This is a test string. en el Portapapeles.

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

Requisitos

Espacio de nombres:Microsoft.VisualBasic.MyServices

Clase:ClipboardProxy (proporciona acceso a Clipboard)

**Ensamblado:**Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación para Windows	Sí
Biblioteca de clases	Sí
Aplicación de consola	Sí
Biblioteca de controles de Windows	Sí
Biblioteca de controles Web	No
Servicio de Windows	Sí
Sitio Web	No