Hogyan konvertáljunk DGN fájlokat TXT formátumba a GroupDocs.Conversion .NET segítségével

Bevezetés

Hatékony módot keres, hogy create output folder C#-t készítsen, és átalakítsa a komplex DGN fájlokat könnyebben kezelhető TXT formátumba? Sok építész, mérnök és építőipari szakembernek kell egyszerű szöveges adatokat kinyerni a CAD rajzokból jelentésekhez, adat‑elemzési folyamatokhoz vagy régi rendszerek integrálásához. Ez az útmutató végigvezeti Önt a GroupDocs.Conversion .NET használatán, egy DGN fájl betöltésén, a megfelelő kimeneti könyvtár beállításán és egy tiszta TXT fájl generálásán — mindezt világos, termelés‑kész kóddal.

Mit fog megtanulni

  • Hogyan állítsuk be a GroupDocs.Conversion-t .NET-hez
  • Hogyan create output folder C#-t készítsünk, és adjuk meg a célhelyet a konvertált fájlok számára
  • Hogyan töltsünk be egy DGN fájlt és konvertáljuk TXT‑be
  • Kulcsfontosságú konfigurációs beállítások, amelyek lehetővé teszik a konverziós folyamat finomhangolását

Gyors válaszok

  • Melyik könyvtár kezeli a DGN‑to‑TXT konverziót? GroupDocs.Conversion .NET
  • Szükségem van licencre a termeléshez? Igen, teljes vagy ideiglenes licenc szükséges.
  • Futtatható ez .NET 6‑on? Teljesen – a könyvtár támogatja a .NET 5/6, .NET Core 3.1 és a .NET Framework 4.5+ verziókat.
  • Hogyan hozom létre a kimeneti mappát C#‑ban? Használja a Directory.CreateDirectory(path)‑t a konverzió előtt.
  • Milyen a tipikus konverziós sebesség? Egy 200 oldalas DGN TXT‑re konvertálása általában 2 másodpercnél gyorsabban befejeződik egy szabványos szerveren.

Mi az a “create output folder C#”?

Create output folder C# arra utal, hogy programozottan biztosítjuk egy könyvtár létezését a fájlrendszeren, mielőtt fájlokat írunk bele, általában a System.IO.Directory.CreateDirectory használatával. Ez megakadályozza a “path not found” hibákat a fájlírási műveletek során.

Miért használjuk a GroupDocs.Conversion-t CAD‑ról TXT‑re?

A GroupDocs.Conversion 50+ bemeneti és kimeneti formátumot támogat, beleértve a DGN, DWG és DXF formátumokat, és akár 2 GB‑ig terjedő fájlokat tud feldolgozni anélkül, hogy a teljes dokumentumot a memóriába töltené. Natív szövegkinyerő motorja megőrzi a rétegneveket, megjegyzéseket és attribútum adatokat, egy TXT fájlt biztosítva, amely az eredeti rajz szöveges tartalmát 99 %‑os hűséggel tükrözi.

Előfeltételek

  • GroupDocs.Conversion .NET könyvtár (25.3.0 vagy újabb verzió)
  • Visual Studio 2022 (vagy bármely IDE, amely támogatja a C# 8.0+‑t)
  • .NET 6 SDK (vagy .NET Core 3.1 / .NET Framework 4.5+)
  • Érvényes GroupDocs licenc (ingyenes próba vagy ideiglenes licenc teszteléshez)

A GroupDocs.Conversion beállítása .NET-hez

Telepítse a GroupDocs.Conversion könyvtárat a választott csomagkezelő segítségével.

NuGet csomagkezelő konzol:

Install-Package GroupDocs.Conversion -Version 25.3.0

.NET CLI:

dotnet add package GroupDocs.Conversion --version 25.3.0

Pro tipp: A telepítés után adja hozzá a licencfájlt a projektjéhez, és töltse be az alkalmazás indításakor, hogy elkerülje a futásidejű licenchibákat.

Alapvető inicializálás

A Converter osztály a GroupDocs.Conversion központi komponense, amely betölti a forrásfájlokat és végrehajtja a formátumátalakításokat.

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!");
    }
}

Megvalósítási útmutató

Hogyan hozok létre kimeneti mappát C#‑ban?

Directory.CreateDirectory létrehozza az összes könyvtárat és alkönyvtárat a megadott útvonalon, ha még nem léteznek.

Használja a Directory.CreateDirectory‑t, hogy biztosítsa a célútvonal létezését a konverziós API meghívása előtt. Ez az egyetlen sor létrehozza a mappát, ha hiányzik, és csendben sikeresen befejeződik, ha már létezik, ezzel elkerülve a “directory not found” kivételeket a fájlírás során. Emellett visszaadja a teljes útvonalat, amelyet naplózáshoz vagy további feldolgozáshoz újra felhasználhat.

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

DGN fájl betöltése és konvertálása TXT‑be

Áttekintés

Ez a funkció lehetővé teszi, hogy betöltsön egy DGN fájlt és átalakítsa egyszerű szöveges (TXT) reprezentációvá, ami hasznos a tervezési jegyzetek, metaadatok vagy beágyazott megjegyzések kinyeréséhez az építészeti rajzokból.

1. lépés: A kimeneti könyvtár útvonalának meghatározása

Adja meg, hogy hol legyenek elmentve a konvertált fájlok. Az alábbi példa egy ConvertedFiles nevű mappát hoz létre az alkalmazás gyökérkönyvtárában.

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

Miért: Egy dedikált kimeneti útvonal meghatározása rendezetten tartja a projektet, és megkönnyíti a generált TXT fájlok megtalálását a további feldolgozáshoz.

2. lépés: Konverziós beállítások konfigurálása

A TxtConvertOptions osztály tartalmazza a konverzióhoz szükséges beállításokat, lehetővé téve a sorvégek, kódolás és a rejtett rétegek belefoglalásának testreszabását.

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

Mit csinál: Ez az objektum pontosan meghatározza a konverter számára, hogyan jelenítse meg a szöveges reprezentációt, biztosítva a következetes eredményeket különböző DGN források között.

3. lépés: A konverzió végrehajtása

Hajtsa végre a konverziót a korábban definiált beállításokkal. A lambda kifejezés a helyben hozza létre a kimeneti fájlt, elkerülve az ideiglenes tárolást.

var convertOptions = new TextConvertOptions();

Miért: A Save‑hez lambda használata teljes ellenőrzést ad a kimeneti adatfolyam felett, ami különösen hasznos a konverzió webszolgáltatásokba vagy háttérfolyamatokba való integrálásakor.

4. lépés: A konverzió futtatása

Végül hívja meg a Convert metódust, átadva a forrás DGN útvonalát, a célformátumot és a beállítási objektumot.

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

Miért: A metódus egyetlen hívásban kezeli az összes alacsony szintű elemzést, szövegkinyerést és fájlírást, így nem kell a komplex CAD belső részleteivel foglalkoznia.

Gyakori problémák és megoldások

  • File Not Found hiba: Ellenőrizze, hogy a DGN fájl útvonala abszolút vagy helyesen relatív az exe fájlhoz képest.
  • Jogosultsági problémák: Győződjön meg róla, hogy az alkalmazás olyan fiók alatt fut, amelynek írási hozzáférése van a kimeneti mappához.
  • Konverziós hibák: Győződjön meg arról, hogy a GroupDocs.Conversion NuGet csomag verziója megegyezik a licencfájl verziójával; a verzióeltérés futásidejű hibákat okozhat.

Gyakorlati alkalmazások

Ez a konverziós képesség integrálható a következőkbe:

  1. Adatkinyerés: Szöveges megjegyzések kinyerése DGN rajzokból elemzés vagy jelentéskészítés céljából.
  2. Interoperabilitás: A kinyert szöveg betáplálása GIS rendszerekbe, BIM adatbázisokba vagy régi ERP modulokba, amelyek csak egyszerű szöveget fogadnak.
  3. Automatizált munkafolyamatok: A konverziós lépés beágyazása CI/CD csővezetékekbe, hogy automatikusan dokumentációt generáljon a tervezési fájlokból.

Teljesítménybeli megfontolások

Nagyméretű CAD fájlcsomagok feldolgozásakor tartsa szem előtt ezeket a tippeket:

  • Erőforrás-használat optimalizálása: Figyelje a memóriafogyasztást; a GroupDocs streaming módban dolgozza fel a fájlokat, ami alacsony memóriaigényt biztosít még több száz oldalas rajzok esetén is.
  • Hatékony memória-kezelés: A Converter példányt minden konverzió után dobja el, hogy a nem kezelt erőforrások gyorsan felszabaduljanak.
  • Csomagfeldolgozás: Használja a Parallel.ForEach‑t több DGN fájl egyidejű konvertálásához, de korlátozza a párhuzamosság fokát, hogy elkerülje a CPU vagy I/O sávszélesség kimerülését.

Források

Következtetés

Gratulálunk! Megtanulta, hogyan create output folder C#-t készítsen, hogyan töltsön be egy DGN fájlt, és hogyan konvertálja TXT‑be a GroupDocs.Conversion .NET segítségével. Ezeknek a lépéseknek az alkalmazásba való integrálásával egyszerűsíti az adatkinyerést, javítja az interoperabilitást, és növeli a termelékenységet a CAD‑központú munkafolyamataiban.

Fedezzen fel további formátumokat — például DGN → PDF vagy DGN → DOCX — a TxtConvertOptions megfelelő opcióosztályra cserélésével. A GroupDocs csomag egységes API‑t kínál, amely több mint 50 fájltípust lefed, így egyetlen, karbantartható konverziós motor építhető minden mérnöki dokumentumához.

Gyakran Ismételt Kérdések

K: Milyen fájlformátumokat támogat a GroupDocs.Conversion?
V: Több mint 50 formátum, beleértve a PDF, DOCX, XLSX, DGN, DWG, DXF és TXT formátumokat.

K: Van méretkorlát a DGN fájlok konvertálására?
V: Nincs szigorú korlát; a teljesítmény az elérhető RAM és CPU függvényében skálázódik. 2 GB‑ig terjedő fájlok megbízhatóan konvertálhatók szabványos szervereken.

K: Testreszabhatom a kimeneti TXT szövegkódolását?
V: Igen — állítsa be az Encoding tulajdonságot a TxtConvertOptions‑ban (pl. UTF‑8, ASCII).

K: Hogyan kezeljem a konverziós hibákat termelésben?
V: Tegye a konverziós hívást try‑catch blokkba, naplózza a ConversionException részleteit, és opcionálisan próbálja újra egy tartalék konfigurációval.

K: Hol találok további példákat és API‑referenciákat?
V: A hivatalos dokumentáció és API‑referencia kiterjedt kódmintákat és konfigurációs útmutatókat tartalmaz.

Utoljára frissítve: 2026-07-06
Tesztelve a következővel: GroupDocs.Conversion .NET 25.3.0
Szerző: GroupDocs

Kapcsolódó oktatóanyagok