Verwenden des Domänendienst-Assistenten
Das Dialogfeld Neue Domänendienstklasse hinzufügen dient zum Hinzufügen eines DomainService-Objekts, mit dem in einem Serverprojekt Daten von einer Datenzugriffsebene (DAL) wie Entity Framework oder LINQ to SQL verfügbar gemacht werden.
Klicken Sie zum Aufrufen des Dialogfelds Neue Domänendienstklasse hinzufügen im Projektmappen-Explorer mit der rechten Maustaste auf das Serverprojekt, wählen Sie Hinzufügen aus und dann Neues Element, um das Dialogfeld Neues Element hinzufügen zu öffnen.
Wählen Sie in der Kategorie Web des Bereichs Installierte Vorlagen des Dialogfelds die Option Domänendienstklasse aus, und klicken Sie auf Hinzufügen. Der Assistent Neue Domänendienstklasse hinzufügen wird angezeigt.
Unter Exemplarische Vorgehensweise: Erstellen einer RIA Services-Projektmappe wird das Szenario beschrieben, in dem dieses Dialogfeld mit der AdventureWorksLT2008-Datenbank verwendet wird.
Benutzeroberflächenelemente
Dieser Abschnitt enthält Beschreibungen der Elemente in diesem Dialogfeld.
- Name der Domänendienstklasse
Gibt den Namen der Instanz der DomainService-Klasse an. Dies ist eine schreibgeschützte Eigenschaft. Der Name kann hier nicht geändert werden.
- Clientzugriff aktivieren
Aktivieren Sie dieses Kontrollkästchen, wenn Sie den DomainService für den Client verfügbar machen möchten. Dieses Kontrollkästchen ist standardmäßig aktiviert. Wenn Sie dieses Kontrollkästchen aktivieren, generiert RIA Services Domänenkontext für einen Domänendienst und Entitäten auf dem Client.
- OData-Endpunkt verfügbar machen
Aktivieren Sie dieses Kontrollkästchen, wenn der Dienst einen zusätzlichen Endpunkt mit dem OData-Protokoll verfügbar machen soll. Dadurch wird dem <domainServices>-Abschnitt der Datei "web.config" ein OData-Endpunkt hinzugefügt, und die über OData verfügbar gemachten parameterlosen Abfragemethoden werden als Standard markiert. Der Domänendienst wird so als OData-Feed verfügbar gemacht.
- Verfügbare DataContext-/ObjectContext-Klassen
Hiermit wählen Sie die DAL aus, z. B. Entity Framework oder LINQ to SQL. Die LINQ to SQL-Option ist nur verfügbar, wenn Sie das RIA Services -Toolkit installiert haben. Sie können auch die Option <leere Domänendienstklasse> auswählen, wenn Sie den DAL-Zugriff der Domänendienstklasse anpassen möchten. Einzelheiten über die Verwendung dieser Option mit POCO-Entitäten finden Sie unter Gewusst wie: Erstellen eines Domänendiensts für als POCO definierte Entitäten.
- Entitäten
Verwenden Sie diese Prüfliste, um die Entitäten aus der Datenquelle auszuwählen, die vom Domänendienst für den Client verfügbar gemacht werden.
- Bearbeitung aktivieren
Aktivieren Sie die relevanten Felder, um anzugeben, welche der ausgewählten Entitäten bearbeitet werden können. Wenn Sie dieses Kontrollkästchen aktivieren, werden CUD-Methoden (Create, Update, Delete) für die ausgewählten Entitäten generiert.
- Zugeordnete Klassen für Metadaten generieren
Aktivieren Sie dieses Kontrollkästchen, wenn Sie eine partielle Klasse mit allen Eigenschaften des ausgewählten Modells generieren möchten. Der Benutzer kann dann Validierungs-/Anzeigeattribute auf diese Eigenschaften anwenden.