File.AppendText(String) File.AppendText(String) File.AppendText(String) File.AppendText(String) Method

定義

StreamWriter を作成します。これは、UTF-8 でエンコードされたテキストを既存のファイルに 追加するか、指定したファイルが存在しない場合は新しいファイルに追加します。Creates a StreamWriter that appends UTF-8 encoded text to an existing file, or to a new file if the specified file does not exist.

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

パラメーター

path
String String String String

追加先のファイル パス。The path to the file to append to.

戻り値

指定したファイルまたは新しいファイルに、UTF-8 エンコードされたテキストを追加するストリーム ライター。A stream writer that appends UTF-8 encoded text to the specified file or to a new file.

例外

呼び出し元に、必要なアクセス許可がありません。The caller does not have the required permission.

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.

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。The specified path, file name, or both exceed the system-defined maximum length.

指定されたパスが有効ではありません (たとえば、ディレクトリが存在しない、またはマップされていないドライブにあるなど)。The specified path is invalid (for example, the directory doesn't exist or it is on an unmapped drive).

path の形式が正しくありません。path is in an invalid format.

次の例では、ファイルにテキストを追加します。The following example appends text to a file. メソッドは、ファイルが存在しない場合、新しいファイルを作成します。The method creates a new file if the file doesn't exist. ただし、ディレクトリの名前tempドライブ C は、例が正常に完了するために存在する必要があります。However, the directory named temp on drive C must exist for the example to complete successfully.

using namespace System;
using namespace System::IO;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // This text is added only once to the file.
   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;
      }
   }
   
   // This text is always added, making the file longer over time
   // if it is not deleted.
   StreamWriter^ sw = File::AppendText( path );
   try
   {
      sw->WriteLine( "This" );
      sw->WriteLine( "is Extra" );
      sw->WriteLine( "Text" );
   }
   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";
        // This text is added only once to the file.
        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");
            }	
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        using (StreamWriter sw = File.AppendText(path)) 
        {
            sw.WriteLine("This");
            sw.WriteLine("is Extra");
            sw.WriteLine("Text");
        }	

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

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

    ' This text is added only once to the file. 
    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

    ' This text is always added, making the file longer over time 
    ' if it is not deleted.
    Using sw As StreamWriter = File.AppendText(path)
      sw.WriteLine("This")
      sw.WriteLine("is Extra")
      sw.WriteLine("Text")
    End Using

    ' 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)コンス トラクター オーバー ロードします。This method is equivalent to the StreamWriter(String, Boolean) constructor overload. ファイルを指定して場合pathが存在しない作成されます。If the file specified by path does not exist, it is created. ファイルが存在する場合、書き込み操作、StreamWriterテキスト ファイルを追加します。If the file does exist, write operations to the StreamWriter append text to the file. 追加のスレッドは、開いているとき、ファイルの読み取りが許可されます。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.

pathパラメーター小文字は区別されません。The path parameter is not case-sensitive.

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

セキュリティ

FileIOPermission
指定したファイルに追加します。for appending to the specified file. 関連付けられた列挙体。 AppendAssociated enumeration: Append

適用対象

こちらもご覧ください