File.SetAttributes Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Aşırı Yüklemeler

Name	Description
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

Için ayarlanması gereken dosya veya dizine fileAttributes ASafeFileHandle.

fileAttributes

FileAttributes

Sabit listesi değerlerinin bit düzeyinde birleşimi.

Özel durumlar

ArgumentNullException

fileHandle, null'e eşittir.

UnauthorizedAccessException

Çağıranın gerekli izni yok.

Açıklamalar

yöntemini kullanarak File bir SetAttributes(SafeFileHandle, FileAttributes) 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

Sabit listesi değerlerinin bit düzeyinde 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 de sistem tanımlı uzunluk üst sınırını aşıyor.

NotSupportedException

path geçersiz biçimde.

DirectoryNotFoundException

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

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 GetAttributes özniteliklerini bir dosyaya SetAttributesArchive uygulayarak ve Hidden yöntemlerini gösterir.

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 bilgileri geçerli çalışma dizinine göre yorumlanır. Geçerli çalışma dizinini edinmek için bkz. GetCurrentDirectory.

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

yöntemini kullanarak File bir SetAttributes 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 Akış G/Ç'si
• Dosyadan Metin Okuma
• Nasıl yapılır: Dosyaya Metin Yazma