File.SetAttributes メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

File.SetAttributes メソッド

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

名前空間: System.IO
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim path As String
Dim fileAttributes As FileAttributes

File.SetAttributes(path, fileAttributes)

public static void SetAttributes
 (
    string path,
    FileAttributes fileAttributes
)

C++

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

public static void SetAttributes
 (
    String path, 
    FileAttributes fileAttributes
)

JScript

public static function SetAttributes
 (
    path : String, 
    fileAttributes : FileAttributes
)

パラメータ

path: ファイルへのパス。

fileAttributes: Hidden、ReadOnly、Normal、および Archive など必要な FileAttributes。

例外

例外の種類	条件
ArgumentException	path が空か、空白だけが含まれているか、無効な文字が含まれているか、またはファイル属性が無効です。
PathTooLongException	指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームの場合、パスの長さは 248 文字未満、ファイル名の長さは 260 文字未満である必要があります。
NotSupportedException	path の形式が無効です。
DirectoryNotFoundException	指定したパスが無効です (割り当てられていないドライブであるなど)。
FileNotFoundException	ファイルが見つかりません。
UnauthorizedAccessException	path によって、読み取り専用のファイルが指定されました。またはこの操作は、現在のプラットフォームではサポートされていません。または path によってディレクトリが指定されました。または呼び出し元に、必要なアクセス許可がありません。

解説

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

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

このメソッドの使用例については、「使用例」を参照してください。その他の一般的な I/O タスクまたは関連する I/O タスクの例を次の表に示します。

実行するタスク	参考例があるトピック
テキストファイルを作成する。	方法 : ファイルにテキストを書き込む
テキストファイルに書き込む。	方法 : ファイルにテキストを書き込む
テキストファイルから読み取る。	方法 : ファイルからテキストを読み取る
テキストをファイルに追加する。	方法 : ログファイルを開いて情報を追加する File.AppendText FileInfo.AppendText
ファイルの名前を変更、またはファイルを移動する。	File.Move FileInfo.MoveTo
ファイルの属性を取得する。	File.GetAttributes
バイナリファイルから読み取る。	方法 : 新しく作成されたデータファイルに対して読み書きする
バイナリファイルに書き込む。	方法 : 新しく作成されたデータファイルに対して読み書きする

使用例

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

Visual Basic

Imports System
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

        If (File.GetAttributes(path) And FileAttributes.Hidden)
 = FileAttributes.Hidden Then
            ' Show the file.
            File.SetAttributes(path, FileAttributes.Archive)
            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
End Class

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);
        }

        if ((File.GetAttributes(path) & FileAttributes.Hidden)
 == FileAttributes.Hidden) 
        {
            // Show the file.
            File.SetAttributes(path, FileAttributes.Archive);
            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);
        }
    }
}

C++

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, FileAttributes::Archive );
      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 );
   }
}

import System.*;
import System.IO.*;
import System.Text.*;

class Test
{
    public static void main(String[]
 args)
    {
        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).
            Equals(FileAttributes.Hidden)) {
            // Show the file.
            File.SetAttributes(path, FileAttributes.Archive);
            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);
        }
    } //main
} //Test