File.Create 메서드

정의

지정된 경로에 파일을 만들거나 지정된 경로의 파일을 덮어씁니다.Creates or overwrites a file in the specified path.

오버로드

Create(String)

지정된 경로에 파일을 만들거나 지정된 경로의 파일을 덮어씁니다.Creates or overwrites a file in the specified path.

Create(String, Int32)

지정된 경로에 파일을 만들거나 덮어써서 버퍼 크기를 지정합니다.Creates or overwrites a file in the specified path, specifying a buffer size.

Create(String, Int32, FileOptions)

지정된 경로에 파일을 만들거나 덮어써서 버퍼 크기와 파일을 만들거나 덮어쓰는 방법을 설명하는 옵션을 지정합니다.Creates or overwrites a file in the specified path, specifying a buffer size and options that describe how to create or overwrite the file.

Create(String, Int32, FileOptions, FileSecurity)

지정된 경로에 파일을 만들거나 덮어써서 버퍼 크기, 파일을 만들거나 덮어쓰는 방법을 설명하는 옵션 그리고 파일에 대한 액세스 제어 및 감사 보안을 결정하는 값을 지정합니다.Creates or overwrites a file in the specified path, specifying a buffer size, options that describe how to create or overwrite the file, and a value that determines the access control and audit security for the file.

Create(String)

지정된 경로에 파일을 만들거나 지정된 경로의 파일을 덮어씁니다.Creates or overwrites a file in the specified path.

public:
 static System::IO::FileStream ^ Create(System::String ^ path);
public static System.IO.FileStream Create (string path);
static member Create : string -> System.IO.FileStream
Public Shared Function Create (path As String) As FileStream

매개 변수

path
String

만들 파일의 경로와 이름입니다.The path and name of the file to create.

반환

FileStream에 지정된 파일에 대한 읽기/쓰기 권한을 제공하는 path입니다.A FileStream that provides read/write access to the file specified in path.

예외

호출자에게 필요한 사용 권한이 없습니다.The caller does not have the required permission.

-또는--or- path에 읽기 전용인 파일이 지정되었습니다.path specified a file that is read-only.

-또는--or- path는 숨겨진 파일을 지정했습니다.path specified a file that is hidden.

path가 빈 문자열이거나 공백만 포함하거나 InvalidPathChars로 정의된 하나 이상의 잘못된 문자를 포함합니다.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

pathnull인 경우path is null.

지정된 경로, 파일 이름 또는 둘 다가 시스템에서 정의한 최대 길이를 초과합니다.The specified path, file name, or both exceed the system-defined maximum length.

지정된 경로가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있음).The specified path is invalid (for example, it is on an unmapped drive).

파일을 만드는 중 I/O 오류가 발생했습니다.An I/O error occurred while creating the file.

path의 형식이 잘못되었습니다.path is in an invalid format.

예제

다음 예제에서는 지정된 된 경로에 파일을 만듭니다, 그리고 파일에 일부 정보를 기록 및 해당 파일에서 읽습니다.The following example creates a file in the specified path, writes some information to the file, and reads from the file.

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

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

   // Open the stream and read it back.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
            delete (IDisposable^)sr;
   }
}
using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        try
        {
            // Create the file, or overwrite if the file exists.
            using (FileStream fs = File.Create(path))
            {
                byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
                // Add some information to the file.
                fs.Write(info, 0, info.Length);
            }

            // Open the stream and read it back.
            using (StreamReader sr = File.OpenText(path))
            {
                string s = "";
                while ((s = sr.ReadLine()) != null)
                {
                    Console.WriteLine(s);
                }
            }
        }

        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }
}
Imports System.IO
Imports System.Text

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

    Try
      ' Create the file, or overwrite if the file exists.
      Using fs As FileStream = File.Create(path)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

        ' Add some information to the file.
        fs.Write(info, 0, info.Length)
      End Using

      ' Open the stream and read it back. 
      Using sr As StreamReader = File.OpenText(path)
        Do While sr.Peek() >= 0
          Console.WriteLine(sr.ReadLine())
        Loop
      End Using

    Catch ex As Exception
      Console.WriteLine(ex.ToString())
    End Try

  End Sub
End Class

설명

이 메서드에서 만든 FileStream 개체의 기본 FileShare 값은 None입니다. 원래 파일 핸들이 닫힐 때까지 생성 된 파일에 액세스할 수 있는 다른 프로세스 또는 코드가 없습니다.The FileStream object created by this method has a default FileShare value of None; no other process or code can access the created file until the original file handle is closed.

이 메서드는 4096 바이트의 기본 버퍼 크기를 사용 하는 Create(String, Int32) 메서드 오버 로드와 동일 합니다.This method is equivalent to the Create(String, Int32) method overload using the default buffer size of 4,096 bytes.

path 매개 변수는 상대 또는 절대 경로 정보를 지정 하는 데 사용할 수 있습니다.The path parameter is permitted to specify relative or absolute path information. 상대 경로 정보는 현재 작업 디렉터리에 상대적으로 해석 됩니다.Relative path information is interpreted as relative to the current working directory. 현재 작업 디렉터리를 가져오려면 GetCurrentDirectory를 참조 하세요.To obtain the current working directory, see GetCurrentDirectory.

지정 된 파일이 없으면 자동으로 만들어집니다. 없는 경우이 읽기 전용이 아닌지 내용은 덮어씁니다.If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

기본적으로 새 파일에 대 한 전체 읽기/쓰기 액세스는 모든 사용자에 게 부여 됩니다.By default, full read/write access to new files is granted to all users. 파일 읽기/쓰기 액세스를 사용 하 여 열고 닫아야 다른 애플리케이션에서 열 수 있습니다.The file is opened with read/write access and must be closed before it can be opened by another application.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

보안

FileIOPermission
path 매개 변수에 설명 된 파일을 읽고 쓸 수 있는 권한입니다.for permission to read and write to the file described by the path parameter. 보안 동작: Demand합니다.Security action: Demand. 연관 된 열거형: Read, WriteAssociated enumerations: Read, Write

추가 정보

Create(String, Int32)

지정된 경로에 파일을 만들거나 덮어써서 버퍼 크기를 지정합니다.Creates or overwrites a file in the specified path, specifying a buffer size.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize);
public static System.IO.FileStream Create (string path, int bufferSize);
static member Create : string * int -> System.IO.FileStream
Public Shared Function Create (path As String, bufferSize As Integer) As FileStream

매개 변수

path
String

만들 파일의 경로와 이름입니다.The path and name of the file to create.

bufferSize
Int32

파일 읽기 및 쓰기를 위해 버퍼링할 바이트 수입니다.The number of bytes buffered for reads and writes to the file.

반환

FileStream에 지정된 파일에 대한 읽기/쓰기 권한을 제공하는 지정된 버퍼 크기의 path입니다.A FileStream with the specified buffer size that provides read/write access to the file specified in path.

예외

호출자에게 필요한 사용 권한이 없습니다.The caller does not have the required permission.

-또는--or- path에 읽기 전용인 파일이 지정되었습니다.path specified a file that is read-only.

-또는--or- path는 숨겨진 파일을 지정했습니다.path specified a file that is hidden.

path가 빈 문자열이거나 공백만 포함하거나 InvalidPathChars로 정의된 하나 이상의 잘못된 문자를 포함합니다.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

pathnull인 경우path is null.

지정된 경로, 파일 이름 또는 둘 다가 시스템에서 정의한 최대 길이를 초과합니다.The specified path, file name, or both exceed the system-defined maximum length.

지정된 경로가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있음).The specified path is invalid (for example, it is on an unmapped drive).

파일을 만드는 중 I/O 오류가 발생했습니다.An I/O error occurred while creating the file.

path의 형식이 잘못되었습니다.path is in an invalid format.

예제

다음 예제에서는 지정 된 버퍼 크기를 사용 하 여 파일을 만듭니다.The following example creates a file with the specified buffer size.

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

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path, 1024 );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

   // Open the stream and read it back.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
            delete (IDisposable^)sr;
   }
}
using System;
using System.IO;
using System.Text;

class Test 
{
    public static void Main() 
    {
        string path = @"c:\temp\MyTest.txt";

        // Create the file, or overwrite if the file exists.
        using (FileStream fs = File.Create(path, 1024)) 
        {
            byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
            // Add some information to the file.
            fs.Write(info, 0, info.Length);
        }

        // Open the stream and read it back.
        using (StreamReader sr = File.OpenText(path)) 
        {
            string s = "";
            while ((s = sr.ReadLine()) != null) 
            {
                Console.WriteLine(s);
            }
        }
    }
}
Imports System.IO
Imports System.Text

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

    Try
      ' Create the file, or overwrite if the file exists.
      Using fs As FileStream = File.Create(path, 1024)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

        ' Add some information to the file.
        fs.Write(info, 0, info.Length)
      End Using

      ' Open the stream and read it back. 
      Using sr As StreamReader = File.OpenText(path)
        Do While sr.Peek() >= 0
          Console.WriteLine(sr.ReadLine())
        Loop
      End Using

    Catch ex As Exception
      Console.WriteLine(ex.ToString())
    End Try

  End Sub
End Class

설명

이 메서드에서 만든 FileStream 개체의 기본 FileShare 값은 None입니다. 원래 파일 핸들이 닫힐 때까지 생성 된 파일에 액세스할 수 있는 다른 프로세스 또는 코드가 없습니다.The FileStream object created by this method has a default FileShare value of None; no other process or code can access the created file until the original file handle is closed.

path 매개 변수는 상대 또는 절대 경로 정보를 지정 하는 데 사용할 수 있습니다.The path parameter is permitted to specify relative or absolute path information. 상대 경로 정보는 현재 작업 디렉터리에 상대적으로 해석 됩니다.Relative path information is interpreted as relative to the current working directory. 현재 작업 디렉터리를 가져오려면 GetCurrentDirectory를 참조 하세요.To obtain the current working directory, see GetCurrentDirectory.

이 메서드는 FileStream(String, FileMode, FileAccess, FileShare, Int32) 생성자 오버 로드와 동일 합니다.This method is equivalent to the FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor overload. 지정 된 파일이 없으면 자동으로 만들어집니다. 없는 경우이 읽기 전용이 아닌지 내용은 덮어씁니다.If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

기본적으로 새 파일에 대 한 전체 읽기/쓰기 액세스는 모든 사용자에 게 부여 됩니다.By default, full read/write access to new files is granted to all users. 파일 읽기/쓰기 액세스를 사용 하 여 열고 닫아야 다른 애플리케이션에서 열 수 있습니다.The file is opened with read/write access and must be closed before it can be opened by another application.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

보안

FileIOPermission
path 매개 변수에 설명 된 파일을 읽고 쓸 수 있는 권한입니다.for permission to read and write to the file described by the path parameter. 보안 동작: 요청 합니다.Security action: Demand. 연관 된 열거형: Read, WriteAssociated enumerations: Read, Write

추가 정보

Create(String, Int32, FileOptions)

지정된 경로에 파일을 만들거나 덮어써서 버퍼 크기와 파일을 만들거나 덮어쓰는 방법을 설명하는 옵션을 지정합니다.Creates or overwrites a file in the specified path, specifying a buffer size and options that describe how to create or overwrite the file.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize, System::IO::FileOptions options);
public static System.IO.FileStream Create (string path, int bufferSize, System.IO.FileOptions options);
static member Create : string * int * System.IO.FileOptions -> System.IO.FileStream
Public Shared Function Create (path As String, bufferSize As Integer, options As FileOptions) As FileStream

매개 변수

path
String

만들 파일의 경로와 이름입니다.The path and name of the file to create.

bufferSize
Int32

파일 읽기 및 쓰기를 위해 버퍼링할 바이트 수입니다.The number of bytes buffered for reads and writes to the file.

options
FileOptions

파일을 만들거나 덮어쓸 방식을 설명하는 FileOptions 값 중 하나입니다.One of the FileOptions values that describes how to create or overwrite the file.

반환

지정된 버퍼 크기의 새 파일입니다.A new file with the specified buffer size.

예외

호출자에게 필요한 사용 권한이 없습니다.The caller does not have the required permission.

-또는--or- path에 읽기 전용인 파일이 지정되었습니다.path specified a file that is read-only.

-또는--or- path는 숨겨진 파일을 지정했습니다.path specified a file that is hidden.

path가 빈 문자열이거나 공백만 포함하거나 InvalidPathChars로 정의된 하나 이상의 잘못된 문자를 포함합니다.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

pathnull인 경우path is null.

지정된 경로, 파일 이름 또는 둘 다가 시스템에서 정의한 최대 길이를 초과합니다.The specified path, file name, or both exceed the system-defined maximum length.

지정된 경로가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있음).The specified path is invalid (for example, it is on an unmapped drive.

파일을 만드는 중 I/O 오류가 발생했습니다.An I/O error occurred while creating the file.

path의 형식이 잘못되었습니다.path is in an invalid format.

설명

path 매개 변수는 상대 또는 절대 경로 정보를 지정 하는 데 사용할 수 있습니다.The path parameter is permitted to specify relative or absolute path information. 상대 경로 정보는 현재 작업 디렉터리에 상대적으로 해석 됩니다.Relative path information is interpreted as relative to the current working directory. 현재 작업 디렉터리를 가져오려면 GetCurrentDirectory를 참조 하세요.To obtain the current working directory, see GetCurrentDirectory.

이 메서드는 FileStream(String, FileMode, FileAccess, FileShare, Int32) 생성자 오버 로드와 동일 합니다.This method is equivalent to the FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor overload. 지정 된 파일이 없으면 자동으로 만들어집니다. 없는 경우이 읽기 전용이 아닌지 내용은 덮어씁니다.If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

기본적으로 새 파일에 대 한 전체 읽기/쓰기 액세스는 모든 사용자에 게 부여 됩니다.By default, full read/write access to new files is granted to all users. 파일 읽기/쓰기 액세스를 사용 하 여 열고 닫아야 다른 애플리케이션에서 열 수 있습니다.The file is opened with read/write access and must be closed before it can be opened by another application.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

보안

FileIOPermission
path 매개 변수에 설명 된 파일을 읽고 쓸 수 있는 권한입니다.for permission to read and write to the file described by the path parameter. 보안 동작: 요청 합니다.Security action: Demand. 연관 된 열거형: Read, WriteAssociated enumerations: Read, Write

Create(String, Int32, FileOptions, FileSecurity)

지정된 경로에 파일을 만들거나 덮어써서 버퍼 크기, 파일을 만들거나 덮어쓰는 방법을 설명하는 옵션 그리고 파일에 대한 액세스 제어 및 감사 보안을 결정하는 값을 지정합니다.Creates or overwrites a file in the specified path, specifying a buffer size, options that describe how to create or overwrite the file, and a value that determines the access control and audit security for the file.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize, System::IO::FileOptions options, System::Security::AccessControl::FileSecurity ^ fileSecurity);
public static System.IO.FileStream Create (string path, int bufferSize, System.IO.FileOptions options, System.Security.AccessControl.FileSecurity fileSecurity);
static member Create : string * int * System.IO.FileOptions * System.Security.AccessControl.FileSecurity -> System.IO.FileStream

매개 변수

path
String

만들 파일의 경로와 이름입니다.The path and name of the file to create.

bufferSize
Int32

파일 읽기 및 쓰기를 위해 버퍼링할 바이트 수입니다.The number of bytes buffered for reads and writes to the file.

options
FileOptions

파일을 만들거나 덮어쓸 방식을 설명하는 FileOptions 값 중 하나입니다.One of the FileOptions values that describes how to create or overwrite the file.

fileSecurity
FileSecurity

파일의 액세스 제어 및 감사 보안을 결정하는 FileSecurity 개체입니다.A FileSecurity object that determines the access control and audit security for the file.

반환

지정된 버퍼 크기, 파일 옵션 및 파일 보안이 적용된 새 파일입니다.A new file with the specified buffer size, file options, and file security.

예외

호출자에게 필요한 사용 권한이 없습니다.The caller does not have the required permission.

-또는--or- path에 읽기 전용인 파일이 지정되었습니다.path specified a file that is read-only.

-또는--or- path는 숨겨진 파일을 지정했습니다.path specified a file that is hidden.

path가 빈 문자열이거나 공백만 포함하거나 InvalidPathChars로 정의된 하나 이상의 잘못된 문자를 포함합니다.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

pathnull인 경우path is null.

지정된 경로, 파일 이름 또는 둘 다가 시스템에서 정의한 최대 길이를 초과합니다.The specified path, file name, or both exceed the system-defined maximum length.

지정된 경로가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있음).The specified path is invalid (for example, it is on an unmapped drive).

파일을 만드는 중 I/O 오류가 발생했습니다.An I/O error occurred while creating the file.

path의 형식이 잘못되었습니다.path is in an invalid format.

설명

path 매개 변수는 상대 또는 절대 경로 정보를 지정 하는 데 사용할 수 있습니다.The path parameter is permitted to specify relative or absolute path information. 상대 경로 정보는 현재 작업 디렉터리에 상대적으로 해석 됩니다.Relative path information is interpreted as relative to the current working directory. 현재 작업 디렉터리를 가져오려면 GetCurrentDirectory를 참조 하세요.To obtain the current working directory, see GetCurrentDirectory.

이 메서드는 FileStream(String, FileMode, FileAccess, FileShare, Int32) 생성자 오버 로드와 동일 합니다.This method is equivalent to the FileStream(String, FileMode, FileAccess, FileShare, Int32) constructor overload. 지정 된 파일이 없으면 자동으로 만들어집니다. 없는 경우이 읽기 전용이 아닌지 내용은 덮어씁니다.If the specified file does not exist, it is created; if it does exist and it is not read-only, the contents are overwritten.

기본적으로 새 파일에 대 한 전체 읽기/쓰기 액세스는 모든 사용자에 게 부여 됩니다.By default, full read/write access to new files is granted to all users. 파일 읽기/쓰기 액세스를 사용 하 여 열고 닫아야 다른 애플리케이션에서 열 수 있습니다.The file is opened with read/write access and must be closed before it can be opened by another application.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

보안

FileIOPermission
path 매개 변수에 설명 된 파일을 읽고 쓸 수 있는 권한입니다.for permission to read and write to the file described by the path parameter. 보안 동작: 요청 합니다.Security action: Demand. 연관 된 열거형: Read, WriteAssociated enumerations: Read, Write

적용 대상