File.SetAttributes メソッド

リファレンス

定義

名前空間:: System.IO

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll, System.IO.FileSystem.dll

アセンブリ:: System.IO.FileSystem.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

SetAttributes(SafeFileHandle, FileAttributes)	に関連付けられている`fileHandle`ファイルまたはディレクトリの指定した FileAttributes を設定します。
SetAttributes(String, FileAttributes)	指定したパスでファイルの指定された FileAttributes を設定します。

SetAttributes(SafeFileHandle, FileAttributes)

ソース:: File.cs

ソース:: File.cs

ソース:: File.cs

に関連付けられているfileHandleファイルまたはディレクトリの指定した FileAttributes を設定します。

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)

パラメーター

fileHandle: SafeFileHandle

SafeFileHandle設定する必要があるfileAttributesファイルまたはディレクトリの。

fileAttributes: FileAttributes

列挙値のビットごとの組み合わせ。

例外

ArgumentNullException

fileHandle が nullです。

UnauthorizedAccessException

呼び出し元に、必要なアクセス許可がありません。

注釈

メソッドを使用してSetAttributes(SafeFileHandle, FileAttributes)オブジェクトの圧縮状態をFile変更することはできません。

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	7, 8, 9

SetAttributes(String, FileAttributes)

ソース:: File.cs

ソース:: File.cs

ソース:: File.cs

指定したパスでファイルの指定された FileAttributes を設定します。

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)

パラメーター

path: String

ファイルへのパス。

fileAttributes: FileAttributes

列挙値のビットごとの組み合わせ。

例外

ArgumentException

2.1 より前のバージョンの.NET Frameworkと .NET Core: path が空であるか、空白だけが含まれているか、無効な文字が含まれているか、file 属性が無効です。

PathTooLongException

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。

NotSupportedException

path の形式が正しくありません。

DirectoryNotFoundException

指定されたパスが無効です (たとえば、マップされていないドライブにあるなど)。

FileNotFoundException

ファイルが見つかりません。

UnauthorizedAccessException

path が読み取り専用のファイルを指定しました。

- または -

この操作は、現在のプラットフォームではサポートされていません。

- または -

path がディレクトリを指定しました。

- または -

呼び出し元に、必要なアクセス許可がありません。

例

次の例では、 GetAttributes および属性をArchiveファイルに適用するメソッドと Hidden メソッドSetAttributesを示します。

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

注釈

パラメーターは path 、相対パスまたは絶対パス情報を指定できます。相対パス情報は、現在の作業ディレクトリに対する相対パスとして解釈されます。現在の作業ディレクトリを取得するには、「」を参照してください GetCurrentDirectory。

や ReadOnlyなどのHidden特定のファイル属性を組み合わせることができます。などの Normal他の属性は、単独で使用する必要があります。

メソッドを使用してSetAttributesオブジェクトの圧縮状態をFile変更することはできません。

共通 I/O タスクの一覧は、共通 I/O タスクを参照してください。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

AI Skills Fest

次の方法で共有

File.SetAttributes メソッド

定義

オーバーロード

SetAttributes(SafeFileHandle, FileAttributes)

パラメーター

例外

注釈

適用対象

SetAttributes(String, FileAttributes)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース