Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Amikor a Visual Studióban .NET-adateszközökkel dolgozik, adatforrásokat (.NET-objektumokat) vehet fel, hogy a .NET-alkalmazást az adattárak információihoz csatlakoztassa. A Visual Studio tervezői felhasználhatják az adatforrás kimenetét olyan sablonkód létrehozásához, amely az adatokat űrlapokhoz köti, amikor adatbázis-objektumokat húz az Adatforrások ablakból.
Adatforrások például a következők:
Egy entitás-keretrendszer-modell egy osztálya, amely valamilyen adatbázishoz van társítva
Valamilyen adatbázishoz társított adatkészlet
Egy hálózati szolgáltatást képviselő osztály, például a Windows Communication Foundation (WCF) adatszolgáltatás vagy a REST-szolgáltatás
SharePoint-szolgáltatást képviselő osztály
Osztály vagy gyűjtemény a megoldásban
Megjegyzés:
Az DataSet osztály és a kapcsolódó osztályok a 2000-es évek elejétől származó régi .NET-keretrendszer-technológiák, amelyek lehetővé teszik az alkalmazások számára a memóriában lévő adatokkal való munkát, miközben az alkalmazások leválasztva vannak az adatbázisról. A technológiák különösen hasznosak az olyan alkalmazások esetében, amelyek lehetővé teszik a felhasználók számára az adatok módosítását és a módosítások visszaállítását az adatbázisba. Bár az adathalmazok bizonyítottan sikeres technológiának számítanak, az új .NET-alkalmazásokhoz ajánlott az Entity Framework Core használata. Az Entity Framework természetesebb módot kínál a táblázatos adatok objektummodellként való használatához, és egyszerűbb programozási felülettel rendelkezik.
Előfeltételek
Olyan alkalmazás, amely a .NET-keretrendszert célzó Windows Forms- vagy Windows-bemutatóformátumú (WPF) objektumokat implementálja. Ezt az alkalmazástípust sablonnal hozhatja létre a Visual Studióban, ha a telepítés tartalmazza a .NET Desktop fejlesztési számítási feladatát. További információ: Visual Studio-számítási feladatok, összetevők és nyelvi csomagok módosítása.
Fontos
A cikkben ismertetett funkciók nem támogatottak a WPF-hez vagy a Windows Formshoz készült .NET Core-fejlesztéshez .
Az alkalmazásnak adatkötési funkciókat kell használnia: adathalmazokat, az Entity Frameworket, a Language Integrated Queryt (LINQ) az SQL-hez, egy WCF-adatszolgáltatást vagy a SharePointot.
Jótanács
Ha az alkalmazás nem használ egy vagy több összetevőt, az "adatforrás" fogalma nem érvényes. Ezekben a forgatókönyvekben közvetlenül az adatbázishoz csatlakozhat sqlCommand osztályobjektumok használatával.
Adatforrások és Windows-űrlapok használata
A .NET-keretrendszer adatforrásait a Windows Űrlapok vagy WPF-alkalmazások Adatforráskonfiguráció varázslójának használatával hozhatja létre és szerkesztheti. Adatforrást adatbázisból, szolgáltatásból, objektumból vagy SharePoint-listából hozhat létre:
Az adatforrások létrehozása után azok láthatók az Adatforrások ablakban. Ha a projekt meg van nyitva a Visual Studióban, ezt az ablakot aTöbbi>> lehetőség kiválasztásával érheti el. A Shift+Alt+D billentyűparancsot is használhatja.
A .NET-keretrendszert (nem .NET Core vagy .NET 5 vagy újabb) célzó Windows Forms-projektekben az adatforrásokat az Adatforrások ablakból egy Windows-űrlap tervezőfelületére vagy vezérlőjére húzhatja. Néhány példa arra, hogyan csatlakoztathat adatforrásokat űrlapokhoz:
Húzzon egy táblázatot egy BindingNavigator és egy DataGridView létrehozásához.
Egy konkrét oszlop húzásával kaphat egy BindingNavigatort a hozzá tartozó címkével és szövegmezővel.
Húzza az összes táblázatoszlopot a táblázat teljes adatmegtekintő űrlapjának lekéréséhez.
Ezek a műveletek aktiválják a Visual Studiót, hogy létrehozzon egy olyan sablonkódot, amely megjeleníti az adattárból származó adatokat. Az alábbi példa egy Windows-űrlapra dobott adatkészletet mutat be. Ha az alkalmazásban az F5 lehetőséget választja, az alapul szolgáló adatbázis adatai megjelennek az űrlap vezérlőiben.
Adatforrás létrehozása adatbázisból vagy adatbázisfájlból
Az Adatforrás konfigurációs varázslójával létrehozhat egy adatkészletet vagy egy Entity Framework-modellt, amely adatforrásként használható egy adatbázishoz vagy adatbázisfájlhoz. Ha a konfiguráció az Entity Frameworkt használja, először hozza létre az Entitásosztályokat, majd a varázslóval hozzon létre adatforrásokat.
Adathalmaz létrehozása adatforrásként
Az Adatforrás konfigurációs varázslója lehetővé teszi, hogy adatforrást hozzon létre egy adatbázishoz való csatlakozással. Kiválaszthatja az alkalmazás adatkészleteként használni kívánt adatbázis-objektumokat.
Kövesse az alábbi lépéseket egy adathalmaz adatforrásként való létrehozásához:
A Visual Studióban válassza a Project>Add New Data Source (Új adatforrás hozzáadása ) lehetőséget az Adatforrás konfigurációs varázslójának megnyitásához.
Az adatforrás típusához válassza az Adatbázis lehetőséget.
Az adatbázismodellhez válassza az Adathalmaz lehetőséget.
Az utasításokat követve adjon meg egy új vagy meglévő adatbáziskapcsolatot vagy adatbázisfájlt.
Jelölje ki az adathalmazba felvenni kívánt adatbázis-objektumokat, és fejezze be a varázslót.
A varázsló végrehajtására vonatkozó részletes utasításokért lásd : Adathalmazok létrehozása és konfigurálása a .NET-keretrendszerben a Visual Studióval.
Entity Framework-modell létrehozása adatforrásként
Amikor a konfiguráció az Entity Frameworkt használja, először létre kell hoznia az entitásosztályokat, majd az Adatforrás konfigurációs varázslója segítségével hozza létre az adatforrást.
Kövesse az alábbi lépéseket egy Entity Framework-modell adatforrásként való létrehozásához az Entitásadatmodell varázslóval:
Válassza a ProjectAdd New Item (Új elem hozzáadása> lehetőséget. Megnyílik az Új elem hozzáadása párbeszédpanel.
A párbeszédpanelen válassza ki az ADO.NET entitásadatmodell-sablont , adja meg a modellpéldány nevét, majd válassza a Hozzáadás elemet:
Megnyílik az Entitásadatmodell Varázsló.
A varázslóban válassza ki a metódust az Entity Framework-modell létrehozásához:
EF Designer az adatbázisból: Létrehoz egy modellt az Entity Framework Designerben egy meglévő adatbázis alapján. Kiválaszthatja az adatbázis-kapcsolatot, a modell beállításait és az adatbázis-objektumokat, hogy szerepeljenek a modellben. Az alkalmazás által felügyelt osztályok a modellből jönnek létre.
Üres EF Designer-modell: Létrehoz egy üres modellt az Entity Framework Designerben a modell vizuális tervezésének kiindulópontjaként. Később létrehozhat egy adatbázist a modellből. Az alkalmazás által felügyelt osztályok a modellből jönnek létre.
Üres kód első modellje: Létrehoz egy üres Code First modellt kiindulási pontként a modell kóddal történő tervezéséhez. Később létrehozhat egy adatbázist a modellből.
Első kód az adatbázisból: Létrehoz egy Code First modellt egy meglévő adatbázis alapján. Kiválaszthatja az adatbázis-kapcsolatot, a modell beállításait és az adatbázis-objektumokat, hogy szerepeljenek a modellben.
Miután kiválasztotta a kívánt lehetőséget, a Tovább gombra kattintva folytathatja a varázslót.
Adja hozzá a modellt az alkalmazás adatforrásaként, és fejezze be a varázslót.
A varázsló végrehajtására vonatkozó részletes utasításokért tekintse meg a Modellosztályok létrehozása az Entity Framework (C#) használatával című témakört.
Miután osztályokat hozott létre a modellhez, létrehozhat egy adatforrást egy objektumból az Adatforrás konfigurálása varázslóval.
Válassza ki a táblákat (vagy az egyes oszlopokat), a tárolt eljárásokat, a függvényeket és a nézeteket a modellből az adathalmazban való használatra.
Részletes útmutatásért lásd: Adatforrás létrehozása objektumból.
Adatforrás létrehozása szolgáltatásból
Az Adatforrás konfigurációs varázslója támogatja az adatforrások szolgáltatásból való létrehozását. Ebben a megközelítésben a Visual Studio szolgáltatáshivatkozást ad a projekthez, és proxyobjektumokat hoz létre, amelyek megfelelnek a szolgáltatás által visszaadott objektumoknak. Amikor egy szolgáltatás egy adathalmazt ad vissza, a szolgáltatás adathalmazként jelenik meg a projektben. Ha a szolgáltatás egy adott típust ad vissza, a szolgáltatás a projektben visszaadott típusként jelenik meg.
Adatforrást a következő szolgáltatástípusokból hozhat létre:
Webszolgáltatások
Megjegyzés:
Az Adatforrások ablak elemei a szolgáltatás által visszaadott adatoktól függnek. Előfordulhat, hogy egyes szolgáltatások nem nyújtanak elegendő információt az Adatforrás konfigurációs varázslója számára a köthető objektumok létrehozásához. A varázsló befejezése után, ha a szolgáltatás nem beírt adatkészletet ad vissza, az Adatforrások ablakban nem jelennek meg elemek. A be nem írt adathalmazok nem biztosítanak sémát, így a varázsló nem rendelkezik elegendő információval az adatforrás létrehozásához.
Az alábbi lépéseket követve hozzon létre adatforrást egy szolgáltatásból:
A Visual Studióban válassza a Project>Add New Data Source (Új adatforrás hozzáadása ) lehetőséget az Adatforrás konfigurációs varázslójának megnyitásához.
Az adatforrás típusához válassza a Szolgáltatás lehetőséget.
Megnyílik a Szolgáltatáshivatkozás hozzáadása párbeszédpanel. Ezt a párbeszédpanelt úgy is elérheti, hogy a jobb gombbal a projektre kattint a Megoldáskezelőben , és kiválasztja a Szolgáltatáshivatkozás hozzáadása lehetőséget.
A varázsló végrehajtására vonatkozó részletes utasításokért lásd : Adathalmazok létrehozása és konfigurálása a .NET-keretrendszerben a Visual Studióval.
Adatforrás létrehozása objektumból
Az Adatforráskonfiguráció varázslóval adatforrást is létrehozhat bármely olyan objektumból, amely egy vagy több nyilvános tulajdonságot tesz elérhetővé.
Az objektumok összes nyilvános tulajdonsága látható az Adatforrások ablakban. Ha az Entity Frameworkt generált modellel használja, ez az ablak az alkalmazás adatforrásait tartalmazó entitásosztályokat jeleníti meg.
Megjegyzés:
A húzással történő adatkötés támogatásához azokat az objektumokat, amelyek implementálják az ITypedListIListSource interfészt, alapértelmezett konstruktorsal kell rendelkezniük. Ellenkező esetben a Visual Studio nem tudja példányosítani az adatforrás-objektumot, és hibaüzenetet jelenít meg, amikor az elemet a tervezőfelületre húzza.
Az alábbi lépéseket követve hozzon létre adatforrást egy objektumból:
A Visual Studióban válassza a Project>Add New Data Source (Új adatforrás hozzáadása ) lehetőséget az Adatforrás konfigurációs varázslójának megnyitásához.
Az adatforrás típusához válassza az Objektum lehetőséget.
Az Adatobjektumok kijelölése lapon bontsa ki a csomópontokat a fanézetben, hogy megkeresse azokat az objektumokat, amelyekhez csatlakozni szeretne.
A fanézet tartalmazza a projekted csomópontjait, valamint az összeállításokat és az egyéb projekteket, amelyeket a projekted hivatkozik.
Ha olyan objektumhoz szeretne csatlakozni egy szerelvényben vagy projektben, amely nem jelenik meg a fanézetben, válassza a Hivatkozás hozzáadása lehetőséget.
A Referenciakezelő párbeszédpanelen hivatkozhat a szerelvényre vagy a projektre. A hivatkozás hozzáadása után a Visual Studio hozzáadja az összeállítást vagy a projektet a fa nézethez.
Megjegyzés:
Előfordulhat, hogy létre kell készítenie az objektumokat tartalmazó projektet, mielőtt az objektumok megjelennek a fa nézetben.
A varázsló végrehajtására vonatkozó részletes utasításokért lásd : Adathalmazok létrehozása és konfigurálása a .NET-keretrendszerben a Visual Studióval.
Adatforrás létrehozása SharePoint-listából
Az Adatforráskonfiguráció varázslóval egy SharePoint-listából is létrehozhat adatforrást. A SharePoint a WCF Data Servicesen keresztül teszi elérhetővé az adatokat, így a SharePoint-adatforrások létrehozása ugyanaz, mint egy szolgáltatásból származó adatforrás létrehozása.
Megjegyzés:
Ehhez a megközelítéshez a SharePoint SDK szükséges.
Az alábbi lépéseket követve hozzon létre adatforrást egy SharePoint-listából:
A Visual Studióban válassza a Project>Add New Data Source (Új adatforrás hozzáadása ) lehetőséget az Adatforrás konfigurációs varázslójának megnyitásához.
Az adatforrás típusához válassza a SharePointot.
A Szolgáltatáshivatkozás hozzáadása párbeszédpanel használatával kapcsolódhat a SharePoint-adatszolgáltatáshoz a SharePoint Serverre mutatva.
A varázsló végrehajtására vonatkozó részletes utasításokért lásd : Adathalmazok létrehozása és konfigurálása a .NET-keretrendszerben a Visual Studióval.