File.AppendAllLines File.AppendAllLines File.AppendAllLines File.AppendAllLines Method

Definition

Fügt Zeilen an eine Datei an und schließt dann die Datei.Appends lines to a file, and then closes the file.

Überlädt

AppendAllLines(String, IEnumerable<String>) AppendAllLines(String, IEnumerable<String>) AppendAllLines(String, IEnumerable<String>) AppendAllLines(String, IEnumerable<String>)

Fügt Zeilen an eine Datei an und schließt dann die Datei.Appends lines to a file, and then closes the file. Wenn die angegebene Datei nicht vorhanden ist, erstellt diese Methode eine Datei, schreibt die angegebenen Zeilen in die Datei und schließt die Datei dann.If the specified file does not exist, this method creates a file, writes the specified lines to the file, and then closes the file.

AppendAllLines(String, IEnumerable<String>, Encoding) AppendAllLines(String, IEnumerable<String>, Encoding) AppendAllLines(String, IEnumerable<String>, Encoding)

Fügt Zeilen unter Verwendung einer angegebenen Codierung an eine Datei an und schließt dann die Datei.Appends lines to a file by using a specified encoding, and then closes the file. Wenn die angegebene Datei nicht vorhanden ist, erstellt diese Methode eine Datei, schreibt die angegebenen Zeilen in die Datei und schließt die Datei dann.If the specified file does not exist, this method creates a file, writes the specified lines to the file, and then closes the file.

AppendAllLines(String, IEnumerable<String>) AppendAllLines(String, IEnumerable<String>) AppendAllLines(String, IEnumerable<String>) AppendAllLines(String, IEnumerable<String>)

Fügt Zeilen an eine Datei an und schließt dann die Datei.Appends lines to a file, and then closes the file. Wenn die angegebene Datei nicht vorhanden ist, erstellt diese Methode eine Datei, schreibt die angegebenen Zeilen in die Datei und schließt die Datei dann.If the specified file does not exist, this method creates a file, writes the specified lines to the file, and then closes the file.

public:
 static void AppendAllLines(System::String ^ path, System::Collections::Generic::IEnumerable<System::String ^> ^ contents);
public static void AppendAllLines (string path, System.Collections.Generic.IEnumerable<string> contents);
static member AppendAllLines : string * seq<string> -> unit
Public Shared Sub AppendAllLines (path As String, contents As IEnumerable(Of String))

Parameter

path
String String String String

Die Datei, an die Zeilen angefügt werden sollen.The file to append the lines to. Wenn die Datei nicht bereits vorhanden ist, wird sie erstellt.The file is created if it doesn't already exist.

contents
IEnumerable<String>

Die Zeilen, die an die Datei angefügt werden sollen.The lines to append to the file.

Ausnahmen

path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder mindestens ein ungültiges Zeichen gemäß der Definition durch die GetInvalidPathChars()-Methode.path is a zero-length string, contains only white space, or contains one more invalid characters defined by the GetInvalidPathChars() method.

Entweder path oder contents ist null.Either path or contents is null.

path ist ungültig (z. B. ist das Verzeichnis nicht vorhanden oder befindet sich auf einem nicht zugeordneten Laufwerk).path is invalid (for example, the directory doesn't exist or it is on an unmapped drive).

Die durch path angegebene Datei wurde nicht gefunden.The file specified by path was not found.

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.An I/O error occurred while opening the file.

path überschreitet die vom System definierte maximale Länge.path exceeds the system-defined maximum length.

path weist ein ungültiges Format auf.path is in an invalid format.

Der Aufrufer ist nicht zum Schreiben in die Datei berechtigt.The caller does not have permission to write to the file.

path gibt eine schreibgeschützte Datei an.path specifies a file that is read-only.

- oder --or- Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.This operation is not supported on the current platform.

- oder --or- path ist ein Verzeichnis.path is a directory.

Beispiele

Im folgenden Beispiel ausgewählte Zeilen aus einer Beispiel-Datendatei in eine Datei geschrieben, und klicken Sie dann weitere Zeilen angefügt.The following example writes selected lines from a sample data file to a file, and then appends more lines. Das Verzeichnis mit dem Namen temp auf Laufwerk C muss vorhanden sein, damit das Beispiel erfolgreich abgeschlossen.The directory named temp on drive C must exist for the example to complete successfully.

using System;
using System.IO;
using System.Linq;

class Program
{
	static string dataPath = @"c:\temp\timestamps.txt";

	static void Main(string[] args)
	{
		CreateSampleFile();

		var JulyWeekends = from line in File.ReadLines(dataPath)
						   where (line.StartsWith("Saturday") || 
						   line.StartsWith("Sunday")) & 
						   line.Contains("July")
						   select line;

		File.WriteAllLines(@"C:\temp\selectedDays.txt", JulyWeekends);

		var MarchMondays = from line in File.ReadLines(dataPath)
						   where line.StartsWith("Monday") && 
						   line.Contains("March")
						   select line;

		File.AppendAllLines(@"C:\temp\selectedDays.txt", MarchMondays);
	}

	static void CreateSampleFile()
	{
		DateTime TimeStamp = new DateTime(1700, 1, 1);

		using (StreamWriter sw = new StreamWriter(dataPath))
		{
			for (int i = 0; i < 500; i++)
			{
				DateTime TS1 = TimeStamp.AddYears(i);
				DateTime TS2 = TS1.AddMonths(i);
				DateTime TS3 = TS2.AddDays(i);
				sw.WriteLine(TS3.ToLongDateString());
			}
		}
	}
}
Imports System
Imports System.IO
Imports System.Linq

Class Program
    Shared dataPath As String = "c:\temp\timestamps.txt"

    Public Shared Sub Main(ByVal args As String())
        CreateSampleFile()

        Dim JulyWeekends = From line In File.ReadLines(dataPath) _
            Where (line.StartsWith("Saturday") OrElse _
            line.StartsWith("Sunday")) And line.Contains("July") _
            Select line

        File.WriteAllLines("C:\temp\selectedDays.txt", JulyWeekends)

        Dim MarchMondays = From line In File.ReadLines(dataPath) _
            Where line.StartsWith("Monday") AndAlso line.Contains("March") _
            Select line

        File.AppendAllLines("C:\temp\selectedDays.txt", MarchMondays)
    End Sub

    Private Shared Sub CreateSampleFile()
        Dim TimeStamp As New DateTime(1700, 1, 1)

        Using sw As New StreamWriter(dataPath)
            For i As Integer = 0 To 499
                Dim TS1 As DateTime = TimeStamp.AddYears(i)
                Dim TS2 As DateTime = TS1.AddMonths(i)
                Dim TS3 As DateTime = TS2.AddDays(i)

                sw.WriteLine(TS3.ToLongDateString())
            Next
        End Using
    End Sub
End Class

Hinweise

Die Methode erstellt die Datei aus, wenn dieser nicht vorhanden ist, aber keine neue Verzeichnisse erstellen.The method creates the file if it doesn't exist, but it doesn't create new directories. Deshalb ist der Wert von der path Parameter muss die vorhandene Verzeichnisse enthalten.Therefore, the value of the path parameter must contain existing directories.

AppendAllLines(String, IEnumerable<String>, Encoding) AppendAllLines(String, IEnumerable<String>, Encoding) AppendAllLines(String, IEnumerable<String>, Encoding)

Fügt Zeilen unter Verwendung einer angegebenen Codierung an eine Datei an und schließt dann die Datei.Appends lines to a file by using a specified encoding, and then closes the file. Wenn die angegebene Datei nicht vorhanden ist, erstellt diese Methode eine Datei, schreibt die angegebenen Zeilen in die Datei und schließt die Datei dann.If the specified file does not exist, this method creates a file, writes the specified lines to the file, and then closes the file.

public:
 static void AppendAllLines(System::String ^ path, System::Collections::Generic::IEnumerable<System::String ^> ^ contents, System::Text::Encoding ^ encoding);
public static void AppendAllLines (string path, System.Collections.Generic.IEnumerable<string> contents, System.Text.Encoding encoding);
static member AppendAllLines : string * seq<string> * System.Text.Encoding -> unit

Parameter

path
String String String String

Die Datei, an die Zeilen angefügt werden sollen.The file to append the lines to. Wenn die Datei nicht bereits vorhanden ist, wird sie erstellt.The file is created if it doesn't already exist.

contents
IEnumerable<String>

Die Zeilen, die an die Datei angefügt werden sollen.The lines to append to the file.

encoding
Encoding Encoding Encoding Encoding

Die zu verwendende Zeichencodierung.The character encoding to use.

Ausnahmen

path ist eine leere Zeichenfolge, enthält nur Leerzeichen oder mindestens ein ungültiges Zeichen gemäß der Definition durch die GetInvalidPathChars()-Methode.path is a zero-length string, contains only white space, or contains one more invalid characters defined by the GetInvalidPathChars() method.

Entweder path, contents oder encoding ist null.Either path, contents, or encoding is null.

path ist ungültig (z. B. ist das Verzeichnis nicht vorhanden oder befindet sich auf einem nicht zugeordneten Laufwerk).path is invalid (for example, the directory doesn't exist or it is on an unmapped drive).

Die durch path angegebene Datei wurde nicht gefunden.The file specified by path was not found.

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.An I/O error occurred while opening the file.

path überschreitet die vom System definierte maximale Länge.path exceeds the system-defined maximum length.

path weist ein ungültiges Format auf.path is in an invalid format.

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

path gibt eine schreibgeschützte Datei an.path specifies a file that is read-only.

- oder --or- Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.This operation is not supported on the current platform.

- oder --or- path ist ein Verzeichnis.path is a directory.

- oder --or- Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Hinweise

Die Methode erstellt die Datei aus, wenn dieser nicht vorhanden ist, aber keine neue Verzeichnisse erstellen.The method creates the file if it doesn't exist, but it doesn't create new directories. Deshalb ist der Wert von der path Parameter muss die vorhandene Verzeichnisse enthalten.Therefore, the value of the path parameter must contain existing directories.

Sie können diese Methode verwenden, um eine Datei zu erstellen, die das Folgendes enthält:You can use this method to create a file that contains the following:

Gilt für: