File.Decrypt(String) Methode

Definition

Namespace:
System.IO
Assemblys:
netstandard.dll, System.Runtime.dll
Assemblys:
netstandard.dll, System.IO.FileSystem.dll
Assemblys:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs

Entschlüsselt eine Datei, die mit der Encrypt(String) Methode vom aktuellen Konto verschlüsselt wurde.

public:
 static void Decrypt(System::String ^ path);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void Decrypt(string path);
public static void Decrypt(string path);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Decrypt : string -> unit
static member Decrypt : string -> unit
Public Shared Sub Decrypt (path As String)

Parameter

path
String

Ein Pfad, der eine zu entschlüsselnde Datei beschreibt.

Attribute
SupportedOSPlatformAttribute

Ausnahmen

ArgumentException

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: Der Parameter path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen. Sie können ungültige Zeichen mithilfe der GetInvalidPathChars() Methode abfragen.

ArgumentNullException

Der path Parameter ist null.

DriveNotFoundException

Es wurde ein ungültiges Laufwerk angegeben.

FileNotFoundException

Die vom path Parameter beschriebene Datei wurde nicht gefunden.

IOException

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten. Beispielsweise ist die verschlüsselte Datei bereits geöffnet.

-oder-

Dieser Vorgang wird auf der aktuellen Plattform nicht unterstützt.

PathTooLongException

Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.

PlatformNotSupportedException

Das aktuelle Betriebssystem ist nicht Windows NT oder höher.

NotSupportedException

Das Dateisystem ist nicht NTFS.

UnauthorizedAccessException

Der path Parameter hat eine Datei angegeben, die schreibgeschützt ist.

-oder-

Dieser Vorgang wird auf der aktuellen Plattform nicht unterstützt.

-oder-

Der path Parameter hat ein Verzeichnis angegeben.

-oder-

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Beispiele

Im folgenden Codebeispiel werden die Encrypt Methode und die Decrypt Methode zum Verschlüsseln und Entschlüsseln einer Datei verwendet. Die Datei muss vorhanden sein, damit das Beispiel funktioniert.

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

Hinweise

Mit der Decrypt Methode können Sie eine Datei entschlüsseln, die mit der Encrypt Methode verschlüsselt wurde. Die Decrypt Methode kann nur Dateien entschlüsseln, die mit dem aktuellen Benutzerkonto verschlüsselt wurden.

Important

Diese API wird nur auf Windows Plattformen unterstützt, die das NTFS Encrypting File System (EFS) verwenden können. Jeder Versuch, dies auf nicht Windows Systemen, Windows Home Edition-Systemen oder nicht-NTFS-Laufwerken zu verwenden, führt je nach Situation zu einem PlatformNotSupportedException oder NotSupportedException.

Die Verwendung dieser API in .NET Core wird nicht empfohlen. Es wird eingeschlossen, um die Portabilität für Anwendungen zu aktivieren, die zu .NET Core wechseln, aber dennoch explizit auf Windows abzielen.

Die Decrypt Methode erfordert exklusiven Zugriff auf die zu entschlüsselnde Datei und löst eine Ausnahme aus, wenn ein anderer Prozess die Datei verwendet.

Sowohl die Encrypt Methode als auch die Decrypt Methode verwenden den auf dem Computer installierten kryptografischen Dienstanbieter (CSP) und die Dateiverschlüsselungsschlüssel des Prozesses, der die Methode aufruft.

Das aktuelle Dateisystem muss als NTFS formatiert sein, und das aktuelle Betriebssystem muss Windows NT oder höher sein.

Gilt für: