FileInfo.IsReadOnly Propriedade

Definição

Espaço de Nomes:
System.IO
Assemblagens:
mscorlib.dll, System.IO.FileSystem.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagens:
netstandard.dll, System.IO.FileSystem.dll
Assemblagens:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
Assemblagem:
System.IO.FileSystem.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll
Origem:
FileInfo.cs
Origem:
FileInfo.cs
Origem:
FileInfo.cs
Origem:
FileInfo.cs
Origem:
FileInfo.cs

Recebe ou define um valor que determina se o ficheiro atual é apenas leitura.

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

Valor de Propriedade

Boolean

true se o ficheiro atual for apenas leitura ou não puder ser encontrado; caso contrário, false.

Exceções

FileNotFoundException

O ficheiro descrito pelo objeto atual FileInfo não foi encontrado ao tentar definir a propriedade IsReadOnly. (Note que obter esta propriedade para um ficheiro inexistente não lança uma exceção, mas sim retorna true.)

IOException

Ocorreu um erro de E/S durante a abertura do ficheiro.

UnauthorizedAccessException

Esta operação não é suportada na plataforma atual.

-ou-

O interlocutor não tem a permissão necessária.

ArgumentException

O utilizador não tem permissão de escrita, mas tentou definir esta propriedade como false.

Exemplos

O exemplo seguinte cria um ficheiro temporário, usa a IsReadOnly propriedade para primeiro verificar e depois definir o seu estado de apenas leitura, e finalmente marca-o como leitura-escrita para o eliminar.

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.
'

Observações

Use a IsReadOnly propriedade para determinar rapidamente ou alterar se o ficheiro atual é apenas leitura.

Se o ficheiro atual não existir, obter esta propriedade devolverá sempre true, mas tentar definir lançará um FileNotFoundException.

Quando é chamado pela primeira vez, FileInfo chama Refresh e armazena em cache informações sobre o ficheiro. Nas chamadas seguintes, deve ligar Refresh para obter a cópia mais recente da informação.

Aplica-se a