File.Decrypt(String) Méthode

Définition

Espace de noms:
System.IO
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Déchiffre un fichier chiffré par le compte actuel à l’aide de la Encrypt(String) méthode.

public:
 static void Decrypt(System::String ^ path);
public static void Decrypt(string path);
static member Decrypt : string -> unit
Public Shared Sub Decrypt (path As String)

Paramètres

path
String

Chemin d’accès qui décrit un fichier à déchiffrer.

Exceptions

ArgumentException

.NET Framework et les versions .NET Core antérieures à la version 2.1 : le paramètre path est une chaîne de longueur nulle, contient uniquement un espace blanc ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher des caractères non valides à l’aide de la méthode GetInvalidPathChars().

ArgumentNullException

Le path paramètre est null.

DriveNotFoundException

Un lecteur non valide a été spécifié.

FileNotFoundException

Impossible de trouver le fichier décrit par le path paramètre.

IOException

Une erreur d’E/S s’est produite lors de l’ouverture du fichier. Par exemple, le fichier chiffré est déjà ouvert.

-ou-

Cette opération n’est pas prise en charge sur la plateforme actuelle.

PathTooLongException

Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.

PlatformNotSupportedException

Le système d’exploitation actuel n’est pas Windows NT ou version ultérieure.

NotSupportedException

Le système de fichiers n’est pas NTFS.

UnauthorizedAccessException

Le path paramètre a spécifié un fichier en lecture seule.

-ou-

Cette opération n’est pas prise en charge sur la plateforme actuelle.

-ou-

Le path paramètre a spécifié un répertoire.

-ou-

L’appelant n’a pas l’autorisation requise.

Exemples

L’exemple de code suivant utilise la Encrypt méthode et la Decrypt méthode pour chiffrer, puis déchiffrer un fichier. Le fichier doit exister pour que l’exemple fonctionne.

using System;
using System.IO;
using System.Security.AccessControl;

namespace FileSystemExample
{
    class FileExample
    {
        public static void Main()
        {
            try
            {
                string FileName = "test.xml";

                Console.WriteLine("Encrypt " + FileName);

                // Encrypt the file.
                AddEncryption(FileName);

                Console.WriteLine("Decrypt " + FileName);

                // Decrypt the file.
                RemoveEncryption(FileName);

                Console.WriteLine("Done");
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
            }

            Console.ReadLine();
        }

        // Encrypt a file.
        public static void AddEncryption(string FileName)
        {

            File.Encrypt(FileName);
        }

        // Decrypt a file.
        public static void RemoveEncryption(string FileName)
        {
            File.Decrypt(FileName);
        }
    }
}

open System.IO

// Encrypt a file.
let addEncryption fileName = File.Encrypt fileName

// Decrypt a file.
let removeEncryption fileName = File.Decrypt fileName

let fileName = "test.xml"

printfn $"Encrypt {fileName}"

// Encrypt the file.
addEncryption fileName

printfn $"Decrypt {fileName}"

// Decrypt the file.
removeEncryption fileName

printfn "Done"

Imports System.IO
Imports System.Security.AccessControl



Module FileExample

    Sub Main()
        Try
            Dim FileName As String = "test.xml"

            Console.WriteLine("Encrypt " + FileName)

            ' Encrypt the file.
            AddEncryption(FileName)

            Console.WriteLine("Decrypt " + FileName)

            ' Decrypt the file.
            RemoveEncryption(FileName)

            Console.WriteLine("Done")
        Catch e As Exception
            Console.WriteLine(e)
        End Try

        Console.ReadLine()

    End Sub


    ' Encrypt a file.
    Sub AddEncryption(ByVal FileName As String)

        File.Encrypt(FileName)

    End Sub


    ' Decrypt the file.
    Sub RemoveEncryption(ByVal FileName As String)

        File.Decrypt(FileName)

    End Sub
End Module

Remarques

La Decrypt méthode vous permet de déchiffrer un fichier chiffré à l’aide de la Encrypt méthode. La Decrypt méthode peut déchiffrer uniquement les fichiers chiffrés à l’aide du compte d’utilisateur actuel.

Important

Cette API est uniquement prise en charge sur les plateformes Windows qui sont en mesure d’utiliser le système de fichiers de chiffrement NTFS (EFS). Toute tentative d’utilisation sur des systèmes non Windows, des systèmes Windows Home Edition ou des lecteurs non NTFS entraîne un PlatformNotSupportedException ou NotSupportedException, en fonction de la situation.

L’utilisation de cette API dans .NET Core n’est pas recommandée ; elle est incluse pour permettre la portabilité pour les applications qui passent à .NET Core, mais qui ciblent toujours explicitement Windows.

La Decrypt méthode nécessite un accès exclusif au fichier déchiffré et génère une exception si un autre processus utilise le fichier.

La Encrypt méthode et la Decrypt méthode utilisent le fournisseur de services de chiffrement (CSP) installé sur l’ordinateur et les clés de chiffrement de fichier du processus appelant la méthode.

Le système de fichiers actuel doit être mis en forme en NTFS et le système d’exploitation actuel doit être Windows NT ou version ultérieure.

S’applique à