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

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.

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

Permisos

No se requiere ningún permiso.

Vea también

Referencia

My.Computer.Clipboard (Objeto)

System.Windows.Forms.TextDataFormat

Clipboard.SetText

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

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

Otros recursos

Almacenar y leer datos en el Portapapeles