My.Computer.Clipboard.SetText, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Écrit du texte dans le Presse-papiers.

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

Paramètres

text
String. Texte à écrire. Requis.
format
TextDataFormat. Format à utiliser lors de l'écriture du texte. La valeur par défaut est UnicodeText. Requis.

Exceptions

Les conditions ci-dessous peuvent générer une exception :

text est une chaîne vide (ArgumentException).
text a la valeur Nothing (ArgumentNullException).

Notes

Les formats possibles sont CommaSeparatedValue, Html, Rtf et UnicodeText.

La méthode nécessite AllClipboard.

Les formats de Presse-papiers antérieurs ne sont pas conservés.

Note de sécurité :
Étant donné que d'autres utilisateurs peuvent accéder au Presse-papiers, ne l'utilisez pas pour stocker des informations sensibles, telles que des mots de passe ou des données confidentielles.

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant la méthode My.Computer.Clipboard.SetText.

Pour	Consultez
Écrire du texte dans le Presse-papiers	Comment : écrire dans le Presse-papiers en Visual Basic

Exemple

Cet exemple écrit la chaîne This is a test string. dans le Presse-papiers.

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

Configuration requise

Espace de noms :Microsoft.VisualBasic.MyServices

Classe :ClipboardProxy (fournit l'accès à Clipboard)

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Oui
Application console	Oui
Bibliothèque de contrôles Windows	Oui
Bibliothèque de contrôles Web	Non
Service Windows	Oui
Site Web	Non