Share via

Exemplarische Vorgehensweise: Einfaches Objektmodell und Abfrage (Visual Basic) (LINQ to SQL)

  • Artikel

Aktualisiert: November 2007

Diese exemplarische Vorgehensweise stellt ein grundlegendes End-to-End-Szenario für LINQ to SQL mit minimaler Komplexität bereit. Sie erstellen eine Entitätsklasse, die die Customers-Tabelle in der Beispieldatenbank Northwind modelliert. Sie erstellen dann eine einfache Abfrage, um Kunden aus London aufzulisten.

Diese exemplarische Vorgehensweise ist codeorientiert, um LINQ to SQL-Konzepte zu verdeutlichen. Normalerweise würden Sie O/R-Designer verwenden, um das Objektmodell zu erstellen.

Hinweis:

Ihr Computer zeigt für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung möglicherweise andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Diese exemplarische Vorgehensweise wurde mithilfe von Visual Basic-Entwicklungseinstellungen geschrieben.

Vorbereitungsmaßnahmen

  • Diese exemplarische Vorgehensweise verwendet einen dedizierten Ordner ("c:\linqtest") als Speicherort für Dateien. Erstellen Sie diesen Ordner, bevor Sie die exemplarische Vorgehensweise starten.

  • Für dieses Beispiel wird die Beispieldatenbank Northwind benötigt. Befindet sich diese Datenbank nicht auf Ihrem Entwicklungscomputer, können Sie diese von der Microsoft Downloadsite herunterladen. Anweisungen dazu finden Sie unter Herunterladen von Beispieldatenbanken (LINQ to SQL). Nachdem Sie die Datenbank heruntergeladen haben, kopieren Sie die Datei in den Ordner c:\linqtest.

Übersicht

Diese exemplarische Vorgehensweise umfasst sechs Hauptaufgaben:

  • Erstellen einer LINQ to SQL-Lösung in Visual Studio.

  • Zuordnen einer Datenbanktabelle zu einer Klasse.

  • Festlegen von Eigenschaften für die Klasse, um Datenbankspalten darzustellen.

  • Herstellen einer Verbindung zur Beispieldatenbank Northwind.

  • Erstellen einer einfachen Abfrage der Datenbank.

  • Ausführen der Abfrage und Prüfen der Ergebnisse.

Link zu Video Eine Videodemonstration finden Sie unter Video How to: Simple Object Model and Query (Visual Basic) (LINQ to SQL).

Erstellen einer LINQ to SQL-Lösung

In dieser ersten Aufgabe erstellen Sie eine Visual Studio-Lösung, die die erforderlichen Verweise zur Erstellung und Ausführung eines LINQ to SQL-Projekts enthält.

So erstellen Sie eine LINQ to SQL-Lösung

  1. Klicken Sie im Menü Datei auf Neues Projekt.

  2. Klicken Sie im Bereich Projekttypen des Dialogfelds Neues Projekt auf Visual Basic.

  3. Klicken Sie im Bereich Vorlagen auf Konsolenanwendung.

  4. Geben Sie im Feld Name die Zeichenfolge LinqConsoleApp ein.

  5. Klicken Sie auf OK.

Hinzufügen von LINQ-Verweisen und Richtlinien

Diese exemplarische Vorgehensweise verwendet Assemblys, die im Projekt u. U. nicht standardmäßig installiert sind. Wird System.Data.Linq in Ihrem Projekt nicht als Verweis aufgeführt (klicken Sie im Projektmappen-Explorer auf Alle Dateien anzeigen, und erweitern Sie den Knoten Verweise), fügen Sie diesen wie nachfolgend beschrieben hinzu.

So fügen Sie System.Data.Linq hinzu

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und klicken Sie dann auf Verweis hinzufügen.

  2. Klicken Sie im Dialogfeld Verweis hinzufügen auf .NET, klicken Sie auf die System.Data.Linq-Assembly und dann auf OK.

    Dem Projekt wird die Assembly hinzugefügt.

  3. Klicken Sie im Dialogfeld Verweis hinzufügen auf .NET, klicken Sie dann auf System.Windows.Forms und dann auf OK.

    Dem Projekt wird diese Assembly, die das Meldungsfeld in der exemplarischen Vorgehensweise unterstützt, hinzugefügt.

  4. Fügen Sie die folgenden Direktiven oberhalb von Module1 hinzu:

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

Zuordnen einer Klasse zu einer Datenbanktabelle.

In diesem Schritt erstellen Sie eine Klasse und ordnen diese einer Datenbanktabelle zu. Eine solche Klasse wird Entitätsklasse genannt. Beachten Sie, dass die Zuordnung durch Hinzufügen des TableAttribute-Attributs erreicht wird. Die Name-Eigenschaft gibt den Namen der Tabelle in der Datenbank an.

So erstellen Sie eine Entitätsklasse und weisen diese einer Datenbanktabelle zu

  • Geben Sie den folgenden Code in Module1.vb direkt oberhalb von Sub Main ein, oder fügen Sie ihn ein:

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

Festlegen von Eigenschaften für die Klasse, um Datenbankspalten darzustellen

In diesem Schritt erledigen Sie mehrere Aufgaben.

  • Sie verwenden das ColumnAttribute-Attribut, um die CustomerID-Eigenschaft und die City-Eigenschaft der Entitätsklasse für die Darstellung von Spalten in der Datenbanktabelle festzulegen.

  • Sie legen die CustomerID-Eigenschaft zur Darstellung einer Primärschlüsselspalte in der Datenbank fest.

  • Sie legen das _CustomerID-Feld und das _City-Feld auf private Speicherung fest. LINQ to SQL kann dann Werte direkt abrufen und speichern, anstatt öffentliche Funktionen mit Geschäftslogik zu verwenden.

So stellen Sie Eigenschaften von zwei Datenbankspalten dar

  • Geben Sie den folgenden Code in Module1.vb direkt vor End Class ein, oder fügen Sie ihn ein:

    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

Herstellen einer Verbindung zur Beispieldatenbank Northwind

In diesem Schritt verwenden Sie ein DataContext-Objekt zur Einrichtung einer Verbindung zwischen Ihren codebasierten Datenstrukturen und der Datenbank selbst. Der DataContext ist der Hauptkanal, durch den Sie Objekte von der Datenbank abrufen und Änderungen übergeben.

Sie deklarieren außerdem eine Table(Of Customer) als logische, typisierte Tabelle für Ihre Abfragen der Customers-Tabelle in der Datenbank. Die Erstellung und Ausführung dieser Abfragen erfolgt später.

So definieren Sie die Datenbankverbindung

  • Geben Sie den folgenden Code in die Sub Main-Methode ein, oder fügen Sie ihn ein:

    Beachten Sie, dass die Datei northwnd.mdf im Ordner linqtest angenommen wird. Weitere Informationen finden Sie im Abschnitt zu Voraussetzungen weiter oben in dieser exemplarischen Vorgehensweise.

    ' 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)()

Erstellen einer einfachen Abfrage

In diesem Schritt erstellen Sie eine Abfrage, um zu ermitteln, welche Kunden in der Customers-Datenbanktabelle aus London stammen. Im Abfragecode in diesem Schritt wird nur die Abfrage beschrieben. Die Abfrage wird nicht ausgeführt. Dieser Ansatz wird als verzögerte Ausführung bezeichnet. Weitere Informationen finden Sie unter Einführung in LINQ-Abfragen.

Sie erzeugen auch eine Protokollausgabe, um die SQL-Befehle anzuzeigen, die LINQ to SQL erzeugt. Diese Protokolllierungsfunktion (die Log verwendet), eignet sich für das Debugging. Sie stellt außerdem sicher, dass die an die Datenbank übergebenen Befehle Ihre Abfrage genau wiedergeben.

So erstellen Sie eine einfache Abfrage

  • Geben Sie den folgenden Code in die Sub Main-Methode nach der Table(Of Customer)-Deklaration ein, oder fügen Sie ihn ein:

    ' 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

Ausführen der Abfrage

In diesem Schritt führen Sie die Abfrage aus. Die in den vorherigen Schritten erstellten Abfrageausdrücke werden erst ausgewertet, wenn die Ergebnisse benötigt werden. Wenn Sie die For Each-Iteration beginnen, wird ein SQL-Befehl in der Datenbank ausgeführt, und Objekte werden erstellt.

So führen Sie die Abfrage aus

  1. Geben Sie den folgenden Code am Ende der Sub Main-Methode (nach der Abfragebeschreibung) ein, oder fügen Sie ihn ein:

    ' 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. Drücken Sie F5, um die Anwendung zu debuggen.

    Hinweis:

    Wenn die Anwendung einen Laufzeitfehler erzeugt, lesen Sie den Abschnitt zur Problembehandlung unter Lernen mit exemplarischen Vorgehensweisen (LINQ to SQL).

    Das Meldungsfeld zeigt eine Liste von sechs Kunden an. Das Konsolenfenster zeigt den generierten SQL-Code an.

  3. Klicken Sie auf OK, um das Meldungsfeld zu schließen.

    Die Anwendung wird geschlossen.

  4. Klicken Sie im Menü Datei auf Alle speichern.

    Sie benötigen diese Anwendung, wenn Sie mit der nächsten exemplarischen Vorgehensweise fortfahren.

Nächste Schritte

Das Exemplarische Vorgehensweise: Beziehungsübergreifende Abfragen (Visual Basic) (LINQ to SQL)-Thema schließt sich an diese exemplarische Vorgehensweise an. Die exemplarische Vorgehensweise zu beziehungsübergreifenden Abfragen zeigt, wie LINQ to SQL tabellenübergreifende Abfragen ausführt, ähnlich wie Verknüpfungen in einer relationalen Datenbank.

Wenn Sie die exemplarische Vorgehensweise zu beziehungsübergreifenden Abfragen absolvieren möchten, stellen Sie sicher, dass Sie die gerade erstellte Lösung speichern, da diese benötigt wird.

Siehe auch

Konzepte

Lernen mit exemplarischen Vorgehensweisen (LINQ to SQL)