Właściwości właściwości domeny
Właściwość domeny jest funkcją elementu modelu, który może przechowywać wartość. Na przykład Person
klasa domeny może mieć właściwości Name
i BirthDate
. W definicji DSL właściwości domeny są wyświetlane w polu klasy domeny na diagramie i w obszarze klasy domeny w Eksploratorze DSL. Aby uzyskać więcej informacji, zobacz How to Define a Domain-Specific Language (Jak zdefiniować język specyficzny dla domeny).
Uwaga
Słowo "property" ma dwa zastosowania. Właściwość domeny jest funkcją zdefiniowaną w klasie domeny. Z kolei wiele elementów rozszerzenia DSL ma właściwości, które są wymienione w oknie Właściwości w definicji DSL. Na przykład każda właściwość domeny ma zestaw właściwości opisanych w tym temacie.
W czasie wykonywania, gdy użytkownik tworzy wystąpienia klasy domeny, wartości właściwości domeny można wyświetlić w okno Właściwości i mogą być wyświetlane na kształtach.
Większość właściwości domeny jest implementowana jako zwykłe właściwości CLR. Jednak z punktu widzenia programowania właściwości domeny mają bogatsze funkcje niż zwykłe właściwości programu:
Można zdefiniować reguły i zdarzenia, które monitorują stan właściwości. Aby uzyskać więcej informacji, zobacz Odpowiadanie na zmiany i propagowanie ich.
Transakcje pomagają zapobiegać niespójnym stanom. Aby uzyskać więcej informacji, zobacz Nawigowanie i aktualizowanie modelu w kodzie programu.
Po wybraniu właściwości domeny na diagramie lub w Eksploratorze DSL można zobaczyć następujące elementy w okno Właściwości. Aby uzyskać więcej informacji na temat używania tych elementów, zobacz Dostosowywanie i rozszerzanie języka specyficznego dla domeny.
Właściwości | Description | Wartość domyślna |
---|---|---|
Opis | Opis używany do dokumentowania interfejsu użytkownika wygenerowanego projektanta. | <none> |
Wyświetlana nazwa | Nazwa wyświetlana w wygenerowanych projektantach dla tej właściwości domeny. Może zawierać spacje i znaki interpunkcyjne, na przykład "Tytuł piosenki". | <none> |
Dostawca nazw elementów | Ma to zastosowanie tylko wtedy, gdy ustawiono wartość Is Element Name true . Możesz napisać kod, który zawiera nazwę nowego elementu klasy domeny, przesłaniając zachowanie domyślne.W pliku kodu w projekcie DSL utwórz klasę pochodzącą z ElementNameProviderklasy . Następnie w Eksploratorze DSL kliknij prawym przyciskiem myszy katalog główny DSL, a następnie kliknij pozycję Dodaj typ zewnętrzny. Wprowadź nazwę klasy. Ponownie wybierz tę właściwość domeny i wybierz nazwę klasy z listy rozwijanej. |
<none> |
Modyfikator dostępu getter | Poziom dostępu do klasy domeny (public lub internal ). Steruje to zakresem, w którym kod programu może uzyskać dostęp do właściwości. |
public |
Słowo kluczowe Pomocy | Opcjonalne słowo kluczowe używane do indeksowania pomocy F1 dla tej właściwości domeny. | <none> |
Jest możliwe do przeglądania | Jeśli True właściwość domeny jest wyświetlana użytkownikowi w oknie właściwości, gdy modele tego rozszerzenia DSL są otwarte.Jeśli False właściwość domeny jest ukryta w interfejsie użytkownika.Jeśli chcesz ustawić właściwość domeny jako widoczną, ale tylko do odczytu, ustaw wartość Is UI Read Only (Tylko do odczytu interfejsu użytkownika). |
True |
Jest nazwą elementu | Jeśli True właściwość domeny zostanie wyświetlona jako nazwa elementu modelu w Eksploratorze DSL.Nowe elementy modelu otrzymają unikatową wartość domyślną dla tej właściwości. Jeśli chcesz kontrolować sposób generowania tych wartości, ustaw dostawcę nazw elementów. |
False |
Czy interfejs użytkownika jest tylko do odczytu | Jeśli True wartość właściwości domeny nie może zostać zmieniona przy użyciu interfejsu użytkownika. Nadal może być ustawiana przez programy i będzie widoczna w okno Właściwości.Jeśli chcesz ukryć właściwość domeny od użytkownika, ustaw opcję Przeglądanie jest możliwe. Jeśli chcesz kontrolować dostęp za pomocą programów, ustaw modyfikator dostępu Setter. |
False |
Rodzaj | Rodzaj właściwości domeny (Normal , Calculated , lub CustomStorage ). Aby uzyskać więcej informacji, zobacz Właściwości obliczeniowe i niestandardowego magazynu. |
Normal |
Nazwa/nazwisko | Nazwa tej właściwości domeny. Musi być prawidłowym identyfikatorem, na przykład SongTitle. | <none> |
Uwagi | Nieformalne uwagi skojarzone z tą właściwością domeny. | <none> |
Modyfikator dostępu ustawiającego | Modyfikator dostępu dla programu setter. Steruje to zakresem, w którym kod programu może ustawić właściwość . | public |
Type | Typ właściwości. Aby dodać do listy dostępnych typów, kliknij prawym przyciskiem myszy katalog główny DSL w eksploratorze DSL, a następnie kliknij przycisk Dodaj typ zewnętrzny. | String |