Exemplarische Vorgehensweise: Einfaches Objektmodell und Abfrage (C#)

Artikel
06/05/2023

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 den objektrelationalen Designer verwenden, um das Objektmodell zu erstellen.

Hinweis

Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in den folgenden Anweisungen aufgeführten. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Personalisieren der IDE.

Diese exemplarische Vorgehensweise wurde mithilfe von Visual C#-Entwicklungseinstellungen geschrieben.

Voraussetzungen

Diese exemplarische Vorgehensweise verwendet einen dedizierten Ordner ("c:\linqtest5") 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 hierzu finden Sie unter Herunterladen von Beispieldatenbanken. Nachdem Sie die Datenbank heruntergeladen haben, kopieren Sie die Datei in den Ordner c:\linqtest5.

Übersicht

Diese exemplarische Vorgehensweise umfasst sechs Hauptaufgaben:

Erstellen einer LINQ to SQL-Projektmappe 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

Erstellen einer LINQ to SQL-Lösung

In dieser ersten Aufgabe erstellen Sie eine Visual Studio-Projektmappe, 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

Zeigen Sie in Visual Studio im Menü Datei auf Neu, und klicken Sie auf Projekt.
Klicken Sie im Bereich Projekttypen des Dialogfelds Neues Projekt auf Visual C#.
Klicken Sie im Bereich Vorlagen auf Konsolenanwendung.
Geben Sie im Feld Name die Zeichenfolge LinqConsoleApp ein.
Geben Sie im Feld Speicherort an, wo die Projektdateien gespeichert werden sollen.
Klicken Sie auf OK.

Hinzufügen von LINQ-Verweisen und Anweisungen

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 (erweitern Sie den Knoten Verweise im Projektmappen-Explorer), fügen Sie ihn wie nachfolgend beschrieben hinzu.

So fügen Sie System.Data.Linq hinzu

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise, und klicken Sie dann auf Verweis hinzufügen.
Klicken Sie im Dialogfeld Verweis hinzufügen auf .NET, auf die System.Data.Linq-Assembly und dann auf OK.

Dem Projekt wird die Assembly hinzugefügt.
Fügen Sie die folgenden Anweisungen am Anfang der Datei Program.cs hinzu.
```
using System.Data.Linq;
using System.Data.Linq.Mapping;
```

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 direkt oberhalb der Program-Klassendeklaration in Program.cs ein, oder fügen Sie ihn ein:
```
[Table(Name = "Customers")]
public class Customer
{
}
```

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 _CustomerID- und _City-Felder für den privaten Speicher fest. LINQ to SQL kann Werte dann direkt speichern und abrufen, statt öffentliche Zugriffsmethoden zu verwenden, die möglicherweise Geschäftslogik umfassen.

So stellen Sie Eigenschaften von zwei Datenbankspalten dar

Geben Sie den folgenden Code in die geschweiften Klammern der Customer-Klasse in Program.cs ein, oder fügen Sie ihn ein.

private string _CustomerID;
[Column(IsPrimaryKey=true, Storage="_CustomerID")]
public string CustomerID
{
    get
    {
        return this._CustomerID;
    }
    set
    {
        this._CustomerID = value;
    }
}

private string _City;
[Column(Storage="_City")]
public string City
{
    get
    {
        return this._City;
    }
    set
    {
        this._City=value;
    }
}

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<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 Main-Methode ein, oder fügen Sie ihn ein:

Beachten Sie, dass die Datei northwnd.mdf im Ordner linqtest5 angenommen wird. Weitere Informationen finden Sie im Abschnitt zu Voraussetzungen weiter oben in dieser exemplarischen Vorgehensweise.
```
// Use a connection string.
DataContext db = new DataContext
    (@"c:\linqtest5\northwnd.mdf");

// Get a typed table to run queries.
Table<Customer> Customers = db.GetTable<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 Introduction to LINQ queries (C#) (Einführung in LINQ-Abfragen (C#)).

Sie erzeugen auch eine Protokollausgabe, um die von LINQ to SQL erzeugten SQL-Befehle anzuzeigen. 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 Main-Methode nach der Table<Customer>-Deklaration ein, oder fügen Sie ihn ein:

// Attach the log to show generated SQL.
db.Log = Console.Out;

// Query for customers in London.
IQueryable<Customer> 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 foreach-Iteration beginnen, wird ein SQL-Befehl in der Datenbank ausgeführt, und Objekte werden erstellt.

So führen Sie die Abfrage aus

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

foreach (Customer cust in custQuery)
{
    Console.WriteLine("ID={0}, City={1}", cust.CustomerID,
        cust.City);
}

// Prevent console window from closing.
Console.ReadLine();

Drücken Sie F5, um die Anwendung zu debuggen.

Hinweis

Wenn die Anwendung einen Laufzeitfehler generiert, lesen Sie den Abschnitt zur Problembehandlung unter Lernen durch exemplarische Vorgehensweisen.

Die Abfrageergebnisse im Konsolenfenster werden wie folgt angezeigt:

ID=AROUT, City=London

ID=BSBEV, City=London

ID=CONSH, City=London

ID=EASTC, City=London

ID=NORTS, City=London

ID=SEVES, City=London
Drücken Sie die EINGABETASTE im Konsolenfenster, um die Anwendung zu schließen.

Nächste Schritte

Das Thema Exemplarische Vorgehensweise: Beziehungsübergreifendes Abfragen (C#) beginnt an der Stelle, an der diese exemplarische Vorgehensweise endet. Die exemplarische Vorgehensweise zu beziehungsübergreifenden Abfragen zeigt, wie LINQ to SQL tabellenübergreifende Abfragen ausführt, ähnlich wie Joins 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

Lernen durch exemplarische Vorgehensweisen