Beispiel zur LINQ-Abfrageschnellansicht

Artikel
09/02/2008

Aktualisiert: November 2007

Die Abfrageschnellansicht ist eine Assembly, die in einer Visual Studio-Debugsitzung zur Darstellung von Datenbankabfragen verwendet werden kann. Das Projekt selbst ist lediglich eine Bibliothek und kann nicht ausgeführt werden. Wenn Sie es kompilieren, wird eine Bibliothek (DLL) generiert, die in Visual Studio verwendet werden kann, um die Möglichkeit zum Debuggen von LINQ to SQL-Anwendungen zu erweitern.

Hinweis:
Beim Debuggen von Anwendungen mit der Schnellansicht müssen Sie der Verbindungszeichenfolge möglicherweise Persist Security Info=true hinzufügen. Wenn der Debugger aktiviert ist, serialisiert er Informationen des Programms, das gedebuggt wird, und sendet sie an den Prozess, der die Schnellansicht anzeigt. Zu den serialisierten Informationen gehört die Verbindungszeichenfolge, die vom SqlConnection-Objekt abgerufen wird. Standardmäßig gibt das SqlConnection-Objekt nicht das Kennwort zurück, sodass die Verbindungszeichenfolge ohne das Kennwort serialisiert und an die Schnellansicht gesendet wird. Wenn Sie versuchen, die Abfrage in der Schnellansicht auszuführen, wird möglicherweise ein Fehler ausgegeben, da das Kennwort fehlt. Verwenden Sie diese Einstellung nur beim Debuggen. Zur Produktion sollten Sie diese Einstellung nach Möglichkeit nicht verwenden.

Beim Debuggen von Anwendungen mit der Schnellansicht müssen Sie der Verbindungszeichenfolge möglicherweise Persist Security Info=true hinzufügen. Wenn der Debugger aktiviert ist, serialisiert er Informationen des Programms, das gedebuggt wird, und sendet sie an den Prozess, der die Schnellansicht anzeigt. Zu den serialisierten Informationen gehört die Verbindungszeichenfolge, die vom SqlConnection-Objekt abgerufen wird. Standardmäßig gibt das SqlConnection-Objekt nicht das Kennwort zurück, sodass die Verbindungszeichenfolge ohne das Kennwort serialisiert und an die Schnellansicht gesendet wird. Wenn Sie versuchen, die Abfrage in der Schnellansicht auszuführen, wird möglicherweise ein Fehler ausgegeben, da das Kennwort fehlt. Verwenden Sie diese Einstellung nur beim Debuggen. Zur Produktion sollten Sie diese Einstellung nach Möglichkeit nicht verwenden.

So erhalten Sie Beispiele und Anweisungen zu ihrer Installation

Führen Sie eine oder mehrere der folgenden Aktionen aus:
- Klicken Sie im Menü Hilfe auf Samplings.
  
  In der Infodatei befinden sich Informationen zu Beispielen.
- Gehen Sie zur Website mit Visual Studio 2008-Beispielen. Hier stehen die aktuellsten Versionen der Beispiele bereit.
- Suchen Sie Beispiele auf dem Computer, auf dem Visual Studio installiert wurde. Standardmäßig werden Beispiele und eine Infodatei unter Laufwerk:\Programme\Microsoft Visual Studio 9.0\Beispiele\lcid installiert. Für die Express-Version von Visual Studio werden alle Beispiele online bereitgestellt.

Weitere Informationen finden Sie unter Suchen von Beispieldateien.

Sicherheitshinweis:
Dieser Beispielcode soll lediglich ein Konzept veranschaulichen. Es wird nur der für das jeweilige Konzept relevante Code dargestellt. Möglicherweise erfüllt dieser nicht die Sicherheitsanforderungen für eine bestimmte Umgebung, und er sollte nicht genau wie dargestellt verwendet werden. Wir empfehlen, Sicherheits- und Fehlerbehandlungscode hinzuzufügen, um Ihre Projekte sicherer und stabiler zu machen. Microsoft stellt diesen Beispielcode "wie besehen" und ohne Garantien zur Verfügung.

Dieser Beispielcode soll lediglich ein Konzept veranschaulichen. Es wird nur der für das jeweilige Konzept relevante Code dargestellt. Möglicherweise erfüllt dieser nicht die Sicherheitsanforderungen für eine bestimmte Umgebung, und er sollte nicht genau wie dargestellt verwendet werden. Wir empfehlen, Sicherheits- und Fehlerbehandlungscode hinzuzufügen, um Ihre Projekte sicherer und stabiler zu machen. Microsoft stellt diesen Beispielcode "wie besehen" und ohne Garantien zur Verfügung.

So führen Sie dieses Beispiel aus

Öffnen und erstellen Sie das Projekt Abfrageschnellansicht.
Kopieren Sie die DLL-Datei, die bei der Kompilierung generiert wird, aus dem BIN-Verzeichnis des Projekts in das Verzeichnis Visualizers, das sich standardmäßig in folgendem Pfad befindet: C:\Benutzer\Benutzername\Dokumente\Visual Studio 2008\Visualizers. Möglicherweise müssen Sie das Verzeichnis Visualizers erstellen. In Windows XP und früheren Versionen verwenden Sie anstelle des Verzeichnisses Dokumente das Verzeichnis Eigene Dateien. Sofern Sie über entsprechende Berechtigungen verfügen, können Sie die Datei auch in das folgende Verzeichnis kopieren: ...\Programme\Microsoft Visual Studio 9.0\Common7\Packages\Debugger\Visualizers.
Beenden und starten Sie Visual Studio falls nötig erneut, um sicherzustellen, dass die Schnellansicht erkannt wird.
Testen Sie die Schnellansicht in einem vorhandenen Beispielprojekt wie z. B. Beispielabfragen, oder erstellen Sie eine neue Konsolenanwendung, in der Sie die Schnellansicht testen. Führen Sie zum Erstellen einer neuen Anwendung die folgenden Schritte aus:
1. Erstellen Sie eine Standard-Konsolenanwendung.
2. Verwenden Sie den O/R-Designer, um eine Verbindung mit der Datenbank Northwind herzustellen, die sich im Verzeichnis Samples befindet.
3. Öffnen Sie das Dialogfeld Neues Element hinzufügen (STRG+UMSCHALT+A), und klicken Sie auf LINQ to SQL-Klassen.
4. Öffnen Sie den Server-Explorer, indem Sie STRG+W, L drücken.
5. Klicken Sie im Server-Explorer auf die Schaltfläche Mit Datenbank verbinden. Wählen Sie, falls nötig, Microsoft SQL Server-Datenbankdatei als Datenquelle aus. Suchen Sie die Datenbank Northwind.mdb im Verzeichnis Data, das mit den Beispielen bereitgestellt wird.
6. Ziehen Sie die Tabelle Customers auf die Designeroberfläche.
7. Schreiben Sie eine einfache Abfrage wie die folgende, und rufen Sie sie auf:
```
public void SimpleQuery()
{
    DataClasses1DataContext db = new DataClasses1DataContext();
    var query = from c in db.Customers
                select c;
    foreach (var item in query)
        Console.WriteLine(item.CompanyName);
}
```
8. Fügen Sie in der Zeile foreach einen Haltepunkt ein, bis zu dem Sie die Abfrage durchlaufen.
9. Bewegen Sie den Mauszeiger über die Abfrage des Variablennamens, und klicken Sie auf das angezeigte Lupensymbol.

Veranschaulicht

Die Abfrageschnellansicht ist ein hilfreiches Dienstprogramm, das im Debugger ausgeführt werden kann.

Hinweis:
Für viele LINQ-Beispiele sind XML-Dateien und/oder die Version der Northwind-Beispieldatenbank, die sich im Datenbeispiel befindet, erforderlich. Wenn Sie das Datenbeispiel im gleichen übergeordneten Ordner wie die anderen LINQ-Beispiele installieren, wird der Pfad für die XML-Dateien und die Datenbankdatei automatisch aufgelöst. Für viele Beispieldateien ist außerdem das Projekt Beispiel zum Objektdumper erforderlich.

Für viele LINQ-Beispiele sind XML-Dateien und/oder die Version der Northwind-Beispieldatenbank, die sich im Datenbeispiel befindet, erforderlich. Wenn Sie das Datenbeispiel im gleichen übergeordneten Ordner wie die anderen LINQ-Beispiele installieren, wird der Pfad für die XML-Dateien und die Datenbankdatei automatisch aufgelöst. Für viele Beispieldateien ist außerdem das Projekt Beispiel zum Objektdumper erforderlich.

Siehe auch

Weitere Ressourcen

Beispiele zu LINQ C#

Erste Schritte (LINQ to XML)

Freigeben über