File.Encrypt(String) Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

File.cs

Yalnızca dosyayı şifrelemek için kullanılan hesabın şifresini çözebilmesi için bir dosyayı şifreler.

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

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

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

Public Shared Sub Encrypt (path As String)

Parametreler

path

String

Şifrelenmesi gereken bir dosyayı açıklayan yol.

Öznitelikler

SupportedOSPlatformAttribute

Özel durumlar

ArgumentException

2.1'den eski .NET Framework ve .NET Core sürümleri: path parametresi sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya bir veya daha fazla geçersiz karakter içerir. GetInvalidPathChars() yöntemini kullanarak geçersiz karakterleri sorgulayabilirsiniz.

ArgumentNullException

path parametresi null'dir.

DriveNotFoundException

Geçersiz bir sürücü belirtildi.

FileNotFoundException

parametresi tarafından path açıklanan dosya bulunamadı.

IOException

Dosya açılırken bir G/Ç hatası oluştu.

-veya-

Bu işlem geçerli platformda desteklenmiyor.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor.

PlatformNotSupportedException

Geçerli işletim sistemi Windows NT veya üzeri değil.

NotSupportedException

Dosya sistemi NTFS değil.

UnauthorizedAccessException

path parametresi salt okunur bir dosya belirtti.

-veya-

Bu işlem geçerli platformda desteklenmiyor.

-veya-

path parametresi bir dizin belirtti.

-veya-

Çağıranın gerekli izni yok.

Örnekler

Aşağıdaki kod örneği, bir dosyayı şifrelemek ve Encrypt şifresini çözmek için yöntemini ve yöntemini kullanırDecrypt. Örneğin çalışması için dosyanın mevcut olması gerekir.

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

Açıklamalar

Encrypt yöntemi, yalnızca bu yöntemi çağırmak için kullanılan hesabın şifresini çözebilmesi için bir dosyayı şifrelemenize olanak tanır. yöntemiyle DecryptEncrypt şifrelenmiş bir dosyanın şifresini çözmek için yöntemini kullanın.

Important

Bu API yalnızca NTFS Şifreleme Dosya Sistemi'ni (EFS) kullanabilen Windows platformlarda desteklenir. Bunu Windows olmayan sistemlerde, home edition Windows veya NTFS olmayan sürücülerde kullanmaya yönelik tüm girişimler, duruma bağlı olarak PlatformNotSupportedException veya NotSupportedException ile sonuçlanabilecektir.

Bu API'nin .NET Core'da kullanılması önerilmez; .NET Core'a taşınan ancak yine de açıkça Windows hedefleyen uygulamalar için taşınabilirliği etkinleştirmek üzere eklenmiştir.

yöntemi şifrelenen Encrypt dosyaya özel erişim gerektirir ve dosyayı başka bir işlem kullanıyorsa başarısız olur.

Encrypt Hem yöntemi hem Decrypt de yöntemi, bilgisayarda yüklü şifreleme hizmeti sağlayıcısını (CSP) ve yöntemi çağıran işlemin dosya şifreleme anahtarlarını kullanır.

Bu yöntem, Windows'nin tüm sürümlerinde kullanılamaz. Örneğin, Home sürümlerinde kullanılamaz.

Geçerli dosya sistemi NTFS olarak biçimlendirilmelidir.