Co to jest Projektant klas?
Za pomocą narzędzia Projektant klas w programie Visual Studio można projektować, wizualizować i refaktoryzować diagramy klas w projektach C#, Visual Basic lub C++. Diagramy klas pokazują elementy kodu i ich relacje na wizualnej powierzchni projektowej, co może pomóc lepiej zrozumieć strukturę projektu i zreorganizować kod.
Uwaga
Projektant klas nie jest dostępny w projektach .NET Core i .NET 5 i nowszych.
Diagramy klas — informacje
Oto, co można zrobić z diagramami klas, bardziej szczegółowo:
Projekt: edytuj kod projektu, edytując diagram klas. Dodaj nowe elementy i usuń niechciane. Zmiany są odzwierciedlane w kodzie.
Wizualizacja: Omówienie struktury projektu przez wyświetlenie klas w projekcie na diagramie. Dostosuj diagram, aby skoncentrować się na szczegółach projektu, które najbardziej ci zależy. Zapisz diagram, aby użyć go później do celów demonstracyjnych lub dokumentacji.
Refaktoryzacja: przesłoń metody, zmień nazwy identyfikatorów, parametry refaktoryzacji oraz zaimplementuj interfejsy i klasy abstrakcyjne.
Wyświetlanie typów i relacji
Diagramy klas pokazują szczegóły typów, na przykład ich składowych składowych i relacje między nimi. Wizualizacja tych jednostek jest dynamicznym widokiem na kod. Oznacza to, że można edytować typy w projektancie, a następnie zobaczyć zmiany odzwierciedlone w kodzie źródłowym jednostki. Podobnie diagram klas jest synchronizowany ze zmianami wprowadzanymi w plikach kodu.
Uwaga
Jeśli projekt zawiera diagram klas, a projekt odwołuje się do typu znajdującego się w innym projekcie, diagram klas nie pokazuje typu, do którego odwołujesz się, dopóki nie skompilujesz projektu dla tego typu. Podobnie diagram nie wyświetla zmian w kodzie jednostki zewnętrznej do momentu ponownego skompilowania projektu dla tej jednostki.
Przepływ pracy diagramu klas
Diagramy klas mogą ułatwić zrozumienie struktury klas projektów. Te projekty mogły zostać utworzone przez innych deweloperów lub wystarczy odświeżyć projekt utworzony samodzielnie. Diagramy klas umożliwiają dostosowywanie, udostępnianie i prezentowanie informacji o projekcie innym osobom.
Pierwszym krokiem prezentowania informacji o projekcie jest utworzenie diagramu klasy, który wyświetla, co chcesz pokazać. Aby uzyskać więcej informacji, zobacz Dodawanie diagramu klas. Można utworzyć wiele diagramów klas dla projektu, który może służyć do wyświetlania odrębnego widoku projektu, wybranego podzestawu typów projektu lub wybranego podzestawu elementów członkowskich typów.
Oprócz definiowania tego, co pokazuje każdy diagram klas, można również zmienić sposób prezentowania tych informacji; Aby uzyskać więcej informacji, zobacz Dostosowywanie diagramów klas.
Po dostrojeniu co najmniej jednego diagramu klasy możesz skopiować je do dokumentów pakietu Microsoft Office i wydrukować je lub wyeksportować jako pliki obrazów. Aby uzyskać więcej informacji, zobacz Kopiowanie elementów diagramu klas do dokumentu pakietu Microsoft Office, Diagramy klas wydruku i Eksportowanie diagramów klas jako obrazów.
Uwaga
Projektant klas nie śledzi lokalizacji plików źródłowych, więc zmiana struktury projektu lub przenoszenie plików źródłowych w projekcie może spowodować utratę śledzenia typu przez projektanta klas, zwłaszcza typu źródłowego typu typedef, klas bazowych lub typów skojarzeń. Może wystąpić błąd, na przykład Projektant klas nie może wyświetlić tego typu. Jeśli tak, przeciągnij zmodyfikowany lub przeniesiony kod źródłowy do diagramu klas ponownie, aby go ponownie odtworzyć.
Dodawanie diagramów klas do projektów
Aby zaprojektować, edytować i refaktoryzować klasy i inne typy, dodaj diagram klas do projektu C#, Visual Basic lub C++. Aby zwizualizować różne części kodu w projekcie, dodaj wiele diagramów klas do projektu.
Nie można tworzyć diagramów klas na podstawie projektów współużytkujących kod w wielu aplikacjach. Aby utworzyć diagramy klas UML, zobacz Tworzenie projektów i diagramów modelowania UML.
Instalowanie składnika Projektant klas
Jeśli nie zainstalowano składnika Projektant klas, wykonaj następujące kroki, aby go zainstalować.
Otwórz Instalator programu Visual Studio z menu Start systemu Windows lub wybierając pozycję Narzędzia>Pobierz narzędzia i funkcje na pasku menu w programie Visual Studio.
Instalator programu Visual Studio zostanie otwarty.
Jeśli masz już zainstalowany program Visual Studio, kliknij przycisk Modyfikuj z opcji.
Wybierz kartę Poszczególne składniki , a następnie przewiń w dół do kategorii Narzędzia kodu.
Wybierz pozycję Projektant klas, a następnie wybierz pozycję Modyfikuj.
Składnik Projektant klas rozpoczyna instalowanie.
Dodawanie pustego diagramu klasy do projektu
W Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł projektu, a następnie wybierz polecenie Dodaj>nowy element. Lub naciśnij Ctrl+Shift+A. Jeśli zostanie wyświetlone małe okno z opcją dodania pliku kodu, wybierz przycisk Pokaż wszystkie szablony .
Zostanie otwarte okno dialogowe Dodawanie nowego elementu .
Rozwiń węzeł Ogólne, a następnie wybierz pozycję Diagram klas z listy szablonów. W przypadku projektów Visual C++ poszukaj w kategorii Narzędzia , aby znaleźć szablon Diagram klas.
Uwaga
Jeśli nie widzisz szablonu Diagram klas, wykonaj kroki instalacji składnika Projektant klas dla programu Visual Studio. Jak wspomniano wcześniej w tym artykule, projektant klas nie jest dostępny dla platform .NET Core i .NET 5 i nowszych.
Diagram klas zostanie otwarty w Projektancie klas i zostanie wyświetlony jako plik z rozszerzeniem CD w Eksplorator rozwiązań. Kształty i linie można przeciągać do diagramu z przybornika lub przeciągać węzeł projektu z Eksplorator rozwiązań, aby dodać klasy w tym projekcie.
Aby dodać wiele diagramów klas, powtórz czynności opisane w tej procedurze.
Aby wyświetlić zawartość kompletnego projektu na diagramie klasy
Otwórz pusty diagram klas, a następnie przeciągnij węzeł projektu z Eksplorator rozwiązań do powierzchni diagramu klas. Zostanie utworzony diagram klasy wypełnionej automatycznie.
Ważne
Projektant klas nie jest dostępny w projektach platformy .NET Core.
Dostosowywanie diagramów klas
Można zmienić sposób wyświetlania informacji na diagramach klas. Można dostosować cały diagram lub poszczególne typy na powierzchni projektowej.
Na przykład, można dostosować poziom powiększenia całego diagramu klasy, zmienić grupowanie i sortowanie poszczególnych składowych typu, ukrywać lub pokazywać relacje i przenieść pojedyncze typy lub zestawy typów w dowolne miejsce na diagramie.
Uwaga
Dostosowywanie sposobu wyświetlania kształtów na diagramie nie zmienia podstawowego kodu dla typów reprezentowanych na diagramie.
Sekcje zawierające składowe typu, takie jak sekcja Właściwości w klasie, są nazywane przedziałami. Można ukryć lub pokazać poszczególne przedziały i elementy członkowskie typu.
Powiększanie i pomniejszanie diagramu klasy
Otwórz plik diagramu klas i wybierz go w Projektancie klas.
Na pasku narzędzi Projektant klas kliknij przycisk Powiększ lub Pomniejszaj, aby zmienić poziom powiększenia powierzchni projektanta.
lub
Określ konkretną wartość stopnia powiększenia. Możesz użyć listy rozwijanej Zoom lub wpisać prawidłowy poziom powiększenia (prawidłowy zakres wynosi od 10% do 400%).
Uwaga
Zmiana poziomu powiększenia nie ma wpływu na skalę wydruku diagramu klasy.
Dostosowywanie grupowania i sortowania elementów członkowskich typu
Otwórz plik diagramu klas i wybierz go w Projektancie klas.
Kliknij prawym przyciskiem myszy pusty obszar na powierzchni projektowej i wskaż pozycję Członkowie grupy.
Wybierz jedną z dostępnych opcji:
Grupowanie według rodzaju oddziela poszczególne elementy członkowskie typu na grupowaną listę właściwości, metod, zdarzeń i pól. Poszczególne grupy zależą od definicji jednostek: na przykład klasa nie wyświetla żadnej grupy zdarzeń, jeśli nie ma jeszcze zdarzeń zdefiniowanych dla tej klasy.
Grupowanie według dostępu oddziela poszczególne elementy członkowskie typu do listy grupowanej na podstawie modyfikatorów dostępu członka. Na przykład, publiczne i prywatne.
Sortuj alfabetycznie wyświetla elementy tworzące jednostkę jako pojedynczą listę alfabetyzowaną. Lista jest sortowana w kolejności rosnącej.
Ukrywanie przedziałów w danym typie
Otwórz plik diagramu klas i wybierz go w Projektancie klas.
Kliknij prawym przyciskiem myszy kategorię składową w typie, który chcesz dostosować (na przykład wybierz węzeł Metody w klasie.
Kliknij pozycję Ukryj przedział.
Wybrany przedział znika z kontenera typu.
Ukrywanie poszczególnych elementów członkowskich w danym typie
Otwórz plik diagramu klas i wybierz go w Projektancie klas.
Kliknij prawym przyciskiem myszy element członkowski w typie, który chcesz ukryć.
Kliknij pozycję Ukryj.
Wybrany element członkowski znika z kontenera typu.
Pokazywanie ukrytych przedziałów i elementów członkowskich w danym typie
Otwórz plik diagramu klas i wybierz go w Projektancie klas.
Kliknij prawym przyciskiem myszy nazwę typu z ukrytym przedziałem.
Kliknij pozycję Pokaż wszystkich członków.
Wszystkie ukryte przedziały i elementy członkowskie pojawiają się w kontenerze typu.
Ukrywanie relacji
Otwórz plik diagramu klas i wybierz go w Projektancie klas.
Kliknij prawym przyciskiem myszy linię skojarzenia lub dziedziczenia, którą chcesz ukryć.
Kliknij przycisk Ukryj dla linii skojarzenia, a następnie kliknij pozycję Ukryj wiersz dziedziczenia dla wierszy dziedziczenia.
Kliknij pozycję Pokaż wszystkich członków.
Wszystkie ukryte przedziały i elementy członkowskie pojawiają się w kontenerze typu.
Pokazywanie ukrytych relacji
Otwórz plik diagramu klas i wybierz go w Projektancie klas.
Kliknij prawym przyciskiem myszy typ z ukrytym skojarzeniem lub dziedziczeniem.
Kliknij pozycję Pokaż wszystkie elementy członkowskie dla linii skojarzenia, a następnie kliknij pozycję Pokaż klasę bazową lub Pokaż klasy pochodne dla wierszy dziedziczenia.
Usuwanie kształtu z diagramu klasy
Możesz usunąć kształt typu z diagramu klasy bez wpływu na podstawowy kod typu. Usunięcie kształtów typu z diagramu klasy ma wpływ tylko na ten diagram: podstawowy kod, który definiuje typ i inne diagramy, na które jest wyświetlany typ, nie ma wpływu.
Na diagramie klasy zaznacz kształt typu, który chcesz usunąć z diagramu.
W menu Edycja wybierz pozycję Usuń z diagramu.
Kształt typu i wszystkie linie skojarzeń lub dziedziczenia połączone z kształtem nie są już wyświetlane na diagramie.
Usuwanie kształtu typu i jego kodu podstawowego
Kliknij prawym przyciskiem myszy kształt na powierzchni projektowej.
Wybierz pozycję Usuń kod z menu kontekstowego.
Kształt zostanie usunięty z diagramu, a jego podstawowy kod zostanie usunięty z projektu.
Kopiowanie elementów diagramu klas do dokumentu pakietu Microsoft Office
Kształty można kopiować z diagramu klas platformy .NET (plik cd ) do innych dokumentów. Otrzymasz kopię kształtu lub jego kodu bazowego na podstawie rodzaju dokumentu, w którym go wklejasz. Aby skopiować kształty z diagramów klas UML w projekcie modelowania, zobacz Eksportowanie diagramów jako obrazów.
Kopiowanie pojedynczego elementu
Kliknij kształt prawym przyciskiem myszy i wybierz polecenie Kopiuj obraz.
Kopiowanie kilku elementów
Wybierz kształty na diagramie, które chcesz skopiować.
Kliknij prawym przyciskiem myszy wybór i wybierz polecenie Kopiuj obraz.
Kopiowanie wszystkich elementów na diagramie klas
Kliknij prawym przyciskiem myszy powierzchnię diagramu i wybierz polecenie Zaznacz wszystko lub naciśnij Ctrl+A.
W menu Edycja wybierz pozycję Kopiuj obraz.
Możesz również wybrać pozycję Kopiuj zamiast kopiuj obraz. Kopiuje obraz jako zwykłą mapę bitową. Kopiowanie obrazu kopiuje obraz jako obraz oparty na wektorach, co jest lepsze w przypadku większości aplikacja pakietu Office licacji.
Eksportowanie diagramów klas jako obrazów
Aby wyeksportować diagram klas utworzony na podstawie kodu w projekcie, zapisz diagram jako obraz. Jeśli zamiast tego chcesz wyeksportować diagramy klas UML, zobacz Eksportowanie diagramów jako obrazów.
Eksportowanie diagramu
Otwórz plik diagramu klas (.cd).
Z menu Diagram klas lub menu skrótów powierzchni diagramu wybierz pozycję Eksportuj diagram jako Obraz.
Wybierz diagram.
Wybierz odpowiedni format.
Wybierz pozycję Eksportuj , aby zakończyć eksportowanie.
Aby automatycznie zaktualizować wyeksportowane obrazy połączone z innych dokumentów, ponownie wyeksportuj diagram w programie Visual Studio.
Drukowanie diagramów klas
Diagram klas można wydrukować przy użyciu funkcji drukowania programu Visual Studio.
Aby wydrukować diagram klas
Otwórz diagram klas.
Kliknij pozycję Drukuj w menu Plik .
Cały diagram klasy drukuje. Może być konieczne dostosowanie ustawień w oknie dialogowym Ustawienia strony w celu wydrukowania w odpowiednim rozmiarze.
Dodawanie komentarzy do diagramów klas
Możesz użyć kształtów komentarzy do dodawania adnotacji do diagramów klas. Kształt komentarza ma jedną właściwość Text, w której można wpisać tekst. Kształty komentarzy istnieją tylko na powierzchni diagramu, a nie w kodzie.
Komentarz znajduje się w widoku diagramu klas w Projektancie klas. Jeśli otworzysz diagram drugiej klasy na tym samym projekcie, komentarze utworzone w pierwszym widoku nie będą widoczne. Jeśli usuniesz diagram, wszystkie zawarte w nim komentarze również zostaną usunięte.
Możesz zmienić rozmiar kształtu komentarza, ale nie można zmienić innych aspektów jego wyglądu, takich jak kolor tła, czcionka lub rozmiar czcionki.
Aby dodać komentarz
Przeciągnij komentarz z przybornika Projektant klas na diagram klasy.
Kliknij nowy kształt komentarza na diagramie i wpisz odpowiedni tekst.
Używanie skrótów myszy i klawiaturowych w oknie Diagram klas i Szczegóły klasy
Oprócz myszy można używać klawiatury do wykonywania akcji nawigacji w Projektancie klas i w oknie Szczegóły klasy.
Używanie myszy w Projektancie klas
Następujące akcje myszy są obsługiwane na diagramach klas:
| Kombinacja myszy | Kontekst | opis |
|---|---|---|
| Kliknij dwukrotnie | elementy kształtu | Otwiera edytor kodu. |
| Kliknij dwukrotnie | Łącznik Lollipop | Rozwiń/zwiń lizaki. |
| Kliknij dwukrotnie | Etykieta łącznika Lollipop | Wywołuje polecenie Pokaż interfejs. |
| Kółko myszy | Diagram klas | Przewiń w pionie. |
| Shift + kółko myszy | Diagram klas | Przewiń w poziomie. |
| Ctrl + kółko myszy | Diagram klas | Powiększenia. |
| Ctrl+Shift + kliknięcie | Diagram klas | Powiększenia. |
Korzystanie z myszy w oknie Szczegóły klasy
Za pomocą myszy można zmienić wygląd okna Szczegóły klasy i wyświetlane dane w następujący sposób:
Kliknięcie dowolnej edytowalnej komórki umożliwia edytowanie zawartości tej komórki. Zmiany są odzwierciedlane we wszystkich miejscach, w których dane są przechowywane lub wyświetlane, w tym w oknie Właściwości i w kodzie źródłowym.
Kliknięcie dowolnej komórki wiersza powoduje wyświetlenie właściwości elementu reprezentowanego przez ten wiersz w oknie Właściwości .
Aby zmienić szerokość kolumny, przeciągnij granicę po prawej stronie nagłówka kolumny, aż kolumna będzie mieć odpowiednią szerokość.
Możesz rozwinąć lub zwinąć przedział lub węzły właściwości, klikając symbole strzałek po lewej stronie wiersza.
Okno Szczegóły klasy oferuje kilka przycisków do tworzenia nowych składowych w bieżącej klasie i nawigowania między przedziałami składowych w siatce okna Szczegóły klasy.
Używanie klawiatury w Projektancie klas
Następujące akcje klawiatury są obsługiwane na diagramach klas:
| Klucz | Kontekst | opis |
|---|---|---|
| strzałek | Kształty typu | Nawigacja w stylu drzewa na zawartości kształtu (obsługiwane jest zawijanie wokół kształtu). Klucze w lewo i w prawo rozwiń/zwiń bieżący element, jeśli można go rozwinąć i przejdź do elementu nadrzędnego, jeśli nie (zobacz nawigację w widoku drzewa, aby uzyskać szczegółowe zachowanie). |
| strzałek | Kształty najwyższego poziomu | Przenoszenie kształtów na diagramie. |
| Shift+strzałek | Kształty typu | Tworzenie ciągłego wyboru składającego się z elementów kształtu, takich jak elementy członkowskie, typy zagnieżdżone lub przedziały. Te skróty nie obsługują zawijania wokół. |
| Strona główna | Kształty typu | Przejdź do tytułu kształtu najwyższego poziomu. |
| Strona główna | Kształty najwyższego poziomu | Przejdź do pierwszego kształtu na diagramie. |
| Koniec | Kształty typu | Przejdź do ostatniego widocznego elementu wewnątrz kształtu. |
| Koniec | Kształty najwyższego poziomu | Przejdź do ostatniego kształtu na diagramie. |
| Shift+Home | Kształt typu wewnętrznego | Wybiera elementy w kształcie rozpoczynające się od bieżącego elementu i kończące się na najbardziej górnym elemencie w tym samym kształcie. |
| Shift+End | Kształt typu wewnętrznego | Tak samo jak Shift+Home, ale w kierunku od góry do dołu. |
| Wejść | Wszystkie konteksty | Wywołuje domyślną akcję na kształcie, która jest również dostępna za pomocą dwukrotnego kliknięcia. W większości przypadków jest to Wyświetl kod, ale niektóre elementy definiują go inaczej (lizaki, nagłówki przedziałów, etykiety lollipop). |
| + i - | Wszystkie konteksty | Jeśli obecnie skoncentrowany element jest rozwijany, te klucze rozszerzają lub zwijają element. |
| > | Wszystkie konteksty | W przypadku elementów z elementami podrzędnymi ten element jest rozwijany, jeśli jest zwinięty i przechodzi do pierwszego elementu podrzędnego. |
| < | Wszystkie konteksty | Przechodzi do elementu nadrzędnego. |
| Alt+Shift+L | Wewnątrz wpisz kształty + na kształtach typów. | Przechodzi do lizaka aktualnie wybranego kształtu, jeśli jest obecny. |
| Alt+Shift+B | Wewnątrz wpisz kształty + na kształtach typów. | Jeśli lista typów podstawowych jest wyświetlana w kształcie typu i zawiera więcej niż jeden element, przełącza stan rozszerzenia listy (zwiń/rozwiń). |
| Usuń | W przypadku kształtów typów i komentarzy | Wywołuje polecenie Usuń z diagramu. |
| Usuń | Na wszystko inne. | Wywołuje polecenie Delete from Code (elementy członkowskie, parametry, skojarzenia, dziedziczenie, etykiety lollipop). |
| Ctrl+Delete | Wszystkie konteksty | Wywołuje polecenie Delete from Code (Usuń z kodu) podczas zaznaczenia. |
| Zakładka | Wszystkie konteksty | Przechodzi do następnego elementu podrzędnego w ramach tego samego elementu nadrzędnego (obsługuje zawijanie). |
| Shift Tab+ | Wszystkie konteksty | Przechodzi do poprzedniego elementu podrzędnego w obrębie tego samego elementu nadrzędnego (obsługuje zawijanie). |
| Pasek spacji | Wszystkie konteksty | Przełącza zaznaczenie w bieżącym elemencie. |
Korzystanie z klawiatury w oknie Szczegóły klasy
Uwaga
Poniższe powiązania kluczy naśladują środowisko wpisywania kodu.
Użyj następujących kluczy, aby przejść do okna Szczegóły klasy:
| Klucz | Result |
|---|---|
| , (przecinek) | Jeśli kursor znajduje się w wierszu parametru, wpisywanie przecinka przenosi kursor do pola Nazwa następnego parametru. Jeśli kursor znajduje się w ostatnim wierszu parametru metody, przenosi kursor do <pola dodawania parametru> , którego można użyć do utworzenia nowego parametru. Jeśli kursor znajduje się w innym miejscu w oknie Szczegóły klasy, wpisanie przecinka dosłownie dodaje przecinek w bieżącym polu. |
| ; (średnik) lub ) (nawias zamykający) | Przenieś kursor do pola Nazwa następnego wiersza składowego w siatce okna Szczegóły klasy. |
| Zakładka | Przenosi kursor do następnego pola, najpierw przesuwając się w lewo do prawej, a następnie do dołu. Jeśli kursor jest przenoszony z pola, w którym został wpisany tekst, szczegóły klasy przetwarza ten tekst i zapisuje go, jeśli nie powoduje błędu. Jeśli kursor znajduje się w pustym polu, takim jak <dodawanie parametru>, tabulator przenosi go do pierwszego pola następnego wiersza. |
| Pasek spacji | Przenosi kursor do następnego pola, najpierw przesuwając się w lewo do prawej, a następnie do dołu. Jeśli kursor znajduje się w pustym polu, takim jak <dodawanie parametru>, zostanie przeniesiony do pierwszego pola następnego wiersza. Pamiętaj, że <spacja> typowana natychmiast po zignorowaniu przecinka. Jeśli kursor znajduje się w polu Podsumowanie, wpisanie spacji powoduje dodanie znaku spacji. Jeśli kursor znajduje się w kolumnie Ukryj danego wiersza, wpisywanie spacji przełącza wartość pola wyboru Ukryj. |
| Ctrl+Tab | Przełącz się do innego okna dokumentu. Na przykład przełącz się z okna Szczegóły klasy na otwarty plik kodu. |
| Esc | Jeśli zacząłeś wpisywać tekst w polu, naciśnięcie ESC działa jako cofania, przywracając zawartość pola do poprzedniej wartości. Jeśli okno Szczegóły klasy ma ogólną fokus, ale żadna konkretna komórka nie ma fokusu , naciśnięcie ESC przenosi fokus z okna Szczegóły klasy. |
| Strzałka w górę i strzałka w dół | Te klucze przenoszą kursor z wiersza do wiersza w pionie w siatce okna Szczegóły klasy. |
| Strzałka w lewo | Jeśli kursor znajduje się w kolumnie Nazwa, naciśnięcie strzałki po lewej stronie zwija bieżący węzeł w hierarchii (jeśli jest otwarty). |
| Strzałka w prawo | Jeśli kursor znajduje się w kolumnie Nazwa, naciśnięcie strzałki w prawo rozwija bieżący węzeł w hierarchii (jeśli jest zwinięty). |
Napiwek
Aby uzyskać pełną listę skrótów klawiaturowych, zobacz Skróty klawiaturowe w programie Visual Studio.