File.SetAttributes Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Przeciążenia

SetAttributes(SafeFileHandle, FileAttributes)	Ustawia określony FileAttributes plik lub katalog skojarzony z fileHandleprogramem .
SetAttributes(String, FileAttributes)	Ustawia określony FileAttributes plik w określonej ścieżce.

SetAttributes(SafeFileHandle, FileAttributes)

Źródło:

File.cs

Ustawia określony FileAttributes plik lub katalog skojarzony z fileHandleprogramem .

public:
 static void SetAttributes(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, System::IO::FileAttributes fileAttributes);

public static void SetAttributes (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, System.IO.FileAttributes fileAttributes);

static member SetAttributes : Microsoft.Win32.SafeHandles.SafeFileHandle * System.IO.FileAttributes -> unit

Public Shared Sub SetAttributes (fileHandle As SafeFileHandle, fileAttributes As FileAttributes)

Parametry

fileHandle

SafeFileHandle

A SafeFileHandle do pliku lub katalogu, dla którego fileAttributes należy ustawić.

fileAttributes

FileAttributes

Bitowe połączenie wartości wyliczenia.

Wyjątki

ArgumentNullException

fileHandle to null.

UnauthorizedAccessException

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

Uwagi

Nie można zmienić stanu File kompresji obiektu przy użyciu SetAttributes(SafeFileHandle, FileAttributes) metody .

SetAttributes(String, FileAttributes)

Źródło:

File.cs

Ustawia określony FileAttributes plik w określonej ścieżce.

public:
 static void SetAttributes(System::String ^ path, System::IO::FileAttributes fileAttributes);

public static void SetAttributes (string path, System.IO.FileAttributes fileAttributes);

static member SetAttributes : string * System.IO.FileAttributes -> unit

Public Shared Sub SetAttributes (path As String, fileAttributes As FileAttributes)

Parametry

path

String

Ścieżka do pliku.

fileAttributes

FileAttributes

Bitowe połączenie wartości wyliczenia.

Wyjątki

ArgumentException

.NET Framework i .NET Core w wersji starszej niż 2.1: path jest pusta, zawiera tylko białe spacje, zawiera nieprawidłowe znaki lub atrybut pliku jest nieprawidłowy.

PathTooLongException

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

NotSupportedException

path jest w nieprawidłowym formacie.

DirectoryNotFoundException

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niemapowanym dysku).

FileNotFoundException

Nie można odnaleźć pliku.

UnauthorizedAccessException

path określono plik, który jest tylko do odczytu.

-lub-

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

-lub-

path określony katalog.

-lub-

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

Przykłady

W poniższym przykładzie przedstawiono GetAttributes metody i SetAttributes , stosując Archive atrybuty i Hidden do pliku.

using namespace System;
using namespace System::IO;
using namespace System::Text;
int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file if it does not exist.
   if (  !File::Exists( path ) )
   {
      File::Create( path );
   }

   if ( (File::GetAttributes( path ) & FileAttributes::Hidden) == FileAttributes::Hidden )
   {
      
      // Show the file.
      File::SetAttributes(path, File::GetAttributes( path ) & ~FileAttributes::Hidden);
      Console::WriteLine( "The {0} file is no longer hidden.", path );
   }
   else
   {
      
      // Hide the file.
      File::SetAttributes( path, static_cast<FileAttributes>(File::GetAttributes( path ) | FileAttributes::Hidden) );
      Console::WriteLine( "The {0} file is now hidden.", path );
   }
}

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // Create the file if it does not exist.
        if (!File.Exists(path))
        {
            File.Create(path);
        }

        FileAttributes attributes = File.GetAttributes(path);

        if ((attributes & FileAttributes.Hidden) == FileAttributes.Hidden)
        {
            // Show the file.
            attributes = RemoveAttribute(attributes, FileAttributes.Hidden);
            File.SetAttributes(path, attributes);
            Console.WriteLine("The {0} file is no longer hidden.", path);
        }
        else
        {
            // Hide the file.
            File.SetAttributes(path, File.GetAttributes(path) | FileAttributes.Hidden);
            Console.WriteLine("The {0} file is now hidden.", path);
        }
    }

    private static FileAttributes RemoveAttribute(FileAttributes attributes, FileAttributes attributesToRemove)
    {
        return attributes & ~attributesToRemove;
    }
}

open System.IO
open System.Text

let removeAttribute attributes attributesToRemove = attributes &&& ~~~attributesToRemove

let path = @"c:\temp\MyTest.txt"

// Create the file if it does not exist.
if File.Exists path |> not then
    File.Create path |> ignore

let attributes = File.GetAttributes path

if attributes &&& FileAttributes.Hidden = FileAttributes.Hidden then
    // Show the file.
    let attributes =
        removeAttribute attributes FileAttributes.Hidden

    File.SetAttributes(path, attributes)
    printfn $"The {path} file is no longer hidden."
else
    // Hide the file.
    File.SetAttributes(path, File.GetAttributes path ||| FileAttributes.Hidden)
    printfn $"The {path} file is now hidden."

Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        ' Create the file if it does not exist.
        If File.Exists(path) = False Then
            File.Create(path)
        End If

        Dim attributes As FileAttributes
        attributes = File.GetAttributes(path)

        If (attributes And FileAttributes.Hidden) = FileAttributes.Hidden Then
            ' Show the file.
            attributes = RemoveAttribute(attributes, FileAttributes.Hidden)
            File.SetAttributes(path, attributes)
            Console.WriteLine("The {0} file is no longer hidden.", path)
        Else
            ' Hide the file.
            File.SetAttributes(path, File.GetAttributes(path) Or FileAttributes.Hidden)
            Console.WriteLine("The {0} file is now hidden.", path)
        End If
    End Sub

    Public Shared Function RemoveAttribute(ByVal attributes As FileAttributes, ByVal attributesToRemove As FileAttributes) As FileAttributes
        Return attributes And (Not attributesToRemove)
    End Function
End Class

Uwagi

Parametr path może określać informacje o ścieżce względnej lub bezwzględnej. Informacje o ścieżce względnej są interpretowane jako względne w stosunku do bieżącego katalogu roboczego. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.

Niektóre atrybuty plików, takie jak Hidden i ReadOnly, można połączyć. Inne atrybuty, takie jak Normal, muszą być używane samodzielnie.

Nie można zmienić stanu File kompresji obiektu przy użyciu SetAttributes metody .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• FileSystemWatcher
• Plik i Stream we/wy
• Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku