Exemplarische Vorgehensweise: Verwenden der Silverlight-Geschäftsanwendungsvorlage

  • Artikel

In dieser exemplarischen Vorgehensweise erfahren Sie, wie Sie eine WCF RIA Services-Projektmappe mit der Vorlage "Silverlight-Geschäftsanwendung" erstellen. Es wird erläutert, wie die Anwendung erstellt wird und wie mehrere der von der Vorlage bereitgestellten Funktionen mit sehr geringem zusätzlichen Arbeitsaufwand verwendet werden. Zudem wird beschrieben, wie Sie vom Standardauthentifizierungsmodus, der Formularauthentifizierung, zur Windows-Authentifizierung wechseln.

Mit der Vorlage "Silverlight-Geschäftsanwendung" wird ein Projekt erstellt, das automatisch viele Funktionen enthält, die normalerweise in einer Geschäftsanwendung benötigt werden, z. B. Steuerelemente zum Anmelden von Benutzern und Registrieren neuer Benutzer. Das mit der Vorlage erstellte Projekt ist zudem zur Verwendung der Silverlight-Navigation eingerichtet, sodass neue Silverlight-Seiten für zusätzliche Funktionen mühelos hinzugefügt werden können.

Authentifizierung, Rollen und Profile sind in Projekten, die mit der Vorlage "Silverlight-Geschäftsanwendung" erstellt werden, standardmäßig verfügbar. Der Standardauthentifizierungsmodus der Vorlage ist die Formularauthentifizierung. Der Authentifizierungsmodus kann jedoch leicht in die Windows-Authentifizierung geändert werden, indem Sie zwei Konfigurationswerte ändern. Das Verfahren zum Vornehmen dieser Änderung wird hier erläutert.

Weitere Informationen zum Verwenden der in einer RIA Services -Anwendung unterstützten Dienste für Authentifizierung, Rollen und Profile finden Sie in den Themen im Abschnitt Authentifizierung, Rollen und Profile.

Erforderliche Komponenten

Für diese und die anderen exemplarischen Vorgehensweisen in der WCF RIA Services-Dokumentation müssen zusätzlich zu WCF RIA Services und dem WCF RIA Services-Toolkit mehrere erforderliche Programme installiert und korrekt konfiguriert werden, z. B. Visual Studio 2010, die Silverlight Developer-Laufzeit und das Silverlight-SDK. Zudem müssen Sie SQL Server 2008 R2 Express with Advanced Services installieren und konfigurieren und die AdventureWorks OLTP- und LT-Datenbanken installieren.

Ausführliche Anweisungen für jede dieser erforderlichen Komponenten finden Sie in den Themen unter Erforderliche Komponenten für WCF RIA Services. Folgen Sie den Anweisungen in diesen Themen, bevor Sie mit dieser exemplarischen Vorgehensweise fortfahren, um sicherzustellen, dass beim Ausführen der exemplarischen Vorgehensweisen für RIA Services so wenig Probleme wie möglich auftreten.

So erstellen Sie eine Projektmappe

  1. Wählen Sie in Visual Studio 2010 Datei, Neu und dann Projekt aus.

    Das Dialogfeld Neues Projekt wird angezeigt.

  2. Wählen Sie den Projekttyp Silverlight aus.

  3. Wählen Sie die Vorlage Silverlight-Geschäftsanwendung aus, und geben Sie für die Anwendung den Namen ExampleBusinessApplication ein.

    RIA_ServicesCreateBizApp

  4. Klicken Sie auf OK.

    Beachten Sie die erstellte Projektstruktur. Das Silverlight-Clientprojekt enthält Silverlight-Seiten im Ordner "Views". Diese Seiten ermöglichen das Anmelden von Benutzern und Registrieren von neuen Benutzern.

  5. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Silverlight-Clientprojekt, und klicken Sie auf Eigenschaften.

    Die Registerkarte Silverlight des Projekt-Designers wird angezeigt. Im unteren Bereich der Registerkarte wird ein RIA Services -Link zwischen den Client- und Serverprojekten angezeigt.

  6. Erstellen Sie die Anwendung (F5), und führen Sie sie aus.

    Die Startseite der Anwendung wird im Browser angezeigt.

    Startseite der Geschäftsanwendung

  7. Klicken Sie auf den Link Anmelden.

    Das Dialogfeld Anmelden wird angezeigt.

    Anmeldedialogfeld

  8. Klicken Sie auf den Link Jetzt registrieren.

    Das Dialogfeld Registrieren wird angezeigt.

    Dialogfeld "Registrieren"

  9. Fügen Sie Werte hinzu, um einen neuen Benutzer zu registrieren.

    RIA_RegisterUser

  10. Klicken Sie auf OK, um den neuen Benutzer zu erstellen.

    Sie sind jetzt als der von Ihnen registrierte Benutzer angemeldet.

  11. Schließen Sie den Browser.

So verwenden Sie die Windows-Authentifizierung

  1. Öffnen Sie im Serverprojekt die Datei "Web.config".

  2. Legen Sie im Authentifizierungselement die mode-Eigenschaft auf Windows fest, und entfernen Sie das forms-Element.

    <authentication mode="Windows">
</authentication>

  3. Öffnen Sie im Clientprojekt die CodeBehind-Datei ("App.xaml.cs" bzw. "App.xaml.vb") für die Datei "App.xaml".

  4. Heben Sie im Konstruktor die Auskommentierung der Zeile auf, in der die Authentication-Eigenschaft auf FormsAuthentication festgelegt wird, und kommentieren Sie die Zeile aus, in der die Eigenschaft auf WindowsAuthentication festgelegt wird.

    Public Sub New()
    InitializeComponent()

    Dim webContext As New WebContext()
    'webContext.Authentication = New FormsAuthentication()
    webContext.Authentication = New WindowsAuthentication()
    Me.ApplicationLifetimeObjects.Add(webContext)
End Sub

    public App()
{
    InitializeComponent();

    WebContext webContext = new WebContext();
    //webContext.Authentication = new FormsAuthentication();
    webContext.Authentication = new WindowsAuthentication();
    this.ApplicationLifetimeObjects.Add(webContext);
}

  5. Erstellen Sie die Anwendung (F5), und führen Sie sie aus.

    Sie sind jetzt mit Ihrem Windows-Konto angemeldet. Die Application_Startup-Methode der Silverlight-Geschäftsanwendung enthält Code, der versucht, den Benutzer für die Windows-Authentifizierung zu laden.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Anzeigen von Daten in einer Silverlight-Geschäftsanwendung
Exemplarische Vorgehensweise: Anzeigen von verwandten Daten in einer Silverlight-Geschäftsanwendung