Exemplarische Vorgehensweise: Erstellen der Vision Clinic-Anwendung

  • Artikel

Diese exemplarische Vorgehensweise veranschaulicht den vollständigen Prozess zum Erstellen einer Anwendung in Visual Studio LightSwitch.Sie werden viele Funktionen von LightSwitch verwenden, um eine Anwendung für eine fiktive Augenklinik zu erstellen.Die Anwendung bietet Funktionen zum Planen von Terminen und Erstellen von Rechnungen.

Vorbereitungsmaßnahmen

Laden Sie die PrescriptionContoso-Datenbank von MSDN Code Gallery herunter.

Schritte

  • Erstellen eines Projekts

    Erstellen Sie das Anwendungsprojekt.

  • Definieren von Tabellen

    Fügen Sie Entitäten für Patienten, Rechnungen und Rechnungsdetails hinzu.

  • Erstellen einer Auswahlliste

    Erstellen Sie eine Liste mit Werten.

  • Definieren einer Beziehung

    Verknüpfen Sie verwandte Tabellen.

  • Hinzufügen einer weiteren Entität

    Fügen Sie die Appointment-Entität hinzu.

  • Bildschirm erstellen

    Erstellen Sie einen Bildschirm zum Anzeigen von Patienten.

  • Ausführen der Anwendung

    Führen Sie die Anwendung aus, und geben Sie Daten ein.

  • Herstellen einer Verbindung mit einer Datenbank

    Stellen Sie eine Verbindung mit einer externen Datenbank her.

  • Vornehmen von Änderungen an Entitäten

    Ändern Sie die Entitäten "Products" und "ProductRebate".

  • Erstellen eines Listen- und Detailbildschirms

    Erstellen Sie einen Bildschirm zum Anzeigen von Produkten.

  • Ändern des Bildschirmlayouts

    Ändern Sie das Layout des Bildschirms "Produktliste".

  • Vornehmen von Änderungen zur Laufzeit

    Nehmen Sie Änderungen in der laufenden Anwendung vor.

  • Erstellen einer Abfrage

    Erstellen Sie eine parametrisierte Abfrage, und binden Sie diese an einen Bildschirm.

  • Hinzufügen eines berechneten Felds

    Erstellen Sie ein berechnetes Feld, und fügen Sie es einem Bildschirm hinzu.

  • Erstellen einer datenbankübergreifenden Beziehung

    Erstellen Sie eine virtuelle Beziehung zwischen Entitäten in unterschiedlichen Datenbanken.

  • Erstellen des Bildschirms "Rechnungen"

    Erstellen Sie einen Bildschirm zum Anzeigen von Rechnungen.

  • Bearbeiten des Bildschirms "Rechnungen"

    Ändern Sie das Layout des Bildschirms "Rechnungen" in der laufenden Anwendung.

  • Hinzufügen von Bildschirmlogik

    Schreiben Sie Code, um Datumsangaben zu berechnen.

  • Hinzufügen weiterer berechneter Felder

    Erstellen Sie weitere berechnete Felder, und fügen Sie diese dem Bildschirm "Rechnungen" hinzu.

  • Bereitstellen der Anwendung

    Veröffentlichen Sie die Anwendung als Desktopanwendung mit zwei Ebenen.

Erstellen eines Projekts

Der erste Schritt beim Erstellen einer LightSwitch-Anwendung ist das Öffnen eines neuen Projekts.

So erstellen Sie ein Projekt

  1. Klicken Sie in Windows im Menü Start auf Visual Studio 2012.

    Der LightSwitch-Designer wird angezeigt.

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

    Das Dialogfeld Neues Projekt wird angezeigt.

  3. Wählen Sie in der Liste Installierte Vorlagen den Knoten LightSwitch aus.

  4. Wählen Sie im mittleren Bereich entweder LightSwitchAnwendung (VB) oder LightSwitchAnwendung (C#) aus.

  5. Geben Sie im Feld Name den Text "Augenklinik" ein, und klicken Sie dann auf OK.

    Das Fenster Augenklinik-Designer wird angezeigt, und im Fenster Projektmappen-Explorer werden dem Projekt alle benötigten Ordner hinzugefügt.

    Das Vision Clinic-Projekt

Definieren von Tabellen

In LightSwitch werden Tabellen als Entitäten bezeichnet. Damit wird das Objekt modelliert, das die Daten darstellen (in diesem Fall einen Patienten).LightSwitch-Anwendungen verwenden ein daten- und formularbasiertes Modell, d. h., die Formulare oder Bildschirme zeigen Daten aus einer oder mehreren Quellen an.LightSwitch enthält eine systeminterne Datenbank, die verwendet werden kann, um Daten für die Anwendung zu speichern.Im nächsten Schritt erstellen Sie eine Datenbanktabelle, um Patienteninformationen zu speichern.

So erstellen Sie die Patient-Entität

  1. Klicken Sie im Fenster Augenklinik-Designer auf Neue Tabelle erstellen.

    Der Daten-Designer wird angezeigt, und im Solution Explorer unter Datenquellen wird ein Knoten Table1Items angezeigt.

  2. Wählen Sie im Eigenschaftenfenster die Eigenschaft Name aus, geben Sie "Patient" ein, und drücken Sie die EINGABETASTE.

    Der Name in der Titelleiste des Daten-Designers ändert sich in "Patient", und der Name im Projektmappen-Explorer ändert sich in "Patienten".

  3. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, geben Sie "FirstName" ein, und drücken Sie dann die EINGABETASTE.

    Beachten Sie, dass der entsprechende Datentyp, String, in der Spalte Typ angezeigt wird und dass das Kontrollkästchen Erforderlich aktiviert ist.Ein Patient muss einen Namen haben.

  4. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, und geben Sie "LastName" ein.

  5. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, und geben Sie "Street" ein.

  6. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, und geben Sie "Street2" ein.

  7. Deaktivieren Sie das Kontrollkästchen in der Spalte Erforderlich.

    Die zweite Zeile einer Anschrift ist optional.

  8. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, und geben Sie "City" ein.

  9. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, und geben Sie "State" ein.

  10. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, und geben Sie "Zip" ein.

  11. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, und geben Sie "PrimaryPhone" ein.

  12. Wählen Sie in der Spalte Typ in der Dropdownliste die Option PhoneNumber aus.

    PhoneNumber ist ein benutzerdefinierter Geschäftstyp, der ein allgemeines Muster zur Eingabe und Formatierung von Telefonnummern darstellt.

  13. Deaktivieren Sie das Kontrollkästchen in der Spalte Erforderlich.

  14. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, und geben Sie "SecondaryPhone" ein.

  15. Wählen Sie in der Spalte Typ in der Dropdownliste die Option PhoneNumber aus.

  16. Deaktivieren Sie das Kontrollkästchen in der Spalte Erforderlich.

  17. Klicken Sie in der Spalte Name auf <Feld hinzufügen>, und geben Sie "Email" ein.

  18. Wählen Sie in der Spalte Typ in der Dropdownliste die Option EmailAddress aus.

    EmailAddress ist ein weiterer benutzerdefinierter Geschäftstyp, der eine ordnungsgemäß formatierte E-Mail-Adresse darstellt.

  19. Deaktivieren Sie das Kontrollkästchen in der Spalte Erforderlich.

  20. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, und geben Sie "PolicyNumber" ein.

  21. Wählen Sie im Eigenschaftenfenster die Eigenschaft Maximale Länge aus, und geben Sie 12 ein.

    Dies verhindert, dass Benutzer eine Richtliniennummer mit mehr als zwölf Zeichen eingeben.

    Die Patient-Entität

  22. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Als Nächstes erstellen Sie zwei weitere Entitäten, um eine Rechnung und Rechnungszeilen darzustellen.

So erstellen Sie die Invoice-Entität und die InvoiceDetail-Entität

  1. Klicken Sie im Projektmappen-Explorer auf Data Sources.Klicken Sie im Menü Projekt auf Tabelle hinzufügen.

    Eine neue Instanz des Daten-Designers wird angezeigt.

  2. Wählen Sie im Eigenschaftenfenster die Eigenschaft Name aus.Geben Sie "Invoice" ein, und drücken Sie dann die EINGABETASTE.

  3. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>.Geben Sie "InvoiceDate" ein, und drücken Sie dann die EINGABETASTE.

  4. Wählen Sie in der Spalte Typ in der Dropdownliste die Option DateTime aus.

  5. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>.Geben Sie "InvoiceDue" ein, und drücken Sie dann die EINGABETASTE.

  6. Wählen Sie in der Spalte Typ in der Dropdownliste die Option DateTime aus.

  7. Deaktivieren Sie das Kontrollkästchen in der Spalte Erforderlich.

  8. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>.Geben Sie "InvoiceStatus" ein, und drücken Sie dann die EINGABETASTE.

  9. Wählen Sie in der Spalte Typ in der Dropdownliste die Option Integer aus.

  10. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>.Geben Sie "ShipDate" ein, und drücken Sie anschließend die EINGABETASTE.

  11. Wählen Sie in der Spalte Typ in der Dropdownliste die Option DateTime aus.

    Die Invoice-Entität

  12. Klicken Sie im Projektmappen-Explorer auf Data Sources.Klicken Sie im Menü Projekt auf Tabelle hinzufügen.

  13. Wählen Sie im Eigenschaftenfenster die Eigenschaft Name aus, geben Sie "InvoiceDetail" ein, und drücken Sie die EINGABETASTE.

  14. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, geben Sie "Quantity" ein, und drücken Sie dann die EINGABETASTE.

  15. Wählen Sie in der Spalte Typ in der Dropdownliste die Option Integer aus.

  16. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, und geben Sie "UnitPrice" ein.

  17. Wählen Sie in der Spalte Typ in der Dropdownliste die Option Money aus.

    Money ist ein anderer benutzerdefinierter Geschäftstyp, der eine ordnungsgemäß formatierte Währung darstellt.

    Die InvoiceDetails-Entität

  18. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Erstellen einer Auswahlliste

Im nächsten Schritt erstellen Sie eine Auswahlliste für die Invoice-Entität.Eine Auswahlliste ermöglicht es Ihnen, den Benutzern einen festen Satz von Auswahlwerten bereitzustellen.

So erstellen Sie eine Auswahlliste

  1. Doppelklicken Sie im Projektmappen-Explorer auf Invoices.

  2. Wählen Sie im Daten-Designer das Feld InvoiceStatus aus.

  3. Klicken Sie im Eigenschaftenfenster auf den Link Auswahlliste.

    Das Dialogfeld für Auswahllisten

    Das Dialogfeld Auswahlliste wird angezeigt.

  4. Geben Sie im Dialogfeld Auswahlliste die folgenden Werte ein, und klicken Sie dann auf OK.

    Wert

    Angezeigter Name

    0

    Aktiv

    1

    Bezahlt

    2

    Überfällig

    Wenn dieses Feld in einem Bildschirm angezeigt wird, sieht der Benutzer eine Dropdownliste, in der die drei von Ihnen eingegebenen Werte für Anzeigename enthalten sind.

  5. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Definieren einer Beziehung

Im nächsten Schritt definieren Sie Beziehungen zwischen den Entitäten Patient, Invoice und InvoiceDetail.

So definieren Sie Beziehungen

  1. Doppelklicken Sie im Projektmappen-Explorer auf Invoices.

  2. Klicken Sie auf der Symbolleiste des Daten-Designers auf Beziehung.

    Das Dialogfeld Neue Beziehung hinzufügen wird angezeigt.

  3. Wählen Sie im Dialogfeld Neue Beziehung hinzufügen in der Zeile Name: die Spalte Zu aus.Wählen Sie Patient aus, und klicken Sie dann auf OK.

    Eine 1:n-Beziehung wird zwischen der Patient-Entität und der Invoice-Entität erstellt. Ein Patient kann mehrere Rechnungen aufweisen.

  4. Klicken Sie auf der Symbolleiste des Daten-Designers auf Beziehung.

    Das Dialogfeld Neue Beziehung hinzufügen wird angezeigt.

  5. Wählen Sie im Dialogfeld Neue Beziehung hinzufügen in der Zeile Name: die Spalte Zu aus, und wählen Sie dann InvoiceDetail aus.

  6. Wählen Sie in der Zeile Multiplizität: die Spalte Von aus, und wählen Sie dann den Wert Eins aus.

  7. Wählen Sie in der Zeile Multiplizität: die Spalte Zu und anschließend den Wert Viele aus. Klicken Sie dann auf OK.

    Eine 1:n-Beziehung wird zwischen der Invoice-Entität und der InvoiceDetail-Entität erstellt. Eine Rechnung kann mehrere Rechnungsdetails aufweisen.

    Die Beziehung zwischen Invoice und InvoiceDetail

  8. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Erstellen der Appointment-Entität

Im nächsten Schritt fügen Sie eine weitere Entität hinzu, um einen Termin darzustellen. Anschließend fügen Sie eine Beziehung und eine Auswahlliste hinzu.

So fügen Sie die Appointment-Entität hinzu

  1. Klicken Sie im Projektmappen-Explorer auf Data Sources, und klicken Sie dann im Menü Projekt auf Tabelle hinzufügen.

  2. Ändern Sie im Eigenschaftenfenster den Wert von Name in Termin.

  3. Klicken Sie im Daten-Designer in der Spalte Name auf <Eigenschaft hinzufügen>, und geben Sie AppointmentTime ein.

  4. Wählen Sie in der Spalte Typ in der Dropdownliste die Option DateTime aus.

  5. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, und geben Sie AppointmentType ein.

  6. Wählen Sie in der Spalte Typ in der Dropdownliste die Option Short Integer aus.

  7. Klicken Sie in der Spalte Name auf <Eigenschaft hinzufügen>, und geben Sie DoctorNotes ein.

  8. Übernehmen Sie den Standardtyp Zeichenfolge, und deaktivieren Sie das Kontrollkästchen Erforderlich.

  9. Klicken Sie auf der Symbolleiste des Daten-Designers auf Beziehung.

  10. Wählen Sie im Dialogfeld Neue Beziehung hinzufügen in der Zeile Name: die Spalte Zu aus.Wählen Sie Patient aus, und klicken Sie dann auf OK.

    Eine 1:n-Beziehung wird zwischen der Patient-Entität und der Appointment-Entität erstellt. Ein Patient kann mehrere Termine haben.

  11. Wählen Sie im Daten-Designer das Feld AppointmentType aus.

  12. Klicken Sie im Eigenschaftenfenster auf den Link Auswahlliste.

    Das Dialogfeld Auswahlliste wird angezeigt.

  13. Geben Sie im Dialogfeld Auswahlliste die folgenden Werte ein, und klicken Sie dann auf OK.

    Wert

    Angezeigter Name

    0

    Jährlich

    1

    Weiterverfolgen

    2

    Notfall

    Die Appointment-Entität

  14. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Bildschirm erstellen

Im nächsten Schritt erstellen Sie einen Bildschirm, um eine Liste von Patienten anzuzeigen.

So erstellen Sie einen Bildschirm

  1. Klicken Sie im Projektmappen-Explorer auf den Knoten Bildschirme, und klicken Sie anschließend im Menü Projekt auf Bildschirm hinzufügen.

    Das Dialogfeld Neuen Bildschirm hinzufügen wird geöffnet.

  2. Wählen Sie in der Liste Bildschirmvorlage auswählen die Option Bearbeitbarer Rasterbildschirm aus.

  3. Geben Sie im Textfeld Bildschirmname den Wert PatientList ein.

  4. Wählen Sie die Dropdownliste Bildschirmdaten und dann Patienten aus.Klicken Sie auf OK.

    Definieren des PatientList-Bildschirms

    Der Bildschirm-Designer wird geöffnet und zeigt eine hierarchische Darstellung des Bildschirmlayouts an.

  5. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Ausführen der Anwendung und Eingeben von Daten

Sie verfügen jetzt über eine funktionierende Anwendung.Im nächsten Schritt führen Sie die Anwendung aus und geben einige Daten ein.

So führen Sie die Anwendung aus

  1. Drücken Sie F5, um die Anwendung zu starten.

  2. Wählen Sie in der ausgeführten Anwendung den Bildschirm PatientList aus, und klicken Sie dann auf die Schaltfläche +….

    Ein Dialogfeld Neuen Patienten hinzufügen wird angezeigt.

  3. Geben Sie Daten für einen neuen Patienten ein.Geben Sie im Feld E-Mail einen ungültigen Wert ein, z. B. john#example.com.

    Ungültige E-Mail-Adresse

    Wenn Sie den Cursor aus dem Feld bewegen, wird ein roter Rahmen angezeigt.Der Geschäftstyp EmailAddress verfügt über integrierte Validierungsregeln, die eine falsch formatierte E-Mail-Adresse erkennen können.

  4. Beheben Sie den Fehler, beenden Sie die Dateneingabe, und klicken Sie dann auf OK.

    Die Schaltfläche Speichern auf der Anwendungssymbolleiste ist jetzt aktiviert.

  5. Klicken Sie auf die Schaltfläche +....Fügen Sie Daten für einen zweiten Patienten hinzu, und klicken Sie dann auf OK.

  6. Klicken Sie auf Speichern, um die Daten zu speichern.

    Sie können jetzt die Spalten im Raster PatientList neu anordnen und nach jeder Spalte sortieren.

  7. Klicken Sie in der rechten oberen Ecke der ausgeführten Anwendung auf die Schaltfläche Schließen, um zurück in den Entwurfsmodus zu wechseln.

  8. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Herstellen einer Verbindung mit einer Datenbank

Im nächsten Schritt stellen Sie eine Verbindung mit einer externen Datenbank her, die Produktinformationen enthält.

HinweisHinweis

Vor dem Ausführen dieses Schritts müssen Sie die Datenbank PrescriptionContoso herunterladen und installieren.Die Datenbank kann von MSDN Code Gallery heruntergeladen werden.Folgen Sie den Anweisungen in der Datei "Install.htm", um die Datenbank zu installieren.

So fügen Sie eine Datenquelle an

  1. Wählen Sie im Projektmappen-Explorer den Knoten Datenquellen aus.

  2. Klicken Sie im Menü Projekt auf Datenquelle hinzufügen.

    Der Assistent zum Hinzufügen von Datenquellen wird geöffnet.

  3. Klicken Sie im Assistenten zum Hinzufügen von Datenquellen auf Datenbank und dann auf Weiter.

    Das Dialogfeld Datenquelle auswählen wird angezeigt.

    HinweisHinweis

    Wenn Sie zuvor in LightSwitch eine Verbindung mit einer Datenbank hergestellt haben, wird dieses Dialogfeld nicht angezeigt, und Sie können den nächsten Schritt überspringen.

  4. Klicken Sie im Dialogfeld Datenquelle auswählen auf Microsoft SQL Server (SQL Client), und klicken Sie dann auf Weiter.

    Das Dialogfeld Verbindungseigenschaften wird angezeigt.

  5. Geben Sie im Dialogfeld Verbindungseigenschaften die Werte in der folgenden Tabelle ein, und klicken Sie dann auf OK.

    Feld

    Wert

    Servername

    (localdb)\v11.0

    Anmelden am Server

    Verwenden Sie die Windows-Authentifizierung.

    Auswählen oder Eingeben eines Datenbanknamens

    C:\Temp\PrescriptionContoso.mdf

    Verbindungseigenschaften

    Die Assistentenseite Datenbankobjekte auswählen wird angezeigt.

  6. Erweitern Sie den Knoten Tabellen.

  7. Wählen Sie die Tabellen Product und ProductRebate aus, und klicken Sie dann auf Fertig stellen.

    Dem Projekt wird die Datenquelle C_TEMP_PRESCRIPTIONCONTOSO_MDFData hinzugefügt, und für Products und ProductRebates werden Entitäten erstellt.

  8. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf C_TEMP_PRESCRIPTIONCONTOSO_MDFData, klicken Sie auf Umbenennen, und geben Sie dann PrescriptionContoso ein.

  9. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Ändern der Entitäten "Products" und "ProductRebate"

Im nächsten Schritt nehmen Sie in der laufenden Anwendung einige Änderungen an den Entitäten "ProductRebate" und "Products" vor.

So bearbeiten Sie die Entitäten "ProductRebate" und "Products"

  1. Doppelklicken Sie im Projektmappen-Explorer auf den Knoten ProductRebates.

  2. Wählen Sie das Feld Rebate aus, und ändern Sie den Typ in Money.

  3. Doppelklicken Sie im Projektmappen-Explorer auf den Knoten Products.

  4. Wählen Sie im Daten-Designer das Feld MSRP aus, und ändern Sie den Typ in Money.

  5. Wählen Sie das Feld ProductImage aus, und ändern Sie den Typ in Image.

  6. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Erstellen eines Listen- und Detailbildschirms

Im nächsten Schritt erstellen Sie einen Bildschirm, in dem Produktinformationen angezeigt werden.

So erstellen Sie einen Listen- und Detailbildschirm

  1. Wählen Sie im Projektmappen-Explorer den Knoten Bildschirme aus.Klicken Sie im Menü Projekt auf Bildschirm hinzufügen.

  2. Wählen Sie im Dialogfeld Neuen Bildschirm hinzufügen in der Liste Bildschirmvorlage auswählen den Eintrag Listen- und Detailbildschirm aus.

  3. Geben Sie im Feld Bildschirmname: den Namen ProductList ein.

  4. Wählen Sie die Dropdownliste Bildschirmdaten und dann PrescriptionContoso.Products aus.

  5. Aktivieren Sie in der Liste Zusätzliche einzuschließende Daten das Kontrollkästchen Produktdetails und das Kontrollkästchen Produkt ProductRebates, und klicken Sie dann auf OK.

Ändern des Bildschirmlayouts

Im nächsten Schritt ändern Sie das Layout des Bildschirms ProductList.

So passen Sie das Layout an

  1. Wählen Sie im Bildschirm-Designer in der Struktur der Bildschirminhalte den Knoten Zeilenlayout | Produktdetails aus.

  2. Wählen Sie in der Dropdownliste Zeilenlayout den Eintrag Bild und Text aus.

  3. Wählen Sie die folgenden Werte aus der Dropdownliste für jedes Feld unter dem Knoten Bild und Text aus:

    Feld

    Wert

    (BILD)

    Produktbild

    (TITEL)

    Produktname

    (UNTERTITEL)

    MSRP

    (BESCHREIBUNG)

    Beschreibung

    Bild- und Textlayout

  4. Drücken Sie F5, um die Anwendung auszuführen und die Ergebnisse anzuzeigen.

  5. Klicken Sie in der laufenden Anwendung auf das Menü ProductList, um den Bildschirm anzuzeigen.

    Lassen Sie die Anwendung geöffnet.Im nächsten Schritt nehmen Sie Änderungen an der laufenden Anwendung vor.

Vornehmen von Änderungen in der laufenden Anwendung

Im nächsten Schritt bearbeiten Sie den Bildschirm Produktliste, während die Anwendung ausgeführt wird.

So passen Sie einen Bildschirm zur Laufzeit an

  1. Klicken Sie im Bildschirm Produktliste klicken Sie auf die Schaltfläche Bildschirm entwerfen in der rechten unteren Ecke.

  2. Wählen Sie im linken Bereich den Knoten Datenraster | Produktrabatte aus.

  3. Ändern Sie im Eigenschaftenfenster den Wert der Eigenschaft Anzeigename in Contoso-Rabatte.

    Der Name ändert sich auch im Anwendungsfenster.

  4. Wählen Sie das Feld MSRP aus, und ändern Sie die Eigenschaft Beschreibung in Empfohlener Preis vor allen Rabatten.

    Anpassung der Entwurfszeit

  5. Klicken Sie auf die Schaltfläche Speichern, um zur laufenden Anwendung zurückzukehren und die Änderungen anzuzeigen.Bewegen Sie den Mauszeiger über das Feld MSRP, um die Beschreibung anzuzeigen.

  6. Klicken Sie in der rechten oberen Ecke der ausgeführten Anwendung auf die Schaltfläche Schließen, um zurück in den Entwurfsmodus zu wechseln.

  7. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Erstellen einer Abfrage

Im nächsten Schritt erstellen Sie eine parametrisierte Abfrage und binden diese an einen Bildschirm.

So erstellen Sie eine parametrisierte Abfrage

  1. Wählen Sie im Projektmappen-Explorer den Knoten Products aus.Klicken Sie im Menü Projekt auf Abfrage hinzufügen.

    Der Abfrage-Designer wird angezeigt.

  2. Wählen Sie im Eigenschaftenfenster das Feld Name aus, und geben Sie RelatedProducts ein.

  3. Klicken Sie im Abfrage-Designer auf Filter hinzufügen.

    Dem Abschnitt Filter wird eine Filterbedingung hinzugefügt.

  4. Wählen Sie in der zweiten Dropdownliste Category aus.

  5. Wählen Sie in der vierten Dropdownliste die Option Parameter aus.

  6. Klicken Sie in der fünften Dropdownliste auf Neue hinzufügen.

    Ein neuer Parameter mit dem Namen Category und dem Typ String wird dem Abschnitt Parameter hinzugefügt.

    Die RelatedProducts-Abfrage

  7. Doppelklicken Sie im Projektmappen-Explorer auf den Knoten ProductList, um den Bildschirm-Designer zu öffnen.

  8. Klicken Sie auf der Symbolleiste des Bildschirm-Designers auf Datenelement hinzufügen.

    Das Dialogfeld Datenelement hinzufügen wird angezeigt.

  9. Klicken Sie im Dialogfeld Datenelement hinzufügen auf die Option Abfrage.Wählen Sie in der Spalte Name den Eintrag PrescriptionContoso.RelatedProducts aus, und klicken Sie dann auf OK.

    Ein Knoten RelatedProducts wird im linken Bereich angezeigt.

  10. Wählen Sie unter dem Knoten Abfrageparameter den Knoten Kategorie aus.

  11. Wählen Sie im Eigenschaftenfenster die Eigenschaft Parameterbindung aus, und geben Sie Products.SelectedItem.Category ein.

  12. Erweitern Sie im mittleren Bereich den Knoten Hinzufügen unter dem Knoten DataGrid | Contoso-Rabatte, und klicken Sie auf Verwandte Produkte.

    Hinzufügen von verwandten Produkten

  13. Drücken Sie F5, um die Anwendung auszuführen und die Ergebnisse anzuzeigen.

    Öffnen Sie den Bildschirm Produktliste. Für jedes ausgewählte Produkt wird eine Liste mit zugehörigen Produkten angezeigt.

  14. Klicken Sie in der rechten oberen Ecke der ausgeführten Anwendung auf die Schaltfläche Schließen, um zurück in den Entwurfsmodus zu wechseln.

  15. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Hinzufügen eines berechneten Felds

Im nächsten Schritt fügen Sie ein Feld hinzu, das einen berechneten Wert verwendet.Der berechnete Wert ist der Preis eines Produkts, nachdem ein Preisnachlass angewendet wurde.

So fügen Sie ein berechnetes Feld hinzu

  1. Doppelklicken Sie im Projektmappen-Explorer auf den Entitätsknoten Products.

  2. Klicken Sie im Daten-Designer auf <Eigenschaft hinzufügen>.Geben Sie CurrentPrice ein, und klicken Sie dann auf Tab.

  3. Wählen Sie in der Spalte Typ in der Dropdownliste die Option Money aus.

    Im Eigenschaftenfenster unter Allgemeine Eigenschaften ist die Eigenschaft Ist berechnet standardmäßig aktiviert.

  4. Klicken Sie im Eigenschaftenfenster auf den Link Methode bearbeiten.

    Der Code-Editor wird geöffnet und zeigt die CurrentPrice_Compute-Methode an.

  5. Fügen Sie dem Ereignishandler folgenden Code hinzu:

    Dim rebates As Decimal
    For Each item In ProductRebates
        If item.RebateStart <= Date.Today And item.RebateEnd >= Date.Today Then
            rebates = rebates + item.Rebate
        End If
    Next

    result = Me.MSRP - rebates

    decimal rebates = default(decimal);


            foreach (var item in ProductRebates)
            {
                if (item.RebateStart <= System.DateTime.Today && item.RebateEnd >= System.DateTime.Today)
                {
                    rebates += item.Rebate.Value;
                }
            }

            result = this.MSRP - rebates;

    Code zur Berechnung des aktuellen Preises

  6. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Im nächsten Schritt fügen Sie das berechnete Feld dem Bildschirm "ProductList" hinzu.

So fügen Sie ein berechnetes Feld einem Bildschirm hinzu

  1. Doppelklicken Sie im Projektmappen-Explorer auf den Bildschirmknoten ProductList.

  2. Wählen Sie im linken Bereich des Bildschirm-Designers den Knoten CurrentPrice aus, und ziehen Sie ihn im mittleren Bereich unter den Knoten (Beschreibung) | Beschreibung.

    Aktueller Preis nach Drag & Drop

  3. Drücken Sie F5, um die Anwendung auszuführen und die Ergebnisse anzuzeigen.

  4. Bearbeiten Sie im Bildschirm ProductList das Feld Rebate oder MSRP.CurrentPrice wird neu berechnet.Klicken Sie auf die Schaltfläche Schließen, um zum Entwurfsmodus zurückzukehren.

  5. Klicken Sie in der rechten oberen Ecke der ausgeführten Anwendung auf die Schaltfläche Schließen, um zurück in den Entwurfsmodus zu wechseln.

  6. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Erstellen einer datenbankübergreifenden Beziehung

Im nächsten Schritt erstellen Sie eine virtuelle Beziehung zwischen Entitäten in zwei verschiedenen Datenbanken und zeigen Daten aus zwei unterschiedlichen Quellen auf einem einzelnen Listen- und Detailbildschirm an.

So erstellen Sie eine datenbankübergreifende Beziehung

  1. Doppelklicken Sie im Projektmappen-Explorer auf den Entitätsknoten InvoiceDetails.

  2. Klicken Sie auf der Symbolleiste des Daten-Designers auf die Schaltfläche Beziehung.

  3. Wählen Sie im Dialogfeld Neue Beziehung hinzufügen das Feld Name in der Spalte Zu aus, und wählen Sie dann Produkt aus.

    Ein neuer Abschnitt wird am unteren Rand des Dialogfelds angezeigt.Darin werden die verwandten Felder in beiden Entitäten angezeigt.Falls notwendig, können Sie die verwandten Felder in ein anderes Feld desselben Datentyps ändern oder mehrere verwandte Felder als Schlüssel definieren.

    Eine datenbankübergreifende Beziehung

  4. Klicken Sie auf OK, um die Beziehung zu speichern.

    Die neue Beziehung wird als gepunktete Linie im Designer angezeigt.Gibt an, dass sich die Entitäten in unterschiedlichen Datenquellen befinden, in diesem Fall InvoiceDetails in der systeminternen Datenbank und Products in der Datenbank PrescriptionContoso.

  5. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Erstellen eines Bildschirms zum Anzeigen von Rechnungen

Im nächsten Schritt erstellen Sie einen neuen Bildschirm zum Anzeigen von Rechnungen.

So erstellen Sie einen Bildschirm

  1. Wählen Sie im Projektmappen-Explorer den Knoten Bildschirme aus.Klicken Sie im Menü Projekt auf Bildschirm hinzufügen.

  2. Wählen Sie im Dialogfeld Neuen Bildschirm hinzufügen in der Liste Bildschirmvorlage auswählen den Eintrag Listen- und Detailbildschirm aus.

  3. Geben Sie im Textfeld Bildschirmname: den Wert InvoiceScreen ein.

  4. Wählen Sie die Dropdownliste Bildschirmdaten und dann Rechnungen aus.

  5. Wählen Sie in der Liste Zusätzliche einzuschließende Daten sowohl Rechnungsdetails als auch Rechnung InvoiceDetails aus, und klicken Sie dann auf OK.

    Das InvoiceScreen-Layout

  6. Erweitern Sie den Knoten Datenrasterzeile | Rechnungsdetail.Wählen Sie den Knoten Produkt Produkt-ID aus, und löschen Sie ihn.

  7. Um die Felder neu anzuordnen, klicken Sie auf den Knoten UnitPrice, und ziehen Sie ihn unter den Knoten Produkt.

  8. Drücken Sie F5, um die Anwendung auszuführen.Klicken Sie im Menü auf Rechnungsbildschirm, um den Bildschirm anzuzeigen.

  9. Klicken Sie im Bereich Invoices auf die Schaltfläche +....

    Geben Sie einige Rechnungsdaten ein.Beachten Sie, wie im Feld InvoiceStatus eine Dropdownliste mit Werten bereitgestellt wird. Das Feld Patient enthält eine Schaltfläche, die ein Dialogfeld mit einer Liste von Patienten öffnet.

  10. Klicken Sie im Bereich Rechnungsdetails auf die Schaltfläche +....

    Geben Sie einige Rechnungsdetaildaten ein.Beachten Sie, wie im Feld Produkt eine Dropdownliste mit Produkten aus der Datenbank PrescriptionContoso bereitgestellt wird.

  11. Klicken Sie auf die Schaltfläche Speichern, um die Rechnungsdaten zu speichern.

  12. Lassen Sie die Anwendung geöffnet.Im nächsten Schritt nehmen Sie Änderungen an der laufenden Anwendung vor.

Bearbeiten des Bildschirms "Rechnungen"

Im nächsten Schritt nehmen Sie in der laufenden Anwendung einige Änderungen am Bildschirm "Rechnungen" vor.

So passen Sie einen Bildschirm in der laufenden Anwendung an

  1. Klicken Sie auf dem Rechnungsbildschirm in der oberen rechten Ecke auf die Schaltfläche Bildschirm entwerfen.

  2. Wählen Sie im linken Bereich den Knoten Listen | Rechnungen aus.Wählen Sie in der Dropdownliste Liste den Eintrag DataGrid aus.

  3. Wählen Sie den Knoten Patient aus.Verwenden Sie den Pfeil MoveUp am linken Rand, um ihn über dem Knoten Rechnungsdatum zu platzieren.

    Der angepasste Rechnungsbildschirm

  4. Klicken Sie auf Speichern, um zur laufenden Anwendung zurückzukehren und die Änderungen anzuzeigen.

  5. Klicken Sie in der rechten oberen Ecke der ausgeführten Anwendung auf die Schaltfläche Schließen, um zurück in den Entwurfsmodus zu wechseln.

  6. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Definieren von Bildschirmlogik

Im nächsten Schritt fügen Sie Code hinzu, mit dem die Standardlogik für Rechnungsdaten definiert wird.

So definieren Sie Bildschirmlogik

  1. Doppelklicken Sie im Projektmappen-Explorer auf den Entitätsknoten Invoices.

  2. Klicken Sie im Daten-Designer auf der Symbolleiste auf die Dropdownliste Code schreiben.Klicken Sie auf den Link Invoice_Created.

    Der Code-Editor wird geöffnet und zeigt die Invoice_Created-Methode an.

  3. Fügen Sie in der Invoice_Created-Methode folgenden Code hinzu, um das Standardverhalten für Datumsangaben festzulegen:

    InvoiceDate = Date.Today
InvoiceDue = Date.Today.AddDays(30)
ShipDate = Date.Today.AddDays(3)

    InvoiceDate = System.DateTime.Today;
InvoiceDue = System.DateTime.Today.AddDays(30);
ShipDate = System.DateTime.Today.AddDays(3);

  4. Doppelklicken Sie im Projektmappen-Explorer auf den Entitätsknoten Invoices.

  5. Wählen Sie im Daten-Designer das Feld InvoiceDate aus.

  6. Klicken auf der Symbolleiste auf die Dropdownliste Code schreiben, und klicken Sie dann auf den Link InvoiceDate_Changed

  7. Fügen Sie in der InvoiceDate_Changed-Methode den folgenden Code hinzu, um Datumsangaben zu aktualisieren, wenn sich "InvoiceDate" ändert:

    InvoiceDue = InvoiceDate.AddDays(30)
‘ If the ShipDate is earlier than the new InvoiceDate, update it.
If ShipDate < InvoiceDate Then
    ShipDate = InvoiceDate.AddDays(2)
End If

    InvoiceDue = InvoiceDate.AddDays(30); 
    // If the ShipDate is earlier than the new InvoiceDate, update it
if (ShipDate < InvoiceDate)
    {
        ShipDate = InvoiceDate.AddDays(2);
    }

  8. Doppelklicken Sie im Projektmappen-Explorer auf den Knoten InvoiceDetails.

  9. Wählen Sie im Daten-Designer das Feld Produkt aus, klicken Sie auf der Symbolleiste auf die Dropdownliste Code schreiben, und klicken Sie dann auf den Link Product_Changed.

  10. Fügen Sie im Code-Editor den folgenden Code hinzu, um den Einzelpreis und die Standardmenge festzulegen:

    UnitPrice = Product.CurrentPrice
Quantity = 1

    UnitPrice = Product.CurrentPrice;

Quantity = 1;

  11. Drücken Sie F5, um die Anwendung auszuführen und die Änderungen anzuzeigen.

    Öffnen Sie den Bildschirm Rechnung, und fügen Sie eine neue Rechnung hinzu.Die Datumsfelder, der Preis und die Menge werden jetzt automatisch aktualisiert.

  12. Klicken Sie auf die Schaltfläche Speichern, um die Änderungen zu speichern.

  13. Klicken Sie in der rechten oberen Ecke der ausgeführten Anwendung auf die Schaltfläche Schließen, um zurück in den Entwurfsmodus zu wechseln.

  14. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Hinzufügen weiterer berechneter Felder

Im nächsten Schritt fügen Sie den Entitäten InvoiceDetails und Invoices berechnete Felder für "SubTotal", "Tax" und "Totals" hinzu.

So fügen Sie berechnete Felder hinzu

  1. Doppelklicken Sie im Projektmappen-Explorer auf den Entitätsknoten InvoiceDetails.

  2. Klicken Sie im Daten-Designer auf <Eigenschaft hinzufügen>, geben Sie SubTotal ein, und klicken Sie dann auf Tab.

  3. Wählen Sie in der Spalte Typ in der Dropdownliste die Option Money aus.

  4. Aktivieren Sie im Eigenschaftenfenster unter Allgemeine Eigenschaften das Kontrollkästchen IsComputed.

  5. Klicken Sie auf den Link Methode bearbeiten.

    Der Code-Editor wird mit der SubTotal_Compute-Methode geöffnet.

  6. Fügen Sie zum Berechnen von SubTotal den folgenden Code hinzu:

    result = Quantity * UnitPrice

    result = Quantity * UnitPrice;

  7. Doppelklicken Sie im Projektmappen-Explorer auf den Entitätsknoten Invoices.

  8. Klicken Sie im Daten-Designer auf <Eigenschaft hinzufügen>, geben Sie Tax ein, und klicken Sie dann auf Tab.

  9. Wählen Sie in der Spalte Typ in der Dropdownliste die Option Money aus.

  10. Aktivieren Sie im Eigenschaftenfenster das Kontrollkästchen IsComputed.

  11. Klicken Sie auf den Link Methode bearbeiten.

    Der Code-Editor wird geöffnet und zeigt die Tax_Compute-Methode an.

  12. Ersetzen Sie die Tax_Compute-Methode durch den folgenden Code, um Tax zu berechnen:

    Private Sub Tax_Compute(ByRef result As Decimal)
    Result =  GetSubTotal() * 0.095
End Sub
Protected Function GetSubTotal() As Decimal
    GetSubtotal = 0
    For Each item In InvoiceDetails
        GetSubTotal = GetSubTotal + item.SubTotal
    Next
End Function

    partial void Tax_Compute(ref decimal result)
    {
        result = GetSubTotal() * (decimal)0.095;
    }
protected decimal GetSubTotal()
    {
        return this.InvoiceDetails.Sum(i => i.SubTotal);
    }

  13. Doppelklicken Sie im Projektmappen-Explorer auf den Entitätsknoten Invoices.

  14. Klicken Sie im Daten-Designer auf <Eigenschaft hinzufügen>.Geben Sie Total ein, und klicken Sie dann auf Tab.

  15. Wählen Sie in der Spalte Typ in der Dropdownliste die Option Money aus.

  16. Aktivieren Sie im Eigenschaftenfenster das Kontrollkästchen IsComputed.

  17. Klicken Sie auf den Link Methode bearbeiten.

    Der Code-Editor wird geöffnet und zeigt die Total_Compute-Methode an.

  18. Fügen Sie zum Berechnen von Tax den folgenden Code hinzu:

    result = GetSubTotal() + Tax

    result = GetSubTotal() + Tax;

  19. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Im nächsten Schritt fügen Sie dem Bildschirm Rechnungen neue Felder hinzu.

So fügen Sie einem Bildschirm Felder hinzu

  1. Doppelklicken Sie im Projektmappen-Explorer auf den Bildschirmknoten InvoiceScreen.

  2. Wählen und erweitern Sie im mittleren Bereich den Knoten Zeilenlayout | Rechnungsdetails.

  3. Wählen und erweitern Sie die Dropdownliste Hinzufügen, und wählen Sie Tax aus.

    Dem Abschnitt Vertikaler Stapel | InvoiceDetails wird das Feld Tax hinzugefügt.

  4. Wählen und erweitern Sie erneut die Dropdownliste Hinzufügen, und wählen Sie Total aus.

  5. Drücken Sie F5, um die Anwendung auszuführen und die Ergebnisse anzuzeigen.

    Öffnen Sie den Rechnungsbildschirm.Die Felder Tax und Total werden jetzt für jede Rechnungszeile angezeigt.

  6. Klicken Sie auf die Schaltfläche Bildschirm entwerfen, um den Anpassungsmodus zu ändern.

  7. Wählen Sie im linken Bereich den Knoten Datenrasterzeile | Rechnungsdetail aus, und erweitern Sie ihn.

  8. Klicken Sie auf die Dropdownliste Hinzufügen, und wählen Sie SubTotal aus.

  9. Klicken Sie zum Speichern der Änderung auf Speichern.Ein Feld SubTotal wird jetzt im Raster Rechnungsdetails angezeigt.

    Der aktualisierte Rechnungsbildschirm

  10. Klicken Sie in der rechten oberen Ecke der ausgeführten Anwendung auf die Schaltfläche Schließen, um zurück in den Entwurfsmodus zu wechseln.

  11. Klicken Sie im Menü Datei auf Alle speichern, um die Arbeit zu speichern.

Bereitstellen der Anwendung

Im nächsten Schritt stellen Sie die Anwendung als Desktopanwendung mit zwei Ebenen bereit.

So veröffentlichen Sie eine Desktopanwendung mit zwei Ebenen

  1. Wählen Sie im Projektmappen-Explorer den Knoten Augenklinik aus, und klicken Sie dann im Menü Erstellen auf Augenklinik veröffentlichen.

    Der Assistent zum Veröffentlichen von LightSwitch-Anwendungen wird angezeigt.

  2. Stellen Sie auf der Seite Willkommen beim LightSwitch-Veröffentlichungs-Assistenten sicher, dass die Option Desktop aktiviert ist, und klicken Sie dann auf Weiter.

  3. Stellen Sie auf der Seite Anwendungsdienste sicher, dass Lokal ausgewählt ist, und klicken Sie dann auf Weiter.

  4. Wählen Sie auf der Seite Veröffentlichungseinstellung angeben das Feld Wo sollen die Anwendungsdateien gespeichert werden? aus, und geben Sie C:\Publish ein.

  5. Klicken Sie im Abschnitt Wie möchten Sie die Standarddatenbank veröffentlichen? auf Jetzt direkt in der Datenbank veröffentlichen und dann auf Weiter.

  6. Übernehmen Sie auf der Seite LightSwitch-Anwendungsdatenbank – SQL-Datenbankverbindung die Standardverbindungszeichenfolgen, und klicken Sie dann auf Weiter.

  7. Übernehmen Sie auf der Seite Erforderliche Komponenten installieren die Standardeinstellungen, und klicken Sie auf Weiter.

  8. Übernehmen Sie auf der Seite Andere Verbindungsinformationen die Standardeinstellungen, und klicken Sie auf Veröffentlichen.

  9. Greifen Sie im Datei-Explorer auf das Verzeichnis C:\Publish zu, und doppelklicken Sie auf die Datei Setup.exe, um die Anwendung auf dem lokalen Computer zu installieren.

    HinweisHinweis

    Um die Anwendung auf einem anderen Computer zu installieren, kopieren Sie den Inhalt des Ordners "Publish" und all seiner Unterordner.Vor dem Installieren müssen Sie die Schritte ausführen, die in der Datei "Install.htm" beschrieben werden. Die Datei befindet sich im Ordner "Publish".

  10. Wenn das Dialogfeld Anwendungsinstallation – Sicherheitswarnung angezeigt wird, klicken Sie auf Installieren.

    Die Anwendung Augenklinik wird installiert und gestartet.

    Die fertig gestellte Anwendung

  11. Geben Sie einige Daten ein, und überprüfen Sie, ob die Anwendung wie erwartet funktioniert.

    TippTipp

    Wenn Sie die Anwendung Augenklinik erneut ausführen möchten, können Sie sie über das Menü Start öffnen.

Damit ist die exemplarische Vorgehensweise für die Anwendung Augenklinik abgeschlossen.Sie sollten jetzt über ein grundlegendes Verständnis des gesamten Erstellungsprozesses für eine LightSwitch-Anwendung verfügen.

Diese exemplarische Vorgehensweise hat die grundlegenden Funktionen von LightSwitch veranschaulicht. Es gibt jedoch noch eine Vielzahl weiterer Funktionen, die von LightSwitch bereitgestellt werden.Wenn Sie erst einmal beginnen, eigene Anwendungen zu erstellen, können Sie mehr über weitere Funktionen in der Produktdokumentation erfahren.

Siehe auch

Konzepte

Einführung in LightSwitch

Visual Studio LightSwitch

Weitere Ressourcen

Erste Schritte mit LightSwitch