Comment : insérer du texte dans les fichiers du répertoire Mes Documents dans Visual Basic

Article
08/21/2008

Mise à jour : novembre 2007

L'objet My.Computer.FileSystem.SpecialDirectories vous permet d'accéder aux répertoires spéciaux, tels que le répertoire Mes documents.

Procédure

Pour écrire de nouveaux fichiers texte dans le répertoire Mes documents

Utilisez la propriété My.Computer.FileSystem.SpecialDirectories.MyDocuments pour fournir le chemin d'accès.

Dim filePath As String
filePath = System.IO.Path.Combine( _
My.Computer.FileSystem.SpecialDirectories.MyDocuments, "test.txt")

Utilisez la méthode WriteAllText pour écrire du texte dans le fichier spécifié.
```
My.Computer.FileSystem.WriteAllText(filePath, "some text", True)
```

Exemple

Try
    Dim filePath As String
    filePath = System.IO.Path.Combine( _
               My.Computer.FileSystem.SpecialDirectories.MyDocuments, "test.txt")
            My.Computer.FileSystem.WriteAllText(filePath, "some text", False)
Catch fileException As Exception
    Throw fileException
End Try

Compilation du code

Remplacez test.txt par le nom du fichier dans lequel vous souhaitez écrire.

Programmation fiable

Ce code lève de nouveau toutes les exceptions qui peuvent se produire lorsque vous écrivez du texte dans le fichier. Vous pouvez réduire la probabilité d'exceptions en utilisant les contrôles Windows Forms, tels que les composants OpenFileDialog et SaveFileDialog qui limitent les choix de l'utilisateur aux noms de fichiers valides. Toutefois, l'utilisation de ces contrôles n'est pas sans poser de problèmes. Le système de fichiers peut changer entre le moment où l'utilisateur sélectionne un fichier et le moment où le code s'exécute. La gestion des exceptions est donc presque toujours nécessaire lors de l'utilisation de fichiers.

Sécurité

Si vous exécutez le programme dans un contexte partiellement fiable, le code peut lever une exception en raison de privilèges insuffisants. Pour plus d'informations, consultez Notions fondamentales de la sécurité d'accès du code.

Cet exemple crée un fichier. Si une application doit créer un fichier, elle doit disposer de l'autorisation Créer pour le dossier. Les autorisations sont définies à l'aide de listes de contrôle d'accès. Si le fichier existe déjà, l'application a uniquement besoin de l'autorisation Écrire, ce qui représente un privilège inférieur. Lorsque cela est possible, il est plus sûr de créer le fichier au cours du déploiement et de n'accorder les privilèges Lire que sur un seul fichier (plutôt que les privilèges Créer sur un dossier). En outre, il est plus sûr d'écrire les données dans des dossiers utilisateur que dans le dossier racine ou le dossier Program Files. Pour plus d'informations, consultez Listes de contrôle d'accès.