Megosztás a következőn keresztül:

SqlMetal.exe (kódgenerálási eszköz)

  • Cikk

Az SqlMetal parancssori eszköz létrehozza a LINQ és a .NET-keretrendszer SQL-összetevőjének kódját és leképezését. A jelen témakör későbbi részében megjelenő beállítások alkalmazásával utasíthatja az SqlMetalt, hogy hajtsa végre a következő műveleteket:

  • Adatbázisból hozzon létre forráskódot és leképezési attribútumokat vagy egy leképezési fájlt.

  • Adatbázisból hozzon létre egy köztes adatbázis-korrektúranyelvet (.dbml) a testreszabáshoz.

  • .dbml-fájlból hozzon létre kód- és leképezési attribútumokat vagy leképezési fájlt.

Ez az eszköz automatikusan telepítve van a Visual Studio 2019 és korábbi verzióival. A fájl alapértelmezés szerint a következő helyen található: %ProgramFiles%\Microsoft SDKs\Windows[version]\bin. Ha nem telepíti a Visual Studiót, a Windows SDK letöltésével is lekérheti az SQLMetal-fájlt.

Feljegyzés

A Visual Studiót használó fejlesztők az Objektum relációs tervezővel is létrehozhatnak entitásosztályokat. A parancssori megközelítés jól méretez nagy adatbázisok esetében. Mivel az SqlMetal parancssori eszköz, buildelési folyamatban is használhatja.

Az eszköz futtatásához használja a Visual Studio fejlesztői parancssorát vagy a Visual Studio Developer PowerShellt. A parancssorban adja meg a következő parancsot:

sqlmetal [options] [<input file>]

Beállítások

A legújabb beállításlista megtekintéséhez írjon be sqlmetal /? egy parancssort a telepített helyről.

Kapcsolati beállítások

Lehetőség Leírás
/server: <name> Megadja az adatbázis-kiszolgáló nevét.
/database: <name> A kiszolgálón található adatbáziskatalógust adja meg.
/user: <name> Megadja a bejelentkezési felhasználó azonosítóját. Alapértelmezett érték: Windows-hitelesítés használata.
/password: <password> Megadja a bejelentkezési jelszót. Alapértelmezett érték: Windows-hitelesítés használata.
/conn: <kapcsolati sztring> Megadja az adatbázis-kapcsolati sztring. A /server, /database, /user vagy /password beállításokkal nem használható.

Ne adja meg a fájlnevet a kapcsolati sztring. Ehelyett adja hozzá a fájlnevet a parancssorhoz bemeneti fájlként. A következő sor például a "c:\northwnd.mdf" értéket adja meg bemeneti fájlként: sqlmetal /code:"c:\northwind.cs" /language:csharp "c:\northwnd.mdf".
/időtúllépés: <másodperc> Időtúllépési értéket ad meg, amikor az SqlMetal hozzáfér az adatbázishoz. Alapértelmezett érték: 0 (azaz nincs időkorlát).

Kinyerési lehetőségek

Lehetőség Leírás
/Kilátás nyílik Kinyeri az adatbázisnézeteket.
/Funkciók Kinyeri az adatbázisfüggvényeket.
/sprocs Kinyeri a tárolt eljárásokat.

Kimeneti beállítások

Lehetőség Leírás
/dbml [:file] Kimenet küldése .dbml néven. A /map beállítással nem használható.
/code [:file] Kimenetet küld forráskódként. A /dbml beállítással nem használható.
/map [:file] Attribútumok helyett XML-megfeleltetési fájlt hoz létre. A /dbml beállítással nem használható.

Egyéb

Lehetőség Leírás
/language: <language> Megadja a forráskód nyelvét.

Érvényes <nyelv>: vb, csharp.

Alapértelmezett érték: A kódfájlnév bővítményéből származik.
/namespace: <name> Megadja a létrehozott kód névterét. Alapértelmezett érték: nincs névtér.
/context: <type> Az adatkörnyezet osztályának nevét adja meg. Alapértelmezett érték: Az adatbázis nevéből származik.
/entitybase: <type> Megadja az entitásosztályok alaposztályát a létrehozott kódban. Alapértelmezett érték: Az entitások nem rendelkeznek alaposztályokkal.
/pluralize Automatikusan pluralizálja vagy szingularizálja az osztály- és tagneveket.

Ez a lehetőség csak az amerikai angol verzióban érhető el.
/szerializálás: <beállítás> Szerializálható osztályokat hoz létre.

Érvényes <beállítás>: Nincs, Egyirányú. Alapértelmezett érték: Nincs.

További információ: Szerializálás.

Bemeneti fájl

Lehetőség Leírás
<bemeneti fájl> Sql Server Express .mdf fájlt, SQL Server Compact 3.5 .sdf fájlt vagy .dbml köztes fájlt határoz meg.

Megjegyzések

Az SqlMetal funkció valójában két lépésből áll:

  • Az adatbázis metaadatainak kinyerése .dbml fájlba.

  • Kódkimenetfájl létrehozása.

    A megfelelő parancssori beállítások használatával létrehozhat Visual Basic- vagy C#-forráskódot, vagy létrehozhat egy XML-megfeleltetési fájlt.

Ha egy .mdf fájlból szeretné kinyerni a metaadatokat, minden egyéb beállítás után meg kell adnia a .mdf fájl nevét.

Ha nincs megadva /kiszolgáló , a rendszer a localhost/sqlexpress függvényt feltételezi.

A Microsoft SQL Server 2005 kivételt eredményez, ha az alábbi feltételek közül egy vagy több teljesül:

  • Az SqlMetal megpróbál kinyerni egy tárolt eljárást, amely meghívja magát.

  • A tárolt eljárás, függvény vagy nézet beágyazási szintje meghaladja a 32-t.

    Az SqlMetal elkapja ezt a kivételt, és figyelmeztetésként jelenti.

Bemeneti fájlnév megadásához adja hozzá a nevet a parancssorhoz bemeneti fájlként. A kapcsolati sztring (a /conn beállítás használata) nem támogatja a fájlnevet.

Példák

Hozzon létre egy .dbml-fájlt, amely kinyert SQL-metaadatokat tartalmaz:

sqlmetal /server:myserver /database:northwind /dbml:mymeta.dbml

Hozzon létre egy .dbml-fájlt, amely egy .mdf fájlból kinyert SQL-metaadatokat tartalmaz az SQL Server Express használatával:

sqlmetal /dbml:mymeta.dbml mydbfile.mdf

Hozzon létre egy .dbml-fájlt, amely az SQL Server Expressből kinyert SQL-metaadatokat tartalmazza:

sqlmetal /server:.\sqlexpress /dbml:mymeta.dbml /database:northwind

Forráskód létrehozása .dbml metaadatfájlból:

sqlmetal /namespace:nwind /code:nwind.cs /language:csharp mymetal.dbml

Forráskód létrehozása közvetlenül az SQL-metaadatokból:

sqlmetal /server:myserver /database:northwind /namespace:nwind /code:nwind.cs /language:csharp

Feljegyzés

Ha a /pluralize lehetőséget használja a Northwind mintaadatbázissal, jegyezze fel az alábbi viselkedést. Amikor az SqlMetal sortípusneveket készít a táblákhoz, a táblanevek egyesével jelennek meg. Amikor tulajdonságokat hoz a DataContext táblákhoz, a táblanevek többes számban jelennek meg. Véletlenül a Northwind mintaadatbázis táblái már többes számban vannak. Ezért nem látja, hogy ez a rész működik. Bár az adatbázistáblák elnevezése gyakran előfordul egyesével, a .NET-ben is gyakori eljárás a gyűjtemények többes számának elnevezése.

Lásd még