Gewusst wie: Hinzufügen einer lokalen Eigenschaft zu einem Silverlight-Bildschirm

Artikel
02/26/2013

Sie können einem Bildschirm ein Feld hinzufügen. Dieses wird als lokale Eigenschaft bezeichnet.Sie können eine lokale Eigenschaft verwenden, um einen Eingabewert zu erfassen oder um einen berechneten Wert anzuzeigen.

So erstellen Sie eine lokale Eigenschaft

Klicken Sie oben im Bildschirm-Designer auf Datenelement hinzufügen….

Das Dialogfeld Datenelement hinzufügen wird angezeigt.
Wählen Sie im Dialogfeld Neues Datenelement hinzufügen die Option Lokale Eigenschaft aus.
Wählen Sie in der Dropdownliste Typ einen Typ für die lokale Eigenschaft aus.

Sie können einen beliebigen Standardtyp auswählen, z. B. Zeichenfolge, Ganze Zahl oder E-Mail-Adresse, oder eine beliebige Entität, die der Anwendung zugeordnet ist, z. B. Customer, Order Detail oder Product.
Wählen Sie Ist erforderlich aus, wenn dieses Feld einen Wert enthalten muss.

Hinweis

Falls dieses Feld keinen Wert enthält, wenn der Benutzer versucht, den Bildschirm zu öffnen, wird eine Validierungsmeldung angezeigt.
Geben Sie im Textfeld Name einen Namen ein, und klicken Sie dann auf OK.

Das Dialogfeld Datenelement hinzufügen wird geschlossen.Die lokale Eigenschaft wird in der Liste der Bildschirm-Member angezeigt.

Hinweis
Falls dieses Feld keinen Wert enthält, wenn der Benutzer versucht, den Bildschirm zu öffnen, wird eine Validierungsmeldung angezeigt.

So fügen Sie eine lokale Eigenschaft einem Bildschirm hinzu

Ziehen Sie die lokale Eigenschaft aus der Liste der Bildschirm-Member an die gewünschte Position in der Struktur der Bildschirminhalte.
Wählen Sie in der Struktur der Bildschirminhalte in der Dropdownliste, die neben der lokalen Eigenschaft angezeigt wird, den gewünschten Anzeigetyp aus.

Wenn Sie z. B. eine lokale Eigenschaft erstellen, um einen Währungswert anzuzeigen, können Sie den Anzeigetyp im Währungs-Editor oder in der Währungsanzeige ändern.Ebenso können Sie eine lokale Eigenschaft vom Typ "Zeichenfolge" entweder als Textfeld oder als Bezeichnung anzeigen.

So wenden Sie Validierungsregeln auf eine lokale Eigenschaft an

Wählen Sie die lokale Eigenschaft in der Liste der Bildschirm-Member aus.
Erweitern Sie im Fenster Eigenschaften den Knoten Validierung, falls der Knoten noch nicht erweitert ist.

Welche Validierungsregeln verfügbar sind, hängt vom Typ der lokalen Eigenschaft ab.
Wenn die lokale Eigenschaft über einen Wert verfügen muss, wählen Sie Ist erforderlich aus.

Wählen Sie nach Bedarf weitere Validierungsregeln aus, die Sie auf die lokale Eigenschaft anwenden möchten.
Wenn Sie eine komplexere Validierung ausführen müssen, klicken Sie auf Benutzerdefinierte Validierung.

Der Code-Editor wird geöffnet.LightSwitch generiert eine Methode mit dem Namen localPropertyName_Validate.Sie können dieser Methode benutzerdefinierte Validierungslogik hinzufügen.Im folgenden Beispiel wird eine Fehlermeldung angezeigt, wenn der Benutzer weniger als drei Zeichen für eine lokale Eigenschaft mit dem Namen CityCode eingibt.
```
Private Sub CityCode_Validate(results As ScreenValidationResultsBuilder)
    If Me.CityCode.Length < 3 Then
        results.AddPropertyError("This string must have at least 3 letters.")
    End If
End Sub
```
```
partial void CityCode_Validate
    (ScreenValidationResultsBuilder results)
{
    if (this.CityCode.Length < 3)
    {
        results.AddPropertyError("This string must have at least 3 letters.");
    }

}
```
Wenn die Zeichenfolge nicht mindestens drei Zeichen enthält, wird die Eigenschaft rot umrandet, und die zuvor eingegebene Fehlermeldung wird angezeigt.

So weisen Sie einer lokalen Eigenschaft mithilfe von Code einen Wert zu

Mithilfe von Code können Sie einen Wert für eine lokale Eigenschaft festlegen.

Im folgenden Beispiel wird der Wert der lokalen Eigenschaft ApprovedCheckBox auf False festgelegt.

Private Sub OrdersListDetail_InitializeDataWorkspace _
    (saveChangesTo As System.Collections.Generic.List _
     (Of Microsoft.LightSwitch.IDataService))
    ApproveCheckBox = False

End Sub

partial void ApprovedCheckBox_Validate
    (ScreenValidationResultsBuilder results)
{
    ApprovedCheckBox = false;

}

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen eines benutzerdefinierten Befehls zu einem Silverlight-Bildschirm

Gewusst wie: Entwerfen eines Silverlight-Bildschirms mithilfe des Bildschirm-Designers

Weitere Ressourcen

Bildschirme: Die Benutzeroberfläche Ihrer Anwendung

Freigeben über