Návod: Jednoduchý objektový model a dotaz (Visual Basic)

Tento průvodce poskytuje základní scénář LINQ to SQL od začátku do konce s minimálními složitostmi. Vytvoříte třídu entity, která modeluje tabulku Customers v ukázkové databázi Northwind. Pak vytvoříte jednoduchý dotaz, který zobrazí seznam zákazníků, kteří se nacházejí v Londýně.

Tento návod je zaměřený na práci s kódem, aby pomohl ukázat LINQ to SQL koncepty. Normálně byste k vytvoření objektového modelu použili návrhář relačního objektu.

Poznámka:

Počítač může v následujících pokynech zobrazit různé názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio. Edice sady Visual Studio, kterou máte, a nastavení, která používáte, určují tyto prvky. Další informace najdete v tématu Přizpůsobeníintegrovaného vývojového prostředí (IDE).

Tento návod byl napsán pomocí nastavení vývoje jazyka Visual Basic.

Požadavky

  • Tento názorný postup používá k uložení souborů vyhrazenou složku (c:\linqtest). Vytvořte tuto složku před zahájením návodu.

  • Tento názorný postup vyžaduje ukázkovou databázi Northwind. Pokud tuto databázi nemáte na vývojovém počítači, můžete ji stáhnout z webu pro stažení microsoftu. Pokyny najdete v tématu Stažení ukázkových databází. Po stažení databáze zkopírujte soubor do složky c:\linqtest.

Přehled

Tento názorný postup se skládá ze šesti hlavních úloh:

  • Vytvoření řešení LINQ to SQL v sadě Visual Studio

  • Mapování třídy na tabulku databáze

  • Navrhování vlastností ve třídě tak, aby představovaly sloupce databáze.

  • Určuje připojení k databázi Northwind.

  • Vytvoření jednoduchého dotazu pro provedení v databázi

  • Provedení dotazu a sledování výsledků

Vytvoření řešení LINQ to SQL

V tomto prvním úkolu vytvoříte řešení sady Visual Studio, které obsahuje potřebné odkazy na sestavení a spuštění projektu LINQ to SQL.

Vytvoření řešení LINQ to SQL

  1. V nabídce Soubor klepněte na tlačítko Nový projekt.

  2. V podokně Typy projektů v dialogovém okně Nový projekt klepněte na položku Visual Basic.

  3. V podokně Šablony klikněte na Konzolová aplikace.

  4. Do pole Název zadejte LinqConsoleApp.

  5. Klikněte na OK.

Přidání odkazů a direktiv LINQ

Tento průvodce používá sestavení, která nemusí být nainstalována ve vašem projektu ve výchozím nastavení. Pokud System.Data.Linq v projektu není uvedený jako odkaz (klikněte na Zobrazit všechny soubory v Průzkumníku řešení a rozbalte uzel Reference ), přidejte ho, jak je vysvětleno v následujících krocích.

Jak přidat System.Data.Linq

  1. V Průzkumník řešení klikněte pravým tlačítkem na Odkazy a potom klikněte na Přidat odkaz.

  2. V dialogovém okně Přidat odkaz klikněte na .NET, vyberte sestavení System.Data.Linq a poté klikněte na OK.

    Sestavení se přidá do projektu.

  3. Také v dialogovém okně Přidat odkaz klepněte na tlačítko .NET, posuňte se na položku System.Windows.Forms a klepněte na tlačítko OK.

    Toto sestavení, které podporuje pole zprávy v návodu, je přidáno do projektu.

  4. Přidejte výše Module1uvedené direktivy:

    Imports System.Data.Linq
Imports System.Data.Linq.Mapping
Imports System.Windows.Forms

Mapování třídy na tabulku databáze

V tomto kroku vytvoříte třídu a namapujete ji na tabulku databáze. Taková třída je označena jako třída entity. Všimněte si, že mapování se provádí pouhým přidáním atributu TableAttribute . Vlastnost Name určuje název tabulky v databázi.

Vytvoření třídy entity a jeho mapování na tabulku databáze

  • Zadejte nebo vložte následující kód do Module1.vb bezprostředně nad Sub Main:

    <Table(Name:="Customers")> _
Public Class Customer
End Class

Navrhování vlastností ve třídě pro reprezentaci databázových sloupců

V tomto kroku provedete několik úkolů.

  • Atribut použijete ColumnAttribute k určení CustomerID a City vlastnostem třídy entity jako představující sloupce v tabulce databáze.

  • Označíte vlastnost CustomerID jako sloupec primárního klíče v databázi.

  • Určíte _CustomerID a _City pole pro privátní úložiště. LINQ to SQL pak může ukládat a načítat hodnoty přímo místo použití veřejných přístupových objektů, které můžou zahrnovat obchodní logiku.

Znázornění charakteristik dvou sloupců databáze

  • Zadejte nebo vložte následující kód do Module1.vb těsně před End Class:

    Private _CustomerID As String
<Column(IsPrimaryKey:=True, Storage:="_CustomerID")> _
Public Property CustomerID() As String
    Get
        Return Me._CustomerID
    End Get
    Set(ByVal value As String)
        Me._CustomerID = value
    End Set
End Property

Private _City As String
<Column(Storage:="_City")> _
Public Property City() As String
    Get
        Return Me._City
    End Get
    Set(ByVal value As String)
        Me._City = value
    End Set
End Property

Určení připojení k databázi Northwind

V tomto kroku pomocí objektu DataContext vytvoříte propojení mezi strukturami dat založenými na kódu a samotnou databází. Jedná se DataContext o hlavní kanál, prostřednictvím kterého načtete objekty z databáze a odešlete změny.

Deklarujete také Table(Of Customer), aby sloužila jako logická tabulka typu pro vaše dotazy na tabulku Customers v databázi. Tyto dotazy vytvoříte a spustíte v dalších krocích.

Určení připojení k databázi

  • Do metody zadejte nebo vložte následující kód Sub Main .

    Všimněte si, že se předpokládá, že soubor northwnd.mdf je ve složce linqtest. Další informace najdete v části Požadavky uvedené výše v tomto názorném postupu.

    ' Use a connection string.
Dim db As New DataContext _
    ("c:\linqtest\northwnd.mdf")

' Get a typed table to run queries.
Dim Customers As Table(Of Customer) = _
    db.GetTable(Of Customer)()

Vytvoření jednoduchého dotazu

V tomto kroku vytvoříte dotaz, který vyhledá zákazníky v tabulce Zákazníci databáze v Londýně. Kód dotazu v tomto kroku pouze popisuje dotaz. Nespustí ho. Tento přístup se označuje jako odložené spuštění. Další informace najdete v tématu Úvod k dotazům LINQ (C#).

Vytvoříte také výstup protokolu, který zobrazí příkazy SQL, které LINQ to SQL generuje. Tato funkce protokolování (která používá Log) je užitečná při ladění a při určování, že příkazy odesílané do databáze přesně představují váš dotaz.

Vytvoření jednoduchého dotazu

  • Zadejte nebo vložte následující kód do Sub Main metody za Table(Of Customer) deklaraci:

    ' Attach the log to show generated SQL in a console window.
db.Log = Console.Out

' Query for customers in London.
Dim custQuery = _
    From cust In Customers _
    Where cust.City = "London" _
    Select cust

Spuštění dotazu

V tomto kroku dotaz skutečně spustíte. Výrazy dotazu, které jste vytvořili v předchozích krocích, se nevyhodnocují, dokud nebudou potřebné výsledky. Při zahájení For Each iterace se provede příkaz SQL pro databázi a objekty jsou materializovány.

Pro spuštění dotazu

  1. Na konec Sub Main metody zadejte nebo vložte následující kód (za popis dotazu):

    ' Format the message box.
Dim msg As String = "", title As String = "London customers:", _
    response As MsgBoxResult, style As MsgBoxStyle = _
    MsgBoxStyle.Information

' Execute the query.
For Each custObj In custQuery
    msg &= String.Format(custObj.CustomerID & vbCrLf)
Next

' Display the results.
response = MsgBox(msg, style, title)

  2. Stiskněte F5 pro ladění aplikace.

    Poznámka:

    Pokud vaše aplikace vygeneruje chybu za běhu, prohlédněte si část Řešení potíží v části Učení podle návodů.

    V okně se zprávou se zobrazí seznam šesti zákazníků. V okně Konzola se zobrazí vygenerovaný kód SQL.

  3. Kliknutím na tlačítko OK zavřete okno se zprávou.

    Aplikace se zavře.

  4. V nabídce Soubor klikněte na Uložit vše.

    Tuto aplikaci budete potřebovat, pokud budete pokračovat v dalším návodu.

Další kroky

Návod: Dotazování napříč relacemi (Visual Basic) pokračuje tam, kde tento návod končí. Názorný postup dotazování napříč relacemi ukazuje, jak může LINQ to SQL dotazovat napříč tabulkami, podobně jako spojení v relační databázi.

Pokud chcete provést názorný postup dotazování napříč relacemi, ujistěte se, že uložíte řešení návodu, který jste právě dokončili, což je nutný předpoklad.

Viz také

  • Last updated on