File.SetAttributes Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Aşırı Yüklemeler

SetAttributes(SafeFileHandle, FileAttributes)	ile fileHandleilişkilendirilmiş dosya veya dizinin belirtilen FileAttributes değerini ayarlar.
SetAttributes(String, FileAttributes)	Belirtilen FileAttributes yolda belirtilen dosyayı ayarlar.

SetAttributes(SafeFileHandle, FileAttributes)

Kaynak:

File.cs

ile fileHandleilişkilendirilmiş dosya veya dizinin belirtilen FileAttributes değerini ayarlar.

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)

Parametreler

fileHandle

SafeFileHandle

Ayarlanması gereken dosyaya veya dizine fileAttributes ASafeFileHandle.

fileAttributes

FileAttributes

Numaralandırma değerlerinin bit düzeyinde bir birleşimi.

Özel durumlar

ArgumentNullException

fileHandle, null değeridir.

UnauthorizedAccessException

Çağıranın gerekli izni yok.

Açıklamalar

yöntemini kullanarak SetAttributes(SafeFileHandle, FileAttributes) bir File nesnenin sıkıştırma durumunu değiştirmek mümkün değildir.

SetAttributes(String, FileAttributes)

Kaynak:

File.cs

Belirtilen FileAttributes yolda belirtilen dosyayı ayarlar.

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)

Parametreler

path

String

Dosyanın yolu.

fileAttributes

FileAttributes

Numaralandırma değerlerinin bit düzeyinde bir birleşimi.

Özel durumlar

ArgumentException

2.1'den eski .NET Framework ve .NET Core sürümleri: path boş, yalnızca boşluk içeriyor, geçersiz karakterler içeriyor veya dosya özniteliği geçersiz.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.

NotSupportedException

path geçersiz bir biçimde.

DirectoryNotFoundException

Belirtilen yol geçersiz (örneğin, yol eşlenmemiş bir sürücü üzerinde).

FileNotFoundException

Dosya bulunamıyor.

UnauthorizedAccessException

path salt okunur bir dosya belirtti.

-veya-

Bu işlem geçerli platformda desteklenmiyor.

-veya-

path bir dizin belirtti.

-veya-

Çağıranın gerekli izni yok.

Örnekler

Aşağıdaki örnek, ve SetAttributes özniteliklerini bir dosyaya uygulayarak Archive ve Hidden yöntemlerini gösterirGetAttributes.

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

Açıklamalar

parametresinin path göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgisi, geçerli çalışma dizinine göre yorumlanır. Geçerli çalışma dizinini edinmek için bkz GetCurrentDirectory. .

ve ReadOnlygibi Hidden bazı dosya öznitelikleri birleştirilebilir. gibi Normaldiğer öznitelikler tek başına kullanılmalıdır.

yöntemini kullanarak SetAttributes bir File nesnenin sıkıştırma durumunu değiştirmek mümkün değildir.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

• FileSystemWatcher
• Dosya ve Stream G/Ç
• Dosyadan metin okuma
• Nasıl yapılır: Bir Dosyaya Metin Yazma