Verwenden des Domänendienst-Assistenten

  • Artikel

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.

RIA_AddDomainService

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.

RIA_AddEntity

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.