Jak konwertować pliki DGN do TXT przy użyciu GroupDocs.Conversion .NET

Wprowadzenie

Czy szukasz efektywnego sposobu na create output folder C# i przekształcenie złożonych plików DGN w bardziej przystępny format TXT? Wielu architektów, inżynierów i specjalistów budowlanych potrzebuje wyodrębnić dane tekstowe z rysunków CAD do raportów, potoków analizy danych lub integracji z systemami legacy. Ten samouczek przeprowadzi Cię przez użycie GroupDocs.Conversion .NET do załadowania pliku DGN, skonfigurowania odpowiedniego katalogu wyjściowego i wygenerowania czystego pliku TXT — wszystko przy użyciu przejrzystego, gotowego do produkcji kodu.

Czego się nauczysz

  • Jak skonfigurować GroupDocs.Conversion dla .NET
  • Jak create output folder C# i określić miejsce docelowe dla konwertowanych plików
  • Jak załadować plik DGN i przekonwertować go na TXT
  • Kluczowe opcje konfiguracji pozwalające precyzyjnie dostroić proces konwersji

Szybkie odpowiedzi

  • Która biblioteka obsługuje konwersję DGN‑do‑TXT? GroupDocs.Conversion .NET
  • Czy potrzebna jest licencja do użytku produkcyjnego? Tak, wymagana jest pełna lub tymczasowa licencja.
  • Czy mogę uruchomić to na .NET 6? Oczywiście – biblioteka wspiera .NET 5/6, .NET Core 3.1 oraz .NET Framework 4.5+.
  • Jak utworzyć folder wyjściowy w C#? Użyj Directory.CreateDirectory(path) przed konwersją.
  • Jaka jest typowa prędkość konwersji? Konwersja 200‑stronicowego DGN do TXT zazwyczaj kończy się w mniej niż 2 sekund na standardowym serwerze.

Co to jest „create output folder C#”?

Create output folder C# odnosi się do programowego zapewnienia, że katalog istnieje w systemie plików przed zapisem plików, zazwyczaj przy użyciu System.IO.Directory.CreateDirectory. Zapobiega to błędom „ścieżka nie znaleziona” podczas operacji zapisu.

Dlaczego warto używać GroupDocs.Conversion do konwersji CAD do TXT?

GroupDocs.Conversion obsługuje ponad 50 formatów wejściowych i wyjściowych, w tym DGN, DWG i DXF, oraz może przetwarzać pliki do 2 GB bez ładowania całego dokumentu do pamięci. Jego natywny silnik ekstrakcji tekstu zachowuje nazwy warstw, adnotacje i dane atrybutów, dostarczając plik TXT odzwierciedlający tekstową zawartość oryginalnego rysunku z 99 % dokładnością.

Wymagania wstępne

  • Biblioteka GroupDocs.Conversion .NET (wersja 25.3.0 lub nowsza)
  • Visual Studio 2022 (lub dowolne IDE obsługujące C# 8.0+)
  • .NET 6 SDK (lub .NET Core 3.1 / .NET Framework 4.5+)
  • Ważna licencja GroupDocs (bezpłatna wersja próbna lub tymczasowa licencja do testów)

Konfiguracja GroupDocs.Conversion dla .NET

Zainstaluj bibliotekę GroupDocs.Conversion przy użyciu wybranego menedżera pakietów.

Konsola Menedżera Pakietów NuGet:

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI:

dotnet add package GroupDocs.Conversion --version 25.3.0

Pro tip: Po instalacji dodaj plik licencji do projektu i załaduj go przy starcie aplikacji, aby uniknąć błędów licencjonowania w czasie działania.

Podstawowa inicjalizacja

Klasa Converter jest podstawowym komponentem GroupDocs.Conversion, który ładuje pliki źródłowe i wykonuje transformacje formatów.

using System;
using GroupDocs.Conversion;

// Initialize the conversion handler
class Program
{
    static void Main()
    {
        var converter = new Converter("path/to/your/file.dgn");
        Console.WriteLine("Setup complete. Ready to convert!");
    }
}

Przewodnik implementacji

Jak utworzyć folder wyjściowy w C#?

Directory.CreateDirectory tworzy wszystkie katalogi i podkatalogi w podanej ścieżce, jeśli jeszcze nie istnieją.

Użyj Directory.CreateDirectory, aby zapewnić istnienie ścieżki docelowej przed wywołaniem API konwersji. Ten jedyny wiersz zarówno tworzy folder, jeśli go brakuje, jak i cicho pomyślnie kończy się, gdy folder już istnieje, eliminując wyjątki „katalog nie znaleziony” podczas zapisu plików. Zwraca także pełną ścieżkę, którą możesz ponownie wykorzystać do logowania lub dalszego przetwarzania.

string outputFolder = Path.Combine(Environment.CurrentDirectory, "ConvertedFiles");
Directory.CreateDirectory(outputFolder);

Ładowanie i konwersja pliku DGN do TXT

Przegląd

Ta funkcja umożliwia załadowanie pliku DGN i konwersję go do reprezentacji tekstowej (TXT), co jest przydatne przy wyodrębnianiu notatek projektowych, metadanych lub wbudowanych komentarzy z rysunków architektonicznych.

Krok 1: Zdefiniuj ścieżkę katalogu wyjściowego

Określ, gdzie będą zapisywane przekonwertowane pliki. Poniższy przykład tworzy folder ConvertedFiles w katalogu głównym aplikacji.

string outputFolder = Path.Combine("YOUR_OUTPUT_DIRECTORY", "ConvertedFiles");
Directory.CreateDirectory(outputFolder); // Ensure directory exists

Dlaczego: Definiowanie dedykowanej ścieżki wyjściowej utrzymuje projekt uporządkowany i ułatwia odnalezienie wygenerowanych plików TXT do dalszego przetwarzania.

Krok 2: Skonfiguruj opcje konwersji

Klasa TxtConvertOptions przechowuje ustawienia wymagane do konwersji, umożliwiając dostosowanie zakończeń linii, kodowania oraz tego, czy uwzględniać ukryte warstwy.

var txtOptions = new TxtConvertOptions
{
    Encoding = Encoding.UTF8,
    IncludeHiddenLayers = false
};

Co robi: Ten obiekt precyzyjnie określa, jak konwerter ma renderować reprezentację tekstową, zapewniając spójne wyniki w różnych źródłach DGN.

Krok 3: Wykonaj konwersję

Uruchom konwersję z wcześniej zdefiniowanymi opcjami. Wyrażenie lambda tworzy plik wyjściowy w locie, unikając tymczasowego przechowywania.

var convertOptions = new TextConvertOptions();

Dlaczego: Użycie lambdy dla Save daje pełną kontrolę nad strumieniem wyjściowym, co jest szczególnie przydatne przy integracji konwersji z usługami webowymi lub workerami w tle.

Krok 4: Uruchom konwersję

Na koniec wywołaj metodę Convert, przekazując ścieżkę źródłowego pliku DGN, docelowy format oraz obiekt opcji.

converter.Convert(() => File.Create(Path.Combine(outputFolder, "output.txt")), convertOptions);

Dlaczego: Metoda obsługuje wszystkie niskopoziomowe parsowanie, ekstrakcję tekstu i zapis pliku w jednym wywołaniu, uwalniając Cię od konieczności radzenia sobie z złożonymi wewnętrznymi strukturami CAD.

Typowe problemy i rozwiązania

  • Błąd „File Not Found”: Upewnij się, że ścieżka do pliku DGN jest absolutna lub poprawnie względna względem pliku wykonywalnego.
  • Problemy z uprawnieniami: Sprawdź, czy aplikacja działa pod kontem posiadającym uprawnienia zapisu do folderu wyjściowego.
  • Błędy konwersji: Zweryfikuj, czy wersja pakietu NuGet GroupDocs.Conversion jest zgodna z wersją pliku licencji; niezgodne wersje mogą powodować awarie w czasie działania.

Praktyczne zastosowania

Ta możliwość konwersji może być zintegrowana z:

  1. Ekstrakcją danych: Pobieranie adnotacji tekstowych z rysunków DGN do analiz lub raportów.
  2. Interoperacyjnością: Przekazywanie wyodrębnionego tekstu do systemów GIS, baz BIM lub starszych modułów ERP, które akceptują jedynie dane tekstowe.
  3. Automatyzacją przepływów pracy: Wstawienie kroku konwersji w pipeline CI/CD w celu automatycznego generowania dokumentacji z plików projektowych.

Wskazówki dotyczące wydajności

Podczas przetwarzania dużych partii plików CAD pamiętaj o następujących zaleceniach:

  • Optymalizacja zużycia zasobów: Monitoruj zużycie pamięci; GroupDocs przetwarza pliki w trybie strumieniowym, co utrzymuje niski ślad pamięciowy nawet przy rysunkach setek stron.
  • Efektywne zarządzanie pamięcią: Zwolnij instancję Converter po każdej konwersji, aby niezwłocznie zwolnić zasoby niezarządzane.
  • Przetwarzanie wsadowe: Użyj Parallel.ForEach do równoczesnej konwersji wielu plików DGN, ale ogranicz stopień równoległości, aby nie wyczerpać CPU ani przepustowości I/O.

Zasoby

Zakończenie

Gratulacje! Nauczyłeś się create output folder C#, załadować plik DGN i przekonwertować go na TXT przy użyciu GroupDocs.Conversion .NET. Integrując te kroki w swoich aplikacjach, usprawnisz ekstrakcję danych, poprawisz interoperacyjność i zwiększysz ogólną produktywność w przepływach pracy skoncentrowanych na CAD.

Eksploruj dodatkowe formaty — takie jak DGN → PDF czy DGN → DOCX — zamieniając TxtConvertOptions na odpowiednią klasę opcji. Pakiet GroupDocs oferuje jednolite API obejmujące ponad 50 typów plików, dzięki czemu możesz zbudować jedną, łatwą w utrzymaniu maszynę konwersji dla wszystkich dokumentów inżynieryjnych.

Najczęściej zadawane pytania

Q: Jakie formaty plików obsługuje GroupDocs.Conversion?
A: Ponad 50 formatów, w tym PDF, DOCX, XLSX, DGN, DWG, DXF i TXT.

Q: Czy istnieje limit rozmiaru przy konwersji plików DGN?
A: Brak sztywnego limitu; wydajność skaluje się wraz z dostępną pamięcią RAM i CPU. Pliki do 2 GB konwertują się niezawodnie na standardowych serwerach.

Q: Czy mogę dostosować kodowanie tekstu wyjściowego TXT?
A: Tak — ustaw właściwość Encoding w TxtConvertOptions (np. UTF‑8, ASCII).

Q: Jak obsługiwać błędy konwersji w środowisku produkcyjnym?
A: Otocz wywołanie konwersji blokiem try‑catch, loguj szczegóły ConversionException i opcjonalnie ponów próbę z alternatywną konfiguracją.

Q: Gdzie znajdę więcej przykładów i referencje API?
A: Oficjalna dokumentacja i referencja API zawierają obszerne przykłady kodu oraz przewodniki konfiguracji.

Ostatnia aktualizacja: 2026-07-06
Testowano z: GroupDocs.Conversion .NET 25.3.0
Autor: GroupDocs

Powiązane samouczki