File 클래스

정의

네임스페이스:

System.IO

어셈블리:

System.Runtime.dll

Source:

File.cs

단일 파일의 생성, 복사, 삭제, 이동 및 열기를 위한 정적 메서드를 제공하고 FileStream 개체를 만드는 데 도움이 됩니다.

public ref class File abstract sealed

public static class File

type File = class

Public Class File

상속

Object

File

예제

다음 예제에서는 File 클래스를 사용하여 파일이 있는지 여부를 확인하고 결과에 따라 새 파일을 만들고 파일에 쓰거나 기존 파일을 열고 파일을 읽는 방법을 보여 줍니다. 코드를 실행하기 전에 c:\temp 폴더를 만듭니다.

using namespace System;
using namespace System::IO;
int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   if (  !File::Exists( path ) )
   {
      
      // Create a file to write to.
      StreamWriter^ sw = File::CreateText( path );
      try
      {
         sw->WriteLine( "Hello" );
         sw->WriteLine( "And" );
         sw->WriteLine( "Welcome" );
      }
      finally
      {
         if ( sw )
                  delete (IDisposable^)(sw);
      }
   }

   // Open the file to read from.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
            delete (IDisposable^)(sr);
   }

   try
   {
      String^ path2 = String::Concat( path, "temp" );
      
      // Ensure that the target does not exist.
      File::Delete( path2 );
      
      // Copy the file.
      File::Copy( path, path2 );
      Console::WriteLine( "{0} was copied to {1}.", path, path2 );
      
      // Delete the newly created file.
      File::Delete( path2 );
      Console::WriteLine( "{0} was successfully deleted.", path2 );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }
}

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        if (!File.Exists(path))
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }
        }

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(path))
        {
            string s;
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

open System.IO

let path = @"c:\temp\MyTest.txt"

if File.Exists path |> not then
    // Create a file to write to.
    use sw = File.CreateText path
    sw.WriteLine "Hello"
    sw.WriteLine "And"
    sw.WriteLine "Welcome"

// Open the file to read from.
do
    use sr = File.OpenText path
    let mutable s = sr.ReadLine()

    while isNull s |> not do
        printfn $"{s}"
        s <- sr.ReadLine()

Imports System.IO

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        If File.Exists(path) = False Then
            ' Create a file to write to.
            Using sw As StreamWriter = File.CreateText(path)
                sw.WriteLine("Hello")
                sw.WriteLine("And")
                sw.WriteLine("Welcome")
           End Using
        End If

        ' Open the file to read from.
        Using sr As StreamReader = File.OpenText(path)
            Do While sr.Peek() >= 0
                Console.WriteLine(sr.ReadLine())
            Loop
        End Using
    End Sub
End Class

설명

한 번에 단일 파일에 복사, 이동, 이름 바꾸기, 만들기, 열기, 삭제 및 추가와 같은 일반적인 작업에는 File 클래스를 사용합니다. File 클래스를 사용하여 파일 특성 또는 파일 만들기, 액세스 및 쓰기와 관련된 정보를 DateTime 설정할 수도 있습니다. 여러 파일에 대한 작업을 수행하려면 Directory.GetFiles 또는 DirectoryInfo.GetFiles참조하세요.

대부분의 File 메서드는 파일을 만들거나 열 때 다른 I/O 형식을 반환합니다. 이러한 다른 형식을 사용하여 파일을 추가로 조작할 수 있습니다. 자세한 내용은 OpenText, CreateText또는 Create같은 특정 File 멤버를 참조하세요.

모든 File 메서드는 정적이므로 하나의 작업만 수행하려는 경우 해당 FileInfo 인스턴스 메서드보다 File 메서드를 사용하는 것이 더 효율적일 수 있습니다. 모든 File 메서드에는 조작하는 파일의 경로가 필요합니다.

File 클래스의 정적 메서드는 모든 메서드에 대한 보안 검사를 수행합니다. 개체를 여러 번 다시 사용하려는 경우 보안 검사가 항상 필요한 것은 아니므로 FileInfo 해당 인스턴스 메서드를 대신 사용하는 것이 좋습니다.

기본적으로 새 파일에 대한 전체 읽기/쓰기 액세스 권한이 모든 사용자에게 부여됩니다.

다음 표에서는 다양한 File 메서드의 동작을 사용자 지정하는 데 사용되는 열거형에 대해 설명합니다.

열거형	묘사
FileAccess	파일에 대한 읽기 및 쓰기 액세스를 지정합니다.
FileShare	이미 사용 중인 파일에 허용되는 액세스 수준을 지정합니다.
FileMode	기존 파일의 내용이 보존되거나 덮어쓰여지는지 여부와 기존 파일을 만들기 위한 요청으로 인해 예외가 발생하는지 여부를 지정합니다.

메모

경로를 입력 문자열로 허용하는 멤버에서 해당 경로는 올바른 형식이어야 합니다. 그렇지 않으면 예외가 발생합니다. 예를 들어 경로가 정규화되었지만 공백으로 시작하는 경우 클래스의 메서드에서 경로가 잘려지지 않습니다. 따라서 경로 형식이 잘못되고 예외가 발생합니다. 마찬가지로 경로 또는 경로 조합은 두 번 정규화할 수 없습니다. 예를 들어 "c:\temp c:\windows"는 대부분의 경우 예외를 발생합니다. 경로 문자열을 허용하는 메서드를 사용할 때 경로가 올바른 형식인지 확인합니다.

경로를 수락하는 멤버에서 경로는 파일 또는 디렉터리를 참조할 수 있습니다. 지정된 경로는 서버 및 공유 이름에 대한 상대 경로 또는 UNC(범용 명명 규칙) 경로를 참조할 수도 있습니다. 예를 들어 다음 모든 경로는 허용 가능한 경로입니다.

• C#에서 "c:\\\MyDir\\\MyFile.txt" 또는 Visual Basic의 "c:\MyDir\MyFile.txt".
• C#에서 "c:\\\MyDir" 또는 Visual Basic의 "c:\MyDir".
• C#에서 "MyDir\\\MySubdir" 또는 Visual Basic의 "MyDir\MySubDir".
• C#에서 "\\\\\\\MyServer\\\MyShare" 또는 Visual Basic의 "\\\MyServer\MyShare".

일반적인 I/O 작업 목록은 일반적인 I/O 작업참조하세요.

메서드

AppendAllLines(String, IEnumerable<String>)	파일에 줄을 추가한 다음 파일을 닫습니다. 지정된 파일이 없으면 이 메서드는 파일을 만들고 지정된 줄을 파일에 쓴 다음 파일을 닫습니다.
AppendAllLines(String, IEnumerable<String>, Encoding)	지정된 인코딩을 사용하여 파일에 줄을 추가한 다음 파일을 닫습니다. 지정된 파일이 없으면 이 메서드는 파일을 만들고 지정된 줄을 파일에 쓴 다음 파일을 닫습니다.
AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)	파일에 줄을 비동기적으로 추가한 다음 파일을 닫습니다. 지정된 파일이 없으면 이 메서드는 파일을 만들고 지정된 줄을 파일에 쓴 다음 파일을 닫습니다.
AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	지정된 인코딩을 사용하여 파일에 줄을 비동기적으로 추가한 다음 파일을 닫습니다. 지정된 파일이 없으면 이 메서드는 파일을 만들고 지정된 줄을 파일에 쓴 다음 파일을 닫습니다.
AppendAllText(String, String)	파일을 열고 지정된 문자열을 파일에 추가한 다음 파일을 닫습니다. 파일이 없으면 이 메서드는 파일을 만들고 지정된 문자열을 파일에 쓴 다음 파일을 닫습니다.
AppendAllText(String, String, Encoding)	지정된 인코딩을 사용하여 지정된 문자열을 파일에 추가하여 파일이 아직 없는 경우 만듭니다.
AppendAllTextAsync(String, String, CancellationToken)	파일을 비동기적으로 열거나 파일이 없는 경우 파일을 만들고 지정된 문자열을 파일에 추가한 다음 파일을 닫습니다.
AppendAllTextAsync(String, String, Encoding, CancellationToken)	파일이 없는 경우 파일을 비동기적으로 열거나 파일을 만들고 지정된 인코딩을 사용하여 지정된 문자열을 파일에 추가한 다음 파일을 닫습니다.
AppendText(String)	UTF-8로 인코딩된 텍스트를 기존 파일에 추가하거나 지정된 파일이 없는 경우 새 파일에 추가하는 StreamWriter 만듭니다.
Copy(String, String)	기존 파일을 새 파일에 복사합니다. 같은 이름의 파일을 덮어쓸 수 없습니다.
Copy(String, String, Boolean)	기존 파일을 새 파일에 복사합니다. 동일한 이름의 파일을 덮어쓸 수 있습니다.
Create(String)	지정된 경로에서 파일을 만들거나 잘라내고 덮어씁니다.
Create(String, Int32)	버퍼 크기를 지정하여 지정된 경로에 파일을 만들거나 자르거나 덮어씁니다.
Create(String, Int32, FileOptions)	지정된 경로에서 파일을 만들거나 덮어쓰며, 파일을 만들거나 덮어쓰는 방법을 설명하는 버퍼 크기와 옵션을 지정합니다.
CreateSymbolicLink(String, String)	pathToTarget가리키는 path 식별되는 파일 기호 링크를 만듭니다.
CreateText(String)	UTF-8로 인코딩된 텍스트를 쓰기 위한 파일을 만들거나 엽니다. 파일이 이미 있는 경우 해당 내용이 바뀝니다.
Decrypt(String)	Encrypt(String) 메서드를 사용하여 현재 계정으로 암호화된 파일의 암호를 해독합니다.
Delete(String)	지정된 파일을 삭제합니다.
Encrypt(String)	파일을 암호화하는 데 사용되는 계정만 암호를 해독할 수 있도록 파일을 암호화합니다.
Exists(String)	지정된 파일이 있는지 여부를 확인합니다.
GetAttributes(SafeFileHandle)	fileHandle연결된 파일 또는 디렉터리의 지정된 FileAttributes 가져옵니다.
GetAttributes(String)	경로에 있는 파일의 FileAttributes 가져옵니다.
GetCreationTime(SafeFileHandle)	지정된 파일 또는 디렉터리의 생성 시간을 반환합니다.
GetCreationTime(String)	지정된 파일 또는 디렉터리의 생성 날짜 및 시간을 반환합니다.
GetCreationTimeUtc(SafeFileHandle)	지정된 파일 또는 디렉터리의 생성 날짜 및 시간을 UTC(협정 세계시)로 반환합니다.
GetCreationTimeUtc(String)	지정된 파일 또는 디렉터리의 생성 날짜 및 시간을 UTC(협정 세계시)로 반환합니다.
GetLastAccessTime(SafeFileHandle)	지정된 파일 또는 디렉터리의 마지막 액세스 날짜 및 시간을 반환합니다.
GetLastAccessTime(String)	지정된 파일 또는 디렉터리에 마지막으로 액세스한 날짜와 시간을 반환합니다.
GetLastAccessTimeUtc(SafeFileHandle)	지정된 파일 또는 디렉터리의 마지막 액세스 날짜 및 시간을 UTC(협정 세계시)로 반환합니다.
GetLastAccessTimeUtc(String)	지정된 파일 또는 디렉터리에 마지막으로 액세스한 날짜와 시간을 UTC(협정 세계시)로 반환합니다.
GetLastWriteTime(SafeFileHandle)	지정된 파일 또는 디렉터리의 마지막 쓰기 날짜 및 시간을 반환합니다.
GetLastWriteTime(String)	지정된 파일 또는 디렉터리를 마지막으로 쓴 날짜와 시간을 반환합니다.
GetLastWriteTimeUtc(SafeFileHandle)	지정된 파일 또는 디렉터리의 마지막 쓰기 날짜 및 시간을 UTC(협정 세계시)로 반환합니다.
GetLastWriteTimeUtc(String)	지정된 파일 또는 디렉터리가 마지막으로 기록된 날짜 및 시간을 UTC(협정 세계시)로 반환합니다.
GetUnixFileMode(SafeFileHandle)	지정된 파일 핸들의 UnixFileMode 가져옵니다.
GetUnixFileMode(String)	경로에 있는 파일의 UnixFileMode 가져옵니다.
Move(String, String)	지정된 파일을 새 위치로 이동하여 새 파일 이름을 지정하는 옵션을 제공합니다.
Move(String, String, Boolean)	지정된 파일을 새 위치로 이동하여 새 파일 이름을 지정하고 이미 있는 경우 대상 파일을 바꿀 수 있는 옵션을 제공합니다.
Open(String, FileMode)	공유 없이 읽기/쓰기 액세스 권한이 있는 지정된 경로에서 FileStream 엽니다.
Open(String, FileMode, FileAccess)	지정된 모드를 사용하여 지정된 경로에서 FileStream 열고 공유하지 않고 액세스합니다.
Open(String, FileMode, FileAccess, FileShare)	지정된 경로에서 읽기, 쓰기 또는 읽기/쓰기 권한이 있는 지정된 모드와 지정된 공유 옵션을 사용하여 FileStream 엽니다.
Open(String, FileStreamOptions)	지정된 경로, 생성 모드, 읽기/쓰기 및 공유 권한을 사용하여 FileStream 클래스의 새 인스턴스를 초기화하고, 다른 FileStreams에서 동일한 파일, 버퍼 크기, 추가 파일 옵션 및 할당 크기에 액세스할 수 있습니다.
OpenHandle(String, FileMode, FileAccess, FileShare, FileOptions, Int64)	지정된 경로, 생성 모드, 읽기/쓰기 및 공유 권한, 다른 SafeFileHandles에 대한 액세스 권한, 추가 파일 옵션 및 할당 크기를 사용하여 SafeFileHandle 클래스의 새 인스턴스를 초기화합니다.
OpenRead(String)	읽기 위해 기존 파일을 엽니다.
OpenText(String)	읽기 위해 기존 UTF-8로 인코딩된 텍스트 파일을 엽니다.
OpenWrite(String)	기존 파일을 열거나 쓰기 위해 새 파일을 만듭니다.
ReadAllBytes(String)	이진 파일을 열고 파일의 내용을 바이트 배열로 읽은 다음 파일을 닫습니다.
ReadAllBytesAsync(String, CancellationToken)	이진 파일을 비동기적으로 열고 파일 내용을 바이트 배열로 읽은 다음 파일을 닫습니다.
ReadAllLines(String)	텍스트 파일을 열고 파일의 모든 줄을 읽은 다음 파일을 닫습니다.
ReadAllLines(String, Encoding)	파일을 열고 지정된 인코딩을 사용하여 파일의 모든 줄을 읽은 다음 파일을 닫습니다.
ReadAllLinesAsync(String, CancellationToken)	텍스트 파일을 비동기적으로 열고 파일의 모든 줄을 읽은 다음 파일을 닫습니다.
ReadAllLinesAsync(String, Encoding, CancellationToken)	텍스트 파일을 비동기적으로 열고 지정된 인코딩을 사용하여 파일의 모든 줄을 읽은 다음 파일을 닫습니다.
ReadAllText(String)	텍스트 파일을 열고 파일의 모든 텍스트를 읽은 다음 파일을 닫습니다.
ReadAllText(String, Encoding)	파일을 열고 지정된 인코딩을 사용하여 파일의 모든 텍스트를 읽은 다음 파일을 닫습니다.
ReadAllTextAsync(String, CancellationToken)	텍스트 파일을 비동기적으로 열고 파일의 모든 텍스트를 읽은 다음 파일을 닫습니다.
ReadAllTextAsync(String, Encoding, CancellationToken)	텍스트 파일을 비동기적으로 열고 지정된 인코딩을 사용하여 파일의 모든 텍스트를 읽은 다음 파일을 닫습니다.
ReadLines(String)	파일의 줄을 읽습니다.
ReadLines(String, Encoding)	지정된 인코딩이 있는 파일의 줄을 읽습니다.
ReadLinesAsync(String, CancellationToken)	파일 줄을 비동기적으로 읽습니다.
ReadLinesAsync(String, Encoding, CancellationToken)	지정된 인코딩이 있는 파일의 줄을 비동기적으로 읽습니다.
Replace(String, String, String)	지정된 파일의 내용을 다른 파일의 내용으로 바꾸고 원래 파일을 삭제하고 대체된 파일의 백업을 만듭니다.
Replace(String, String, String, Boolean)	지정된 파일의 내용을 다른 파일의 내용으로 바꾸고, 원래 파일을 삭제하고, 대체된 파일의 백업을 만들고, 필요에 따라 병합 오류를 무시합니다.
ResolveLinkTarget(String, Boolean)	지정된 파일 링크의 대상을 가져옵니다.
SetAttributes(SafeFileHandle, FileAttributes)	fileHandle연결된 파일 또는 디렉터리의 지정된 FileAttributes 설정합니다.
SetAttributes(String, FileAttributes)	지정된 경로에 있는 파일의 지정된 FileAttributes 설정합니다.
SetCreationTime(SafeFileHandle, DateTime)	파일 또는 디렉터리를 만든 날짜와 시간을 설정합니다.
SetCreationTime(String, DateTime)	파일을 만든 날짜와 시간을 설정합니다.
SetCreationTimeUtc(SafeFileHandle, DateTime)	파일 또는 디렉터리를 만든 날짜와 시간을 UTC(협정 세계시)로 설정합니다.
SetCreationTimeUtc(String, DateTime)	파일을 만든 날짜와 시간을 UTC(협정 세계시)로 설정합니다.
SetLastAccessTime(SafeFileHandle, DateTime)	지정된 파일 또는 디렉터리에 마지막으로 액세스한 날짜와 시간을 설정합니다.
SetLastAccessTime(String, DateTime)	지정된 파일에 마지막으로 액세스한 날짜와 시간을 설정합니다.
SetLastAccessTimeUtc(SafeFileHandle, DateTime)	지정된 파일 또는 디렉터리에 마지막으로 액세스한 날짜와 시간을 UTC(협정 세계시)로 설정합니다.
SetLastAccessTimeUtc(String, DateTime)	지정된 파일에 마지막으로 액세스한 날짜와 시간을 UTC(협정 세계시)로 설정합니다.
SetLastWriteTime(SafeFileHandle, DateTime)	지정된 파일 또는 디렉터리를 마지막으로 쓴 날짜와 시간을 설정합니다.
SetLastWriteTime(String, DateTime)	지정한 파일이 마지막으로 기록된 날짜와 시간을 설정합니다.
SetLastWriteTimeUtc(SafeFileHandle, DateTime)	지정된 파일 또는 디렉터리를 마지막으로 쓴 날짜와 시간을 UTC(협정 세계시)로 설정합니다.
SetLastWriteTimeUtc(String, DateTime)	지정된 파일을 마지막으로 쓴 날짜와 시간을 UTC(협정 세계시)로 설정합니다.
SetUnixFileMode(SafeFileHandle, UnixFileMode)	지정된 파일 핸들의 지정된 UnixFileMode 설정합니다.
SetUnixFileMode(String, UnixFileMode)	지정된 경로에 있는 파일의 지정된 UnixFileMode 설정합니다.
WriteAllBytes(String, Byte[])	새 파일을 만들고 지정된 바이트 배열을 파일에 쓴 다음 파일을 닫습니다. 대상 파일이 이미 있는 경우 잘리고 덮어씁니다.
WriteAllBytesAsync(String, Byte[], CancellationToken)	새 파일을 비동기적으로 만들고 지정된 바이트 배열을 파일에 쓴 다음 파일을 닫습니다. 대상 파일이 이미 있는 경우 잘리고 덮어씁니다.
WriteAllLines(String, IEnumerable<String>)	새 파일을 만들고, 문자열 컬렉션을 파일에 쓴 다음, 파일을 닫습니다.
WriteAllLines(String, IEnumerable<String>, Encoding)	지정된 인코딩을 사용하여 새 파일을 만들고, 문자열 컬렉션을 파일에 쓴 다음, 파일을 닫습니다.
WriteAllLines(String, String[])	새 파일을 만들고 지정된 문자열 배열을 파일에 쓴 다음 파일을 닫습니다.
WriteAllLines(String, String[], Encoding)	새 파일을 만들고 지정된 인코딩을 사용하여 지정된 문자열 배열을 파일에 쓴 다음 파일을 닫습니다.
WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)	새 파일을 비동기적으로 만들고 지정된 줄을 파일에 쓴 다음 파일을 닫습니다.
WriteAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	새 파일을 비동기적으로 만들고 지정된 인코딩을 사용하여 지정된 줄을 파일에 쓴 다음 파일을 닫습니다.
WriteAllText(String, String)	새 파일을 만들고 지정된 문자열을 파일에 쓴 다음 파일을 닫습니다. 대상 파일이 이미 있는 경우 잘리고 덮어씁니다.
WriteAllText(String, String, Encoding)	새 파일을 만들고 지정된 인코딩을 사용하여 지정된 문자열을 파일에 쓴 다음 파일을 닫습니다. 대상 파일이 이미 있는 경우 잘리고 덮어씁니다.
WriteAllTextAsync(String, String, CancellationToken)	새 파일을 비동기적으로 만들고 지정된 문자열을 파일에 쓴 다음 파일을 닫습니다. 대상 파일이 이미 있는 경우 잘리고 덮어씁니다.
WriteAllTextAsync(String, String, Encoding, CancellationToken)	새 파일을 비동기적으로 만들고 지정된 인코딩을 사용하여 지정된 문자열을 파일에 쓴 다음 파일을 닫습니다. 대상 파일이 이미 있는 경우 잘리고 덮어씁니다.

추가 정보

• DriveInfo
• FileSystemWatcher
• 파일 및 스트림 I/O
• 파일 텍스트를 읽는
• 방법: 파일 텍스트 쓰기
• 방법: 새로 만든 데이터 파일 읽기 및 쓰기