File.AppendAllText Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Belirtilen dizeyi dosyaya ekler ve zaten yoksa dosyayı oluşturur.
Aşırı Yüklemeler
AppendAllText(String, String) |
Dosyayı açar, belirtilen dizeyi dosyaya ekler ve sonra dosyayı kapatır. Dosya yoksa, bu yöntem bir dosya oluşturur, belirtilen dizeyi dosyaya yazar ve dosyayı kapatır. |
AppendAllText(String, String, Encoding) |
Belirtilen dizeyi belirtilen kodlamayı kullanarak dosyaya ekler ve zaten yoksa dosyayı oluşturur. |
AppendAllText(String, String)
- Kaynak:
- File.cs
- Kaynak:
- File.cs
- Kaynak:
- File.cs
Dosyayı açar, belirtilen dizeyi dosyaya ekler ve sonra dosyayı kapatır. Dosya yoksa, bu yöntem bir dosya oluşturur, belirtilen dizeyi dosyaya yazar ve dosyayı kapatır.
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)
Parametreler
- path
- String
Belirtilen dizenin ekine eklenecek dosya.
- contents
- String
Dosyaya eklenecek dize.
Özel durumlar
2.1'den eski .NET Framework ve .NET Core sürümleri: path
sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya bir veya daha fazla geçersiz karakter içerir. yöntemini kullanarak GetInvalidPathChars() geçersiz karakterleri sorgulayabilirsiniz.
path
, null
değeridir.
Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.
Belirtilen yol geçersiz (örneğin, dizin yok veya eşlenmemiş bir sürücüde).
Dosyayı açarken bir G/Ç hatası oluştu.
path
salt okunur bir dosya belirtti.
-veya-
Bu işlem geçerli platformda desteklenmiyor.
-veya-
path
bir dizin belirtti.
-veya-
Çağıranın gerekli izni yok.
path
geçersiz bir biçimde.
Çağıranın gerekli izni yok.
Örnekler
Aşağıdaki kod örneği, dosyanın sonuna ek metin eklemek için yönteminin kullanımını AppendAllText gösterir. Bu örnekte, henüz yoksa bir dosya oluşturulur ve dosyaya metin eklenir. Ancak, örneğin başarıyla tamamlanması için C sürücüsünde adlı temp
dizinin mevcut olması gerekir.
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
Açıklamalar
Bir dize ve dosya yolu verüldüğünde, bu yöntem belirtilen dosyayı açar, dizeyi dosyanın sonuna ekler ve sonra dosyayı kapatır. Özel durumlar ortaya çıksa bile dosya tanıtıcısının bu yöntem tarafından kapatılması garanti edilir.
yöntemi, mevcut değilse dosyayı oluşturur, ancak yeni dizinler oluşturmaz. Bu nedenle, parametresinin path
değeri mevcut dizinleri içermelidir.
Şunlara uygulanır
AppendAllText(String, String, Encoding)
- Kaynak:
- File.cs
- Kaynak:
- File.cs
- Kaynak:
- File.cs
Belirtilen dizeyi belirtilen kodlamayı kullanarak dosyaya ekler ve zaten yoksa dosyayı oluşturur.
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)
Parametreler
- path
- String
Belirtilen dizenin ekine eklenecek dosya.
- contents
- String
Dosyaya eklenecek dize.
- encoding
- Encoding
Kullanılacak karakter kodlaması.
Özel durumlar
2.1'den eski .NET Framework ve .NET Core sürümleri: path
sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya bir veya daha fazla geçersiz karakter içerir. yöntemini kullanarak GetInvalidPathChars() geçersiz karakterleri sorgulayabilirsiniz.
path
, null
değeridir.
Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.
Belirtilen yol geçersiz (örneğin, dizin yok veya eşlenmemiş bir sürücüde).
Dosyayı açarken bir G/Ç hatası oluştu.
path
salt okunur bir dosya belirtti.
-veya-
Bu işlem geçerli platformda desteklenmiyor.
-veya-
path
bir dizin belirtti.
-veya-
Çağıranın gerekli izni yok.
path
geçersiz bir biçimde.
Çağıranın gerekli izni yok.
Örnekler
Aşağıdaki kod örneği, dosyanın sonuna ek metin eklemek için yönteminin kullanımını AppendAllText gösterir. Bu örnekte, henüz yoksa bir dosya oluşturulur ve dosyaya metin eklenir. Ancak, örneğin başarıyla tamamlanması için C sürücüsünde adlı temp
dizinin mevcut olması gerekir.
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
Açıklamalar
Bir dize ve dosya yolu verüldüğünde, bu yöntem belirtilen dosyayı açar, belirtilen kodlamayı kullanarak dizeyi dosyanın sonuna ekler ve sonra dosyayı kapatır. Özel durumlar ortaya çıksa bile dosya tanıtıcısının bu yöntem tarafından kapatılması garanti edilir.
yöntemi, mevcut değilse dosyayı oluşturur, ancak yeni dizinler oluşturmaz. Bu nedenle, parametresinin path
değeri mevcut dizinleri içermelidir.
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin