FileInfo.IsReadOnly Właściwość

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Źródło:

FileInfo.cs

Pobiera lub ustawia wartość określającą, czy bieżący plik jest tylko do odczytu.

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

public bool IsReadOnly { get; set; }

member this.IsReadOnly : bool with get, set

Public Property IsReadOnly As Boolean

Wartość właściwości

Boolean

true jeśli bieżący plik jest tylko do odczytu lub nie można go odnaleźć; w przeciwnym razie , false.

Wyjątki

FileNotFoundException

Nie można odnaleźć pliku opisanego przez bieżący FileInfo obiekt podczas próby ustawienia właściwości IsReadOnly. (Należy pamiętać, że pobranie tej właściwości dla nieistniejący plik nie będzie zgłaszać wyjątku, ale raczej zwraca wartość true.)

IOException

Podczas otwierania pliku wystąpił błąd We/Wy.

UnauthorizedAccessException

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

-lub-

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

ArgumentException

Użytkownik nie ma uprawnień do zapisu, ale próbował ustawić tę właściwość na false.

Przykłady

Poniższy przykład tworzy plik tymczasowy, używa IsReadOnly właściwości , aby najpierw sprawdzić, a następnie ustawić jego stan tylko do odczytu i na koniec oznaczyć go jako odczyt-zapis w celu usunięcia go.

using namespace System;
using namespace System::IO;

int main()
{
    // Create a temporary file.
    String^ filePath = Path::GetTempFileName();
    Console::WriteLine("Created a temp file at '{0}.", filePath);

    // Create a new FileInfo object.
    FileInfo^ fInfo = gcnew FileInfo(filePath);
    
    // Get the read-only value for a file.
    bool isReadOnly = fInfo->IsReadOnly;

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

    // Set the file to read-only.
    Console::WriteLine("Setting the read-only value for '{0}' to true.", fInfo->Name);
    fInfo->IsReadOnly = true;

    // Get the read-only value for a file.
    isReadOnly = fInfo->IsReadOnly;

    // Display that the file is now read-only.
    Console::WriteLine("The file read-only value for '{0}' is {1}.", fInfo->Name, isReadOnly);

    // Make the file mutable again so it can be deleted.
    fInfo->IsReadOnly = false;

    // Delete the temporary file.
    fInfo->Delete();

    return 0;
};

// This code produces output similar to the following,
// though results may vary based on the computer, file structure, etc.:
//
// Created a temp file at 'C:\Users\UserName\AppData\Local\Temp\tmpB438.tmp'.
// The file read-only value for 'tmpB438.tmp' is False.
// Setting the read-only value for 'tmpB438.tmp' to true.
// The file read-only value for 'tmpB438.tmp' is True.
//

using System;
using System.IO;

public class FileExample
{
    public static void Main()
    {
        // Create a temporary file.
        string filePath = Path.GetTempFileName();
        Console.WriteLine($"Created a temp file at '{filePath}'.");

        // Create a new FileInfo object.
        FileInfo fInfo = new FileInfo(filePath);

        // Get the read-only value for a file.
        bool isReadOnly = fInfo.IsReadOnly;

        // Display whether the file is read-only.
        Console.WriteLine($"The file read-only value for '{fInfo.Name}' is {isReadOnly}.");

        // Set the file to read-only.        
        Console.WriteLine($"Setting the read-only value for '{fInfo.Name}' to true.");
        fInfo.IsReadOnly = true;

        // Get the read-only value for a file.
        isReadOnly = fInfo.IsReadOnly;

        // Display that the file is now read-only.
        Console.WriteLine($"The file read-only value for '{fInfo.Name}' is {isReadOnly}.");

        // Make the file mutable again so it can be deleted.
        fInfo.IsReadOnly = false;

        // Delete the temporary file.
        fInfo.Delete();
    }
}

// This code produces output similar to the following,
// though results may vary based on the computer, file structure, etc.:
//
// Created a temp file at 'C:\Users\UserName\AppData\Local\Temp\tmpB438.tmp'.
// The file read-only value for 'tmpB438.tmp' is False.
// Setting the read-only value for 'tmpB438.tmp' to true.
// The file read-only value for 'tmpB438.tmp' is True.
//

Imports System.IO

Module FileExample

    Sub Main()

        ' Create a temporary file.
        Dim filePath As String = Path.GetTempFileName()
        Console.WriteLine($"Created a temp file at '{filePath}'.")

        ' Create a new FileInfo object.
        Dim fInfo As New FileInfo(filePath)

        ' Get the read-only value for a file.
        Dim isReadOnly As Boolean = fInfo.IsReadOnly

        ' Display whether the file is read-only.
        Console.WriteLine($"The file read-only value for '{fInfo.Name}' is {isReadOnly}.")

        ' Set the file to read-only.
        Console.WriteLine($"Setting the read-only value for '{fInfo.Name}' to true.")
        fInfo.IsReadOnly = True

        ' Get the read-only value for a file.
        isReadOnly = fInfo.IsReadOnly

        ' Display that the file is now read-only.
        Console.WriteLine($"The file read-only value for '{fInfo.Name}' is {isReadOnly}.")

        ' Make the file mutable again so it can be deleted.
        fInfo.IsReadOnly = False

        ' Delete the temporary file.
        fInfo.Delete()
    End Sub

End Module

' This code produces output similar to the following,
' though results may vary based on the computer, file structure, etc.:
'
' Created a temp file at 'C:\Users\UserName\AppData\Local\Temp\tmpB438.tmp'.
' The file read-only value for 'tmpB438.tmp' is False.
' Setting the read-only value for 'tmpB438.tmp' to true.
' The file read-only value for 'tmpB438.tmp' is True.
'

Uwagi

IsReadOnly Użyj właściwości , aby szybko określić lub zmienić, czy bieżący plik jest tylko do odczytu.

Jeśli bieżący plik nie istnieje, pobranie tej właściwości będzie zawsze zwracać truewartość , ale próby ustawienia spowodują zwrócenie wartości FileNotFoundException.

Po pierwszym wywołaniu FileInfo wywołuje Refresh i buforuje informacje o pliku. W kolejnych wywołaniach należy wywołać polecenie Refresh , aby uzyskać najnowszą kopię informacji.