Edytuj dokumenty tekstowe za pomocą GroupDocs.Editor dla .NET

Wprowadzenie

Jeśli potrzebujesz edytować zwykły tekst szybko i niezawodnie w aplikacji .NET, GroupDocs.Editor dla .NET jest narzędziem, które wykonuje ciężką pracę. To API obsługuje ponad 30 formatów dokumentów, może obsługiwać pliki do 500 MB i pozwala manipulować tekstem bez ładowania całego pliku do pamięci. W tym samouczku nauczysz się, jak załadować plik txt, przyciąć końcowe spacje, zamienić wiodące spacje, ustawić właściwe kodowanie i ostatecznie zapisać edytowaną zawartość z powrotem na dysk. Gotowy do praktyki? Zanurzmy się!

Szybkie odpowiedzi

  • Jaki jest pierwszy krok, aby edytować plik txt? Załaduj plik przy użyciu Editor używając ścieżki lub strumienia, który masz.
  • Czy mogę zmienić kodowanie pliku podczas edycji? Tak – TxtSaveOptions pozwala określić UTF‑8, UTF‑16 lub dowolne niestandardowe kodowanie.
  • Jak usunąć dodatkowe spacje na końcu każdej linii? Pobierz tekst, wywołaj TrimEnd() na każdej linii i zapisz go z powrotem.
  • Czy GroupDocs.Editor jest dostępny w wersji próbnej? W pełni funkcjonalna 30‑dniowa wersja próbna jest dostępna na stronie wydań.
  • Jakie wersje .NET są obsługiwane? .NET Framework 4.6+, .NET Core 3.1+ oraz .NET 5/6/7.

Co to jest edycja plain text?

Edit plain text oznacza programowe zmienianie znaków wewnątrz prostego pliku .txt — dodawanie, usuwanie lub ponowne formatowanie tekstu — przy zachowaniu oryginalnego kodowania pliku i stylu znaków końca linii. Może to obejmować zadania takie jak przycinanie białych znaków, normalizowanie zakończeń linii, aktualizowanie wartości konfiguracyjnych lub wstawianie wygenerowanej treści. Operacja powinna pozostawić plik czytelnym dla każdego standardowego edytora tekstu i zachować istniejące metadane, takie jak znaczniki BOM.

Dlaczego używać GroupDocs.Editor do edycji plain‑text?

GroupDocs.Editor przetwarza pliki w trybie strumieniowym, co oznacza, że może edytować plik dziennika o rozmiarze 300 MB używając mniej niż 50 MB RAM. Biblioteka obsługuje ponad 50 formatów wejściowych i wyjściowych, automatycznie wykrywa style zakończeń linii (CR, LF, CRLF) i oferuje wbudowane opcje przycinania końcowych spacji oraz konwersji wiodących spacji bez konieczności pisania własnych parserów.

Wymagania wstępne

  • Środowisko programistyczne .NET – Visual Studio 2022 lub VS Code z rozszerzeniem C#.
  • GroupDocs.Editor for .NET – pobierz ze strony GroupDocs.Editor for .NET (strona wydań).
  • Podstawowa znajomość C# – powinieneś być zaznajomiony z operacjami I/O na plikach oraz manipulacją łańcuchami znaków.
  • Edytor tekstu (opcjonalnie) – do przeglądania plików źródłowych; zalecany jest VS Code.
  • Szczegółowe informacje znajdziesz w dokumentacji.
  • Możesz również przeglądać ogólną stronę wydań.

Jak edytować plain text krok po kroku

Załaduj plik, edytuj jego zawartość i zapisz go ponownie – wszystko w mniej niż dziesięciu linijkach kodu. Poniższe sekcje przeprowadzą Cię przez każdy etap z jasnymi wyjaśnieniami.

Krok 1: Uzyskaj ścieżkę do wejściowego pliku TXT

Najpierw zdecyduj, czy będziesz pracować ze ścieżką do fizycznego pliku, czy ze strumieniem pamięci. Użycie ścieżki jest najprostszym podejściem w lokalnym środowisku deweloperskim.

using System.Collections.Generic;
using System.IO;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.HtmlCss.Resources;
using GroupDocs.Editor.Options;

Krok 2: Utwórz instancję klasy Editor

Editor jest główną klasą, która ładuje dokument i zapewnia możliwości edycji.

string inputFilePath = "YourSampleDocument.txt";

Krok 3: Utwórz opcje edycji TXT

TxtEditOptions konfiguruje sposób parsowania i edycji plików plain‑text, umożliwiając ustawienie kodowania oraz reguł obsługi spacji.

using (Editor editor = new Editor(inputFilePath))
{

Krok 4: Utwórz instancję EditableDocument

EditableDocument reprezentuje wersję w pamięci załadowanego dokumentu, włączając w to jego tekst oraz powiązane zasoby.

    TextEditOptions editOptions = new TextEditOptions
    {
        Encoding = System.Text.Encoding.UTF8,
        RecognizeLists = true,
        LeadingSpaces = TextLeadingSpacesOptions.ConvertToIndent,
        TrailingSpaces = TextTrailingSpacesOptions.Trim
    };

Krok 5: Edytuj zawartość dokumentu

Pobierz oryginalny tekst, zastosuj potrzebne operacje na łańcuchach (np. zamiana, przycinanie, zmiana wielkości liter) i zapisz wynik z powrotem do EditableDocument.

    EditableDocument beforeEdit = editor.Edit(editOptions);

Krok 6: Utwórz EditableDocument z zaktualizowaną zawartością

Po przekształceniu tekstu, utwórz nowy EditableDocument, który zawiera edytowany ciąg znaków oraz oryginalną kolekcję zasobów.

    string originalTextContent = beforeEdit.GetContent();
    string updatedTextContent = originalTextContent.Replace("text", "EDITED text");
    List<IHtmlResource> allResources = beforeEdit.AllResources;

Krok 7: Utwórz opcje zapisu WordProcessing

WordProcessingSaveOptions definiuje ustawienia zapisu dokumentu w formacie kompatybilnym z Word, takim jak DOCX lub DOCM.

    EditableDocument afterEdit = EditableDocument.FromMarkup(updatedTextContent, allResources);

Krok 8: Utwórz opcje zapisu TXT

TxtSaveOptions określa, jak powinien być zapisany edytowany plik plain‑text, włączając kodowanie, zachowanie zakończeń linii oraz obsługę układu tabel.

    WordProcessingSaveOptions wordSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm)
    {
        Locale = System.Globalization.CultureInfo.GetCultureInfo("en-GB")
    };

Krok 9: Przygotuj ścieżki wyjściowe

Wyprowadź katalog wyjściowy ze ścieżki pliku wejściowego, a następnie zbuduj pełne nazwy plików dla wyników DOCX i TXT.

    TextSaveOptions txtSaveOptions = new TextSaveOptions
    {
        Encoding = System.Text.Encoding.UTF8,
        PreserveTableLayout = true
    };

Krok 10: Zapisz edytowany dokument

Na koniec wywołaj editor.Save dwukrotnie — raz z opcjami WordProcessing i raz z opcjami TXT — aby wygenerować oba formaty w jednej operacji.

    string outputWordPath = Path.Combine(Path.GetDirectoryName(inputFilePath), Path.GetFileNameWithoutExtension(inputFilePath) + ".docm");
    string outputTxtPath = Path.Combine(Path.GetDirectoryName(inputFilePath), Path.GetFileNameWithoutExtension(inputFilePath) + ".txt");

Częste problemy i rozwiązania

  • Końcowe spacje pozostają po edycji – upewnij się, że TxtEditOptions.TrimTrailingSpaces jest ustawione na true przed załadowaniem dokumentu.
  • Nieprawidłowe kodowanie w zapisanym pliku – sprawdź, czy TxtSaveOptions.Encoding odpowiada żądanej stronie kodowej (np. Encoding.UTF8).
  • Duże pliki powodują OutOfMemoryException – użyj API strumieniowego (Editor.Load(Stream)) zamiast ładowania z ścieżki pliku, aby utrzymać niskie zużycie pamięci.

Najczęściej zadawane pytania

P: Jakie formaty plików obsługuje GroupDocs.Editor dla .NET?
O: Biblioteka obsługuje ponad 50 formatów, w tym DOCX, TXT, HTML, PDF i markdown, umożliwiając płynną edycję i konwersję między nimi.

P: Jak mogę uzyskać darmową wersję próbną GroupDocs.Editor dla .NET?
O: Pobierz wersję próbną ze strony wydań.

P: Czy mogę kupić tymczasową licencję do testów?
O: Tak, tymczasowe licencje są dostępne na stronie zakupu GroupDocs.

P: Gdzie mogę uzyskać wsparcie w razie problemów?
O: Oficjalne forum wsparcia jest najlepszym miejscem – odwiedź forum wsparcia GroupDocs.Editor.

P: Czy istnieje szczegółowa dokumentacja dla zaawansowanych scenariuszy?
O: Oczywiście. Pełna dokumentacja znajduje się na stronie dokumentacji GroupDocs.Editor.

Zakończenie

Teraz opanowałeś, jak edytować plain text przy użyciu GroupDocs.Editor dla .NET — ładować plik txt, przycinać spacje, konwertować wiodące spacje, ustawiać właściwe kodowanie i zapisywać wynik zarówno w formatach TXT, jak i DOCX. Ta funkcjonalność pozwala automatyzować czyszczenie plików dziennika, generować pliki konfiguracyjne w locie lub budować własne potoki przetwarzania tekstu bez wymyślania koła od nowa. Poznaj dodatkowe funkcje, takie jak przetwarzanie wsadowe i konwersja dokumentów, odwiedzając oficjalną dokumentację.

Ostatnia aktualizacja: 2026-08-10
Testowano z: GroupDocs.Editor 23.11 for .NET
Autor: GroupDocs

    editor.Save(afterEdit, outputWordPath, wordSaveOptions);
    editor.Save(afterEdit, outputTxtPath, txtSaveOptions);
}
System.Console.WriteLine("Document editing process completed successfully!");

Powiązane samouczki