File.AppendAllText メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した文字列をファイルに追加し、ファイルがまだ存在しない場合は作成します。
オーバーロード
AppendAllText(String, ReadOnlySpan<Char>) |
指定した文字列をファイルに追加し、ファイルがまだ存在しない場合は作成します。 |
AppendAllText(String, String) |
ファイルを開き、指定した文字列をファイルに追加して、ファイルを閉じます。 ファイルが存在しない場合、このメソッドはファイルを作成し、指定した文字列をファイルに書き込み、ファイルを閉じます。 |
AppendAllText(String, ReadOnlySpan<Char>, Encoding) |
指定した文字列をファイルに追加し、ファイルがまだ存在しない場合は作成します。 |
AppendAllText(String, String, Encoding) |
指定したエンコードを使用して指定した文字列をファイルに追加し、ファイルがまだ存在しない場合は作成します。 |
AppendAllText(String, ReadOnlySpan<Char>)
指定した文字列をファイルに追加し、ファイルがまだ存在しない場合は作成します。
public:
static void AppendAllText(System::String ^ path, ReadOnlySpan<char> contents);
public static void AppendAllText (string path, ReadOnlySpan<char> contents);
static member AppendAllText : string * ReadOnlySpan<char> -> unit
Public Shared Sub AppendAllText (path As String, contents As ReadOnlySpan(Of Char))
パラメーター
- path
- String
追加するファイル。
- contents
- ReadOnlySpan<Char>
ファイルに書き込む文字。
例外
path
は null
です。
path
が空です。
指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。
指定されたパスが無効です (たとえば、マップされていないドライブ上にあります)。
ファイルを開くときに I/O エラーが発生しました。
path
読み取り専用のファイルを指定しました。
-又は-
path
非表示のファイルを指定しました。
-又は-
path
ディレクトリを指定しました。
-又は-
呼び出し元に必要なアクセス許可がありません。
-又は-
この操作は、現在のプラットフォームではサポートされていません。
path
が無効な形式です。
注釈
文字列とファイル パスを指定すると、このメソッドは指定されたファイルを開き、指定したエンコードを使用してファイルの末尾に文字列を追加します。
ファイルを閉じます。 例外が発生した場合でも、ファイル ハンドルは、このメソッドによって閉じられる保証されます。 このメソッドは、ファイルを作成します。
存在しないが、新しいディレクトリは作成されない場合。 したがって、path パラメーターの値には既存のディレクトリが含まれている必要があります。
適用対象
AppendAllText(String, String)
- ソース:
- File.cs
- ソース:
- File.cs
- ソース:
- File.cs
ファイルを開き、指定した文字列をファイルに追加して、ファイルを閉じます。 ファイルが存在しない場合、このメソッドはファイルを作成し、指定した文字列をファイルに書き込み、ファイルを閉じます。
public:
static void AppendAllText(System::String ^ path, System::String ^ contents);
public static void AppendAllText (string path, string contents);
public static void AppendAllText (string path, string? contents);
static member AppendAllText : string * string -> unit
Public Shared Sub AppendAllText (path As String, contents As String)
パラメーター
- path
- String
指定した文字列を追加するファイル。
- contents
- String
ファイルに追加する文字列。
例外
.NET Framework および .NET Core バージョン 2.1 より前: path
は長さ 0 の文字列で、空白のみを含むか、1 つ以上の無効な文字を含みます。
GetInvalidPathChars() メソッドを使用して、無効な文字を照会できます。
path
は null
です。
指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。
指定したパスが無効です (たとえば、ディレクトリが存在しないか、マップされていないドライブ上にあります)。
ファイルを開くときに I/O エラーが発生しました。
path
読み取り専用のファイルを指定しました。
-又は-
この操作は、現在のプラットフォームではサポートされていません。
-又は-
path
ディレクトリを指定しました。
-又は-
呼び出し元に必要なアクセス許可がありません。
path
が無効な形式です。
呼び出し元に必要なアクセス許可がありません。
例
次のコード例では、AppendAllText メソッドを使用してファイルの末尾にテキストを追加する方法を示します。 この例では、ファイルがまだ存在しない場合は作成され、テキストが追加されます。 ただし、この例が正常に完了するには、ドライブ C の temp
という名前のディレクトリが存在する必要があります。
using System;
using System.IO;
using System.Text;
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.
string createText = "Hello and Welcome" + Environment.NewLine;
File.WriteAllText(path, createText);
}
// This text is always added, making the file longer over time
// if it is not deleted.
string appendText = "This is extra text" + Environment.NewLine;
File.AppendAllText(path, appendText);
// Open the file to read from.
string readText = File.ReadAllText(path);
Console.WriteLine(readText);
}
}
open System
open System.IO
let path = @"c:\temp\MyTest.txt"
// This text is added only once to the file.
if File.Exists path |> not then
// Create a file to write to.
let createText =
"Hello and Welcome" + Environment.NewLine
File.WriteAllText(path, createText)
// This text is always added, making the file longer over time
// if it is not deleted.
let appendText =
"This is extra text" + Environment.NewLine
File.AppendAllText(path, appendText)
// Open the file to read from.
let readText = File.ReadAllText path
printfn $"{readText}"
Imports System.IO
Imports System.Text
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 File.Exists(path) = False Then
' Create a file to write to.
Dim createText As String = "Hello and Welcome" + Environment.NewLine
File.WriteAllText(path, createText)
End If
' This text is always added, making the file longer over time
' if it is not deleted.
Dim appendText As String = "This is extra text" + Environment.NewLine
File.AppendAllText(path, appendText)
' Open the file to read from.
Dim readText As String = File.ReadAllText(path)
Console.WriteLine(readText)
End Sub
End Class
注釈
文字列とファイル パスを指定すると、このメソッドは指定されたファイルを開き、ファイルの末尾に文字列を追加して、ファイルを閉じます。 例外が発生した場合でも、ファイル ハンドルは、このメソッドによって閉じられる保証されます。
このメソッドは、存在しない場合はファイルを作成しますが、新しいディレクトリは作成しません。 したがって、path
パラメーターの値には既存のディレクトリが含まれている必要があります。
適用対象
AppendAllText(String, ReadOnlySpan<Char>, Encoding)
指定した文字列をファイルに追加し、ファイルがまだ存在しない場合は作成します。
public:
static void AppendAllText(System::String ^ path, ReadOnlySpan<char> contents, System::Text::Encoding ^ encoding);
public static void AppendAllText (string path, ReadOnlySpan<char> contents, System.Text.Encoding encoding);
static member AppendAllText : string * ReadOnlySpan<char> * System.Text.Encoding -> unit
Public Shared Sub AppendAllText (path As String, contents As ReadOnlySpan(Of Char), encoding As Encoding)
パラメーター
- path
- String
追加するファイル。
- contents
- ReadOnlySpan<Char>
ファイルに書き込む文字。
- encoding
- Encoding
文字列に適用するエンコード。
例外
path
または encoding
が null
。
path
が空です。
指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。
指定されたパスが無効です (たとえば、マップされていないドライブ上にあります)。
ファイルを開くときに I/O エラーが発生しました。
path
読み取り専用のファイルを指定しました。
-又は-
path
非表示のファイルを指定しました。
-又は-
path
ディレクトリを指定しました。
-又は-
呼び出し元に必要なアクセス許可がありません。
-又は-
この操作は、現在のプラットフォームではサポートされていません。
path
が無効な形式です。
注釈
文字列とファイル パスを指定すると、このメソッドは指定されたファイルを開き、指定したエンコードを使用してファイルの末尾に文字列を追加します。
ファイルを閉じます。 例外が発生した場合でも、ファイル ハンドルは、このメソッドによって閉じられる保証されます。 このメソッドは、ファイルを作成します。
存在しないが、新しいディレクトリは作成されない場合。 したがって、path パラメーターの値には既存のディレクトリが含まれている必要があります。
適用対象
AppendAllText(String, String, Encoding)
- ソース:
- File.cs
- ソース:
- File.cs
- ソース:
- File.cs
指定したエンコードを使用して指定した文字列をファイルに追加し、ファイルがまだ存在しない場合は作成します。
public:
static void AppendAllText(System::String ^ path, System::String ^ contents, System::Text::Encoding ^ encoding);
public static void AppendAllText (string path, string contents, System.Text.Encoding encoding);
public static void AppendAllText (string path, string? contents, System.Text.Encoding encoding);
static member AppendAllText : string * string * System.Text.Encoding -> unit
Public Shared Sub AppendAllText (path As String, contents As String, encoding As Encoding)
パラメーター
- path
- String
指定した文字列を追加するファイル。
- contents
- String
ファイルに追加する文字列。
- encoding
- Encoding
使用する文字エンコード。
例外
.NET Framework および .NET Core バージョン 2.1 より前: path
は長さ 0 の文字列で、空白のみを含むか、1 つ以上の無効な文字を含みます。
GetInvalidPathChars() メソッドを使用して、無効な文字を照会できます。
path
は null
です。
指定したパス、ファイル名、またはその両方が、システム定義の最大長を超えています。
指定したパスが無効です (たとえば、ディレクトリが存在しないか、マップされていないドライブ上にあります)。
ファイルを開くときに I/O エラーが発生しました。
path
読み取り専用のファイルを指定しました。
-又は-
この操作は、現在のプラットフォームではサポートされていません。
-又は-
path
ディレクトリを指定しました。
-又は-
呼び出し元に必要なアクセス許可がありません。
path
が無効な形式です。
呼び出し元に必要なアクセス許可がありません。
例
次のコード例では、AppendAllText メソッドを使用してファイルの末尾にテキストを追加する方法を示します。 この例では、ファイルがまだ存在しない場合は作成され、テキストが追加されます。 ただし、この例が正常に完了するには、ドライブ C の temp
という名前のディレクトリが存在する必要があります。
using System;
using System.IO;
using System.Text;
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.
string createText = "Hello and Welcome" + Environment.NewLine;
File.WriteAllText(path, createText, Encoding.UTF8);
}
// This text is always added, making the file longer over time
// if it is not deleted.
string appendText = "This is extra text" + Environment.NewLine;
File.AppendAllText(path, appendText, Encoding.UTF8);
// Open the file to read from.
string readText = File.ReadAllText(path);
Console.WriteLine(readText);
}
}
open System
open System.IO
open System.Text
let path = @"c:\temp\MyTest.txt"
// This text is added only once to the file.
if File.Exists path |> not then
// Create a file to write to.
let createText =
"Hello and Welcome" + Environment.NewLine
File.WriteAllText(path, createText, Encoding.UTF8)
// This text is always added, making the file longer over time
// if it is not deleted.
let appendText =
"This is extra text" + Environment.NewLine
File.AppendAllText(path, appendText, Encoding.UTF8)
// Open the file to read from.
let readText = File.ReadAllText path
printfn $"{readText}"
Imports System.IO
Imports System.Text
Public Class Test
Public Shared Sub Main()
Dim path As String = "c:\temp\MyTest.txt"
Dim sw As StreamWriter
' This text is added only once to the file.
If File.Exists(path) = False Then
' Create a file to write to.
Dim createText As String = "Hello and Welcome" + Environment.NewLine
File.WriteAllText(path, createText, Encoding.UTF8)
End If
' This text is always added, making the file longer over time
' if it is not deleted.
Dim appendText As String = "This is extra text" + Environment.NewLine
File.AppendAllText(path, appendText, Encoding.UTF8)
' Open the file to read from.
Dim readText As String = File.ReadAllText(path)
Console.WriteLine(readText)
End Sub
End Class
注釈
文字列とファイル パスを指定すると、このメソッドは指定されたファイルを開き、指定したエンコードを使用してファイルの末尾に文字列を追加してから、ファイルを閉じます。 例外が発生した場合でも、ファイル ハンドルは、このメソッドによって閉じられる保証されます。
このメソッドは、存在しない場合はファイルを作成しますが、新しいディレクトリは作成しません。 したがって、path
パラメーターの値には既存のディレクトリが含まれている必要があります。
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示