File.SetAttributes メソッド

[アーティクル]
03/28/2008

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

Public Shared Sub SetAttributes( _
   ByVal path As String, _   ByVal fileAttributes As FileAttributes _)
[C#]
public static void SetAttributes(stringpath,FileAttributesfileAttributes);
[C++]
public: static void SetAttributes(String* path,FileAttributesfileAttributes);
[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	割り当てられていないドライブであるなど、指定されたパスが無効です。

解説

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

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

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

使用例

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

 
Imports System
Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        ' Delete the file if it exists.
        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";

        // Delete the file if it exists.
        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 <mscorlib.dll>

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main() {
    String* path = S"c:\\temp\\MyTest.txt";

    // Delete the file if it exists.
    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(S"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(S"The {0} file is now hidden.", path);
    }
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

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

参照

File.SetAttributes メソッド

パラメータ

例外

解説

使用例

必要条件

参照

その他のリソース