File.Encrypt メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

File.Encrypt メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ファイルを暗号化し、そのファイルの暗号化に使用したアカウントだけが復号化できるようにします。

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub Encrypt
 ( _
    path As String _
)

Visual Basic (使用法)

Dim path As String

File.Encrypt(path)

public static void Encrypt
 (
    string path
)

C++

public:
static void Encrypt (
    String^ path
)

public static void Encrypt
 (
    String path
)

JScript

public static function Encrypt
 (
    path : String
)

パラメータ

path: 暗号化するファイルを示すパス。

例外

例外の種類	条件
ArgumentException	path パラメータが、長さ 0 の文字列であるか、空白しか含んでいません。または、InvalidPathChars によって定義された無効な文字を 1 文字以上含んでいます。
ArgumentNullException	path パラメータが null 参照 (Visual Basic では Nothing) です。
DriveNotFoundException	無効なドライブが指定されました。
FileNotFoundException	path パラメータによって示されたファイルが見つかりませんでした。
IOException	ファイルを開くときに、I/O エラーが発生しました。
PathTooLongException	指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。
PlatformNotSupportedException	現在のオペレーティングシステムは Microsoft Windows NT 以降ではありません。
NotSupportedException	ファイルシステムが NTFS ではありません。
UnauthorizedAccessException	path パラメータに読み取り専用のファイルが指定されました。またはこの操作は、現在のプラットフォームではサポートされていません。または path パラメータによって、ディレクトリが指定されました。または呼び出し元に、必要なアクセス許可がありません。

解説

Encrypt メソッドは、ファイルを暗号化し、このメソッドの呼び出しに使用したアカウントだけがそのファイルを復号化できるようにします。Encrypt メソッドによって暗号化されたファイルを復号化するには、Decrypt メソッドを使用します。

Encrypt メソッドでは、暗号化するファイルへの排他アクセスを必要とするため、別のプロセスがそのファイルを使用している場合、このメソッドは失敗します。

Encrypt メソッドと Decrypt メソッドは共に、コンピュータにインストールされた暗号化サービスプロバイダ (CSP: Cryptographic Service Provider) と、メソッドを呼び出すプロセスのファイル暗号化キーを使用します。

現在のファイルシステムは NTFS としてフォーマットされている必要があり、現在のオペレーティングシステムは、Microsoft Windows NT 以降であることが必要です。

使用例

Encrypt メソッドと Decrypt メソッドを使用して、ファイルを暗号化し、復号化するコード例を次に示します。

Visual Basic

Imports System
Imports System.IO
Imports System.Security.AccessControl



Module FileExample

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

            Console.WriteLine("Enceypt " + 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

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

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

                Console.WriteLine("Enceypt " + 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);
        }
    }
}

C++

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