Pliki tekstowe — program, który pamięta po zamknięciu

Czego się dziś nauczysz

Przygotowanie: lekcje 01–35. Przewidywany czas: 45–90 minut z zadaniami. Przykłady wymagają .NET 8 lub nowszego, z włączonymi ImplicitUsings i Nullable.

Wyjaśnienie krok po kroku

Gdzie jest plik

Ścieżka "wyniki.txt" jest względna wobec bieżącego katalogu roboczego procesu. Directory.GetCurrentDirectory() zwraca jego pełną ścieżkę. Path.Combine łączy części ścieżki z odpowiednim separatorem. Nie zakładaj, że plik powstanie obok Program.cs.

Zapis nadpisuje

File.WriteAllLines zapisuje tablicę wierszy. Jeśli plik już istnieje, jego dotychczasowa zawartość jest zastępowana. File.AppendAllText dopisuje tekst na końcu. Przykład używa nazwy cwiczenie-wyniki.txt i jest przeznaczony do osobnego folderu ćwiczeń.

Kodowanie i błędy

Kodowanie określa sposób zapisu znaków jako bajtów. Jawne Encoding.UTF8 przy zapisie i odczycie upraszcza pracę z polskimi literami. Brak uprawnień i problemy dysku wymagają obsługi, nawet jeśli nazwa pliku wygląda poprawnie. Metody WriteAllLines i ReadAllLines same zamykają używane zasoby.

Przykład do zbadania

Wklej cały przykład do nowego projektu konsolowego jako Program.cs. Zastąp poprzednią zawartość pliku. Nie łącz kilku całych programów w jednym pliku.

using System;
using System.IO;
using System.Text;

string sciezka = Path.Combine(Directory.GetCurrentDirectory(), "cwiczenie-wyniki.txt");
string[] wyniki = { "Ala;8", "Ola;10" };
try
{
    File.WriteAllLines(sciezka, wyniki, Encoding.UTF8);
    string[] wiersze = File.ReadAllLines(sciezka, Encoding.UTF8);
    foreach (string wiersz in wiersze) Console.WriteLine(wiersz);
}
catch (UnauthorizedAccessException)
{
    Console.WriteLine("Brak uprawnien do pliku.");
}
catch (IOException)
{
    Console.WriteLine("Nie udalo sie zapisac lub odczytac pliku.");
}

Ala;8
Ola;10

Co dzieje się po kolei

• Wynik poniżej zakłada udany zapis i odczyt w folderze ćwiczeń.
• Plik zawiera dwa wiersze, a ReadAllLines zwraca je jako string[].
• Średnik jest umownym separatorem danych w tym prostym formacie; nie tworzymy pełnego formatu CSV.

Pobierz Program.cs

Użyte w tej lekcji elementy

Metody .NET są gotowymi narzędziami biblioteki. Instrukcje języka i nasze metody oznaczamy osobno. Właściwości, np. Length, odczytujemy bez nawiasów.

Częste błędy

• WriteAllLines nie dopisuje do istniejących danych.
• Sprawdzenie File.Exists nie gwarantuje, że późniejszy odczyt się uda.
• ReadAllLines nie jest dobrym wyborem dla plików, które nie mieszczą się w pamięci.

using, IDisposable i strumienie

File.ReadAllLines i File.WriteAllLines otwierają i zamykają plik same. Gdy plik jest duży albo chcesz czytać wiersz po wierszu, sięgasz po strumień — a strumień trzeba zamknąć.

using (StreamReader czytnik = new StreamReader("dane.txt"))
{
    string? wiersz;
    while ((wiersz = czytnik.ReadLine()) != null)
    {
        Console.WriteLine(wiersz);
    }
}   // tutaj plik zostaje zamkniety — nawet gdy w srodku wystapil wyjatek

Instrukcja using obiecuje jedno: przy wyjściu z bloku wywoła metodę Dispose obiektu. Mogą z niej korzystać wszystkie typy implementujące interfejs IDisposable — strumienie plików, połączenia z bazą danych, obrazy. Zapis skrócony bez klamer, using StreamReader czytnik = new StreamReader("dane.txt");, zamyka obiekt na końcu metody.

Zadania

Sprawdź, czy rozumiesz

Wyjaśnij własnymi słowami, jak działa główny przykład i dlaczego daje taki wynik. Następnie zmień jedną daną i przewidź wynik przed uruchomieniem. Wróć do celów lekcji i sprawdź, które potrafisz już wykonać samodzielnie.

Dokumentacja: Microsoft Learn — temat tej lekcji.