FileInfo.IsReadOnly プロパティ

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

FileInfo.IsReadOnly プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在のファイルが読み取り専用であるかどうかを判断する値を取得または設定します。

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

Visual Basic (宣言)

Public Property IsReadOnly As
 Boolean

Visual Basic (使用法)

Dim instance As FileInfo
Dim value As Boolean

value = instance.IsReadOnly

instance.IsReadOnly = value

C#

public bool IsReadOnly { get;
 set; }

C++

public:
property bool IsReadOnly {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_IsReadOnly ()

/** @property */
public void set_IsReadOnly (boolean value)

JScript

public function get IsReadOnly
 () : boolean

public function set IsReadOnly
 (value : boolean)

プロパティ値
現在のファイルが読み取り専用の場合は true。それ以外の場合は false。

例外

例外の種類	条件
FileNotFoundException	現在の FileInfo オブジェクトが示すファイルが見つかりませんでした。
IOException	ファイルを開くときに、I/O エラーが発生しました。
UnauthorizedAccessException	現在の FileInfo オブジェクトが示すファイルが読み取り専用です。 または この操作は、現在のプラットフォームではサポートされていません。 または 呼び出し元に、必要なアクセス許可がありません。

解説

現在のファイルが読み取り専用であるかどうかをすばやく判断または変更するには、IsReadOnly プロパティを使用します。

使用例

次の例では、IsReadOnly プロパティを使用して、ファイルを読み取り専用としてマークし、次に読み書き可能ファイルとしてマークします。

Visual Basic

Imports System
Imports System.IO



Module FileExample

    Sub Main()

        Dim FileName As String
 = "test.xml"

        ' Get the read-only value for a file.
        Dim isReadOnly As Boolean
 = IsFileReadOnly(FileName)

        ' Display wether the file is read-only.
        Console.WriteLine("The file read-only value for "
 & FileName & " is: " & isReadOnly)

        Console.WriteLine("Changing the read-only value for "
 & FileName & " to true.")

        ' Set the file to read-only.
        SetFileReadAccess(FileName, True)

        ' Get the read-only value for a file.
        isReadOnly = IsFileReadOnly(FileName)

        ' Display that the file is read-only.
        Console.WriteLine("The file read-only value for "
 & FileName & " is: " & isReadOnly)

    End Sub


    ' Sets the read-only value of a file.
    Sub SetFileReadAccess(ByVal FileName As
 String, ByVal SetReadOnly As
 Boolean)
        ' Create a new FileInfo object.
        Dim fInfo As New
 FileInfo(FileName)

        ' Set the IsReadOnly property.
        fInfo.IsReadOnly = SetReadOnly

    End Sub


    ' Returns wether a file is read-only.
    Function IsFileReadOnly(ByVal FileName
 As String) As Boolean
        ' Create a new FileInfo object.
        Dim fInfo As New
 FileInfo(FileName)

        ' Return the IsReadOnly property value.
        Return fInfo.IsReadOnly

    End Function
End Module

C#

using System;
using System.IO;

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

            // Get the read-only value for a file.
            bool isReadOnly = IsFileReadOnly(FileName);

            // Display wether the file is read-only.
            Console.WriteLine("The file read-only value for
 " + FileName + " is: " + isReadOnly);

            Console.WriteLine("Changing the read-only value for
 " + FileName + " to true.");

            // Set the file to read-only.
            SetFileReadAccess(FileName, true);

            // Get the read-only value for a file.
            isReadOnly = IsFileReadOnly(FileName);

            // Display that the file is read-only.
            Console.WriteLine("The file read-only value for
 " + FileName + " is: " + isReadOnly);

            Console.ReadLine();

        }

        // Sets the read-only value of a file.
        public static void
 SetFileReadAccess(string FileName, bool SetReadOnly)
        {
            // Create a new FileInfo object.
            FileInfo fInfo = new FileInfo(FileName);

            // Set the IsReadOnly property.
            fInfo.IsReadOnly = SetReadOnly;

        }

        // Returns wether a file is read-only.
        public static bool
 IsFileReadOnly(string FileName)
        {
            // Create a new FileInfo object.
            FileInfo fInfo = new FileInfo(FileName);

            // Return the IsReadOnly property value.
            return fInfo.IsReadOnly;

        }

    }
}

C++

using namespace System;
using namespace System::IO;

namespace FileSystemExample
{
    // Sets the read-only value of a file.
    void SetFileReadAccess(String^ fileName, bool
 setReadOnly)
    {
        // Create a new FileInfo object.
        FileInfo^ fInfo = gcnew FileInfo(fileName);

        // Set the IsReadOnly property.
        fInfo->IsReadOnly = setReadOnly;
    }

    // Returns whether a file is read-only.
    bool IsFileReadOnly(String^ fileName)
    {
        // Create a new FileInfo object.
        FileInfo^ fInfo = gcnew FileInfo(fileName);

        // Return the IsReadOnly property value.
        return fInfo->IsReadOnly;
    }
}

int main()
{
    try
    {
        String^ fileName = "test.xml";

        if (File::Exists(fileName))
        {
            // Get the read-only value for a file.
            bool isReadOnly = FileSystemExample::IsFileReadOnly(fileName);

            // Display whether the file is read-only.
            Console::WriteLine("The file read-only value for
 {0} is:" +
                "{1}", fileName, isReadOnly);

            Console::WriteLine("Changing the read-only value for
 {0}" +
                " to true.", fileName);

            // Set the file to read-only.
            FileSystemExample::SetFileReadAccess(fileName, true);

            // Get the read-only value for a file.
            isReadOnly = FileSystemExample::IsFileReadOnly(fileName);

            // Display that the file is read-only.
            Console::WriteLine("The file read-only value for
 {0} is:" +
                "{1}", fileName, isReadOnly);
        }
        else
        {
            Console::WriteLine("The file {0} doesn't exist.", fileName);
        }
    }
    catch (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    }
};

.NET Framework のセキュリティ

• FileIOPermission  関連する列挙体 : Read、Write Demand (セキュリティ アクション)。 (現在の FileInfo オブジェクトが示すファイルの読み取りと書き込みを行うために必要なアクセス許可)。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
FileInfo クラス
FileInfo メンバ
System.IO 名前空間