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.

戻り値

StreamWriter

UTF-8 エンコーディングを使用して指定したファイルに書き込まれる StreamWriterA 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 は長さ 0 の文字列であるか、空白のみで構成されるか、または InvalidPathChars で定義される 1 つ以上の使用できない文字を含んでいます。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

注釈

このメソッドは、パラメーターが StreamWriter(String, Boolean) に設定されたコンストラクターのオーバーロードに相当し append false ます。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. 現在の作業ディレクトリを取得するには、「」を参照してください GetCurrentDirectoryTo obtain the current working directory, see GetCurrentDirectory.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

適用対象

こちらもご覧ください