File.CreateText(String) 메서드

정의

UTF-8로 인코딩된 텍스트를 쓰기 위해 파일을 만들거나 엽니다.Creates or opens a file for writing UTF-8 encoded text. 파일이 이미 있으면 해당 콘텐츠를 덮어씁니다.If the file already exists, its contents are overwritten.

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

매개 변수

path
String

쓰기용으로 열 파일입니다.The file to be opened for writing.

반환

UTF-8 인코딩을 사용하여 지정된 파일에 쓸 StreamWriter입니다.A StreamWriter that writes to the specified file using UTF-8 encoding.

예외

호출자에게 필요한 사용 권한이 없습니다.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).

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

예제

다음 예제에서는 텍스트를 쓰고 읽는 파일을 만듭니다.The following example creates a file for text writing and reading.

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;
   }
}
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);
            }
        }
    }
}
Imports System.IO
Imports System.Text

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

    If Not File.Exists(path) 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

설명

이 메서드는 false로 설정 된 append 매개 변수를 사용 하는 StreamWriter(String, Boolean) 생성자 오버 로드와 동일 합니다.This method is equivalent to the StreamWriter(String, Boolean) constructor overload with the append parameter set to false. path에 지정 된 파일이 존재 하지 않는 경우 만들어집니다.If the file specified by path does not exist, it is created. 파일이 없으면 해당 내용은 덮어씁니다.If the file does exist, its contents are overwritten. 추가 스레드는 열려 있는 동안 파일을 읽을 수 있습니다.Additional threads are permitted to read the file while it is open.

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.

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

보안

FileIOPermission
지정된 된 파일에 작성 합니다.for writing to the specified file. 연결 된 열거형: WriteAssociated enumeration: Write

적용 대상

추가 정보