File.Decrypt(String) Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Źródło:

File.cs

Odszyfrowuje plik zaszyfrowany przez bieżące konto przy użyciu Encrypt(String) metody .

public:
 static void Decrypt(System::String ^ path);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void Decrypt (string path);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Decrypt : string -> unit

Public Shared Sub Decrypt (path As String)

Parametry

path

String

Ścieżka opisując plik do odszyfrowywania.

Atrybuty

SupportedOSPlatformAttribute

Wyjątki

ArgumentException

.NET Framework i .NET Core w wersjach starszych niż 2.1: path Parametr jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera co najmniej jeden nieprawidłowy znak. Możesz wykonać zapytanie o nieprawidłowe znaki przy użyciu GetInvalidPathChars() metody .

ArgumentNullException

Parametr path to null.

DriveNotFoundException

Określono nieprawidłowy dysk.

FileNotFoundException

Nie można odnaleźć pliku opisanego path przez parametr .

IOException

Podczas otwierania pliku wystąpił błąd We/Wy. Na przykład zaszyfrowany plik jest już otwarty.

-lub-

Ta operacja nie jest obsługiwana na bieżącej platformie.

PathTooLongException

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

PlatformNotSupportedException

Bieżący system operacyjny nie jest windows NT lub nowszy.

NotSupportedException

System plików nie jest ntfs.

UnauthorizedAccessException

Parametr path określił plik, który jest tylko do odczytu.

-lub-

Ta operacja nie jest obsługiwana na bieżącej platformie.

-lub-

Parametr path określił katalog.

-lub-

Obiekt wywołujący nie posiada wymaganych uprawnień.

Przykłady

Poniższy przykład kodu używa Encrypt metody i Decrypt metody do szyfrowania, a następnie odszyfrowywania pliku. Plik musi istnieć, aby przykład działał.

using namespace System;
using namespace System::IO;

int main()
{
    String^ fileName = "test.xml";
    if (!File::Exists(fileName))
    {
        Console::WriteLine("The file " + fileName
            + " does not exist.");
        return 0;
    }
    try
    {
        Console::WriteLine("Encrypt " + fileName);

        // Encrypt the file.
        File::Encrypt(fileName);

        Console::WriteLine("Decrypt " + fileName);

        // Decrypt the file.
        File::Decrypt(fileName);

        Console::WriteLine("Done");
    }
    catch (IOException^ ex)
    {
        Console::WriteLine("There was an IO problem.");
        Console::WriteLine(ex->Message);
    }
    catch (PlatformNotSupportedException^)
    {
        Console::WriteLine("Encryption is not supported on " +
            "this system.");
    }
    catch (NotSupportedException^)
    {
        Console::WriteLine("Encryption is not supported on " +
            "this system.");
    }
    catch (UnauthorizedAccessException^)
    {
        Console::WriteLine("The operation could not be "
            + "carried out.");
    }
}

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

Uwagi

Metoda Decrypt umożliwia odszyfrowywanie pliku zaszyfrowanego przy użyciu Encrypt metody . Metoda Decrypt może odszyfrować tylko pliki zaszyfrowane przy użyciu bieżącego konta użytkownika.

Ważne

Ten interfejs API jest obsługiwany tylko na platformach systemu Windows, które mogą używać systemu plików NTFS Szyfrujące pliki (EFS). Każda próba użycia tej metody w systemach innych niż Windows, systemach Windows Home Edition lub dyskach innych niż NTFS powoduje wystąpienie elementu PlatformNotSupportedException lub NotSupportedException, w zależności od sytuacji.

Korzystanie z tego interfejsu API na platformie .NET Core nie jest zalecane; Jest on dołączony do włączania przenośności dla aplikacji, które przechodzą do platformy .NET Core, ale nadal jawnie przeznaczone dla systemu Windows.

Metoda Decrypt wymaga wyłącznego dostępu do odszyfrowanego pliku i zgłosi wyjątek, jeśli inny proces używa pliku. Jeśli plik nie jest zaszyfrowany, Decrypt zwróci wartość niezerową, co oznacza powodzenie.

Encrypt Zarówno metoda, jak i Decrypt metoda używają dostawcy usług kryptograficznych (CSP) zainstalowanego na komputerze i kluczy szyfrowania plików procesu wywołującego metodę.

Bieżący system plików musi być sformatowany jako NTFS, a bieżący system operacyjny musi być windows NT lub nowszy.