File.SetAttributes メソッド

.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)

C#

public static void SetAttributes
 (
    string path,
    FileAttributes fileAttributes
)

C++

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

J#

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

C#

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

J#

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

.NET Framework のセキュリティ

• FileIOPermission  (ファイルの読み書き用)FileIOPermissionAccess.Write (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
File クラス
File メンバ
System.IO 名前空間
その他の技術情報
ファイルおよびストリーム入出力
方法 : ファイルからテキストを読み取る
方法 : ファイルにテキストを書き込む