File.Encrypt(String) Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.IO.FileSystem.dll

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Crittografa un file in modo che possa essere decrittografato solamente dall'account che lo ha crittografato.

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

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

public static void Encrypt (string path);

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

static member Encrypt : string -> unit

Public Shared Sub Encrypt (path As String)

Parametri

path

String

Percorso che descrive il file da crittografare.

Attributi

SupportedOSPlatformAttribute

Eccezioni

ArgumentException

.NET Framework versioni di .NET Core precedenti alla 2.1: il parametro è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri path non validi. È possibile cercare i caratteri non validi usando il metodo GetInvalidPathChars().

ArgumentNullException

Il valore del parametro path è null.

DriveNotFoundException

È stata specificata un'unità non valida.

FileNotFoundException

Il file descritto dal parametro path non è stato trovato.

IOException

Si è verificato un errore di I/O durante l'apertura del file.

-oppure-

L'operazione non è supportata sulla piattaforma corrente.

PathTooLongException

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

PlatformNotSupportedException

Il sistema operativo corrente non è Windows NT o versioni successive.

NotSupportedException

Il file system non è NTFS.

UnauthorizedAccessException

Il parametro path specifica un file di sola lettura.

-oppure- L'operazione non è supportata sulla piattaforma corrente.

-oppure- Il parametro path specifica una directory.

-oppure- Il chiamante non dispone dell'autorizzazione richiesta.

Esempio

Nell'esempio di codice seguente vengono Encrypt utilizzati il metodo e il metodo per Decrypt crittografare e quindi decrittografare un file. Il file deve esistere per il funzionamento dell'esempio.

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);
        }
    }
}

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

Commenti

Il Encrypt metodo consente di crittografare un file in modo che solo l'account usato per chiamare questo metodo possa decrittografarlo. Usare il Decrypt metodo per decrittografare un file crittografato dal Encrypt metodo .

Importante

Questa API è supportata solo in Windows che sono in grado di usare ntfs Encrypting File System (EFS). Qualsiasi tentativo di usarlo in sistemi non Windows, sistemi Windows Home Edition o unità non NTFS comporta un o , a seconda PlatformNotSupportedException NotSupportedException della situazione.

L'uso di questa API in .NET Core non è consigliato. è incluso per abilitare la portabilità per le applicazioni che passano a .NET Core, ma che sono ancora in modo esplicito come destinazione Windows.

Il metodo richiede l'accesso esclusivo al file crittografato e avrà esito negativo se un Encrypt altro processo usa il file.

Sia il metodo che il metodo usano il provider del servizio di crittografia Encrypt (CSP) installato nel computer e le chiavi di crittografia file del processo Decrypt che chiama il metodo .

Questo metodo non è disponibile in tutte le versioni di Windows. Ad esempio, non è disponibile nelle edizioni Home.

L'file system deve essere formattata come NTFS.