Udostępnij za pośrednictwem

Tworzenie i konfigurowanie składowych typów w Projektant klasy

  • Artykuł

Te elementy członkowskie można dodać do typów na diagramie klas i skonfigurować te elementy członkowskie w oknie Szczegóły klasy:

Type Elementy członkowskie, które mogą zawierać
Klasa metoda, właściwość (w języku C# i Visual Basic), pole, zdarzenie (w języku C# i Visual Basic), konstruktor (metoda), destruktor (metoda), stała
Wyliczenie członek
Interfejs metoda, właściwość, zdarzenie (w języku C# i Visual Basic)
Klasa abstrakcyjna metoda, właściwość (w języku C# i Visual Basic), pole, zdarzenie (w języku C# i Visual Basic), konstruktor (metoda), destruktor (metoda), stała
Struktura (konstrukcja Struct w języku C#) metoda, właściwość (w języku C# i Visual Basic), pole, zdarzenie (w języku C# i Visual Basic), konstruktor (metoda), stała
Delegat parametr
Moduł (tylko w języku VB) metoda, właściwość, pole, zdarzenie, konstruktor, stała

Uwaga

Utwórz bardziej zwartą deklarację właściwości, gdy akcesory właściwości get i set nie potrzebują dodatkowej logiki, za pomocą automatycznie wdrożonych właściwości (tylko C#). Aby wyświetlić pełny podpis, z menu Diagram klas wybierz pozycję Zmień format składowy>Wyświetl pełny podpis. Aby uzyskać więcej informacji na temat właściwości implementowanych automatycznie, zobacz Właściwości zaimplementowane automatycznie.

Typowe zadania

Zadanie Zawartość pomocnicza
Wprowadzenie: przed utworzeniem i skonfigurowaniem składowych typów należy otworzyć okno Szczegóły klasy. - Otwórz okno Szczegóły klasy
- Informacje o użyciu szczegółów klasy
- Wyświetlanie informacji tylko do odczytu
- Skróty klawiaturowe i myszy w oknie Diagram klas i Szczegóły klasy
Tworzenie i modyfikowanie składowych typów: możesz tworzyć nowe elementy członkowskie, modyfikować elementy członkowskie i dodawać parametry do metody przy użyciu okna Szczegóły klasy. - Tworzenie członków
- Modyfikowanie składowych typów
- Dodawanie parametrów do metod

Otwórz okno Szczegóły klasy

Domyślnie okno Szczegóły klasy jest wyświetlane automatycznie po otwarciu nowego diagramu klas. Zobacz Dodawanie diagramów klas do projektów). Możesz również otworzyć okno Szczegóły klasy w następujący sposób:

  • Kliknij prawym przyciskiem myszy dowolną klasę na diagramie, aby wyświetlić menu kontekstowe, a następnie wybierz pozycję Szczegóły klasy.

  • Wybierz pozycję Wyświetl>inne szczegóły klasy systemu Windows>na pasku menu.

Tworzenie członków

Można utworzyć element członkowski, używając dowolnego z następujących narzędzi:

  • Projektant klas

  • Pasek narzędzi okna Szczegóły klasy

  • Okno Szczegóły klasy

Uwaga

Można również utworzyć konstruktory i destruktory przy użyciu procedur opisanych w tej sekcji. Należy pamiętać, że konstruktory i destruktory są specjalnymi rodzajami metod, a w związku z tym są one wyświetlane w przedziale Metody w kształtach diagramu klas i w sekcji Metody siatki okna Szczegóły klasy.

Uwaga

Jedyna jednostka, jaką można dodać do obiektu delegowanego, to parametr. Należy pamiętać, że procedura zatytułowana "Aby utworzyć składową przy użyciu paska narzędzi okna Szczegóły klasy" jest nieprawidłowa dla tej akcji.

Tworzenie elementu członkowskiego przy użyciu Projektant klasy

  1. Kliknij prawym przyciskiem myszy typ, do którego chcesz dodać element członkowski, wskaż polecenie Dodaj, a następnie wybierz typ elementu członkowskiego, który chcesz dodać.

    Nowa sygnatura elementu członkowskiego jest tworzona i dodawana do typu. Ma on nazwę domyślną, którą można zmienić w klasie Projektant, w oknie Szczegóły klasy lub w oknie Właściwości.

  2. Opcjonalnie określ inne szczegóły dotyczące elementu członkowskiego, takie jak jego typ.

Tworzenie elementu członkowskiego przy użyciu paska narzędzi okna Szczegóły klasy

  1. Na powierzchni diagramu wybierz typ, do którego chcesz dodać element członkowski.

    Typ uzyskuje fokus i jego zawartość są wyświetlane w oknie Szczegóły klasy.

  2. Na pasku narzędzi Szczegóły klasy kliknij górną ikonę i wybierz pozycję Nowy <element członkowski> z listy rozwijanej.

    Kursor przechodzi do pola Nazwa w wierszu dla rodzaju elementu członkowskiego, który chcesz dodać. Jeśli na przykład klikniesz pozycję Nowa właściwość, kursor zostanie przeniesiony do nowego wiersza w sekcji Właściwości okna Szczegóły klasy.

  3. Wpisz nazwę elementu członkowskiego, który chcesz utworzyć, i naciśnij klawisz Enter (lub przenieś fokus w inny sposób, np. za pomocą klawisza Tab).

    Nowa sygnatura elementu członkowskiego jest tworzona i dodawana do typu. Element członkowski istnieje teraz w kodzie i jest wyświetlany w klasie Projektant, oknie Szczegóły klasy i okno Właściwości.

  4. Opcjonalnie określ inne szczegóły dotyczące elementu członkowskiego, takie jak jego typ.

Tworzenie elementu członkowskiego przy użyciu okna Szczegóły klasy

  1. Na powierzchni diagramu wybierz typ, do którego chcesz dodać element członkowski.

    Typ uzyskuje fokus i jego zawartość są wyświetlane w oknie Szczegóły klasy.

  2. W oknie Szczegóły klasy w sekcji zawierającej rodzaj elementu członkowskiego, który chcesz dodać, kliknij przycisk< dodaj element członkowski>. Jeśli na przykład chcesz dodać pole, kliknij pozycję Dodaj pole>.<

  3. Wpisz nazwę elementu członkowskiego, który chcesz utworzyć, a następnie naciśnij klawisz Enter.

    Nowa sygnatura elementu członkowskiego jest tworzona i dodawana do typu. Element członkowski istnieje teraz w kodzie i jest wyświetlany w Projektant Klasy, oknie Szczegóły klasy i okno Właściwości.

  4. Opcjonalnie określ inne szczegóły dotyczące elementu członkowskiego, takie jak jego typ.

    Uwaga

    Możesz również użyć skrótów klawiaturowych do tworzenia członków. Aby uzyskać więcej informacji, zobacz Skróty klawiaturowe i myszy w oknie Diagram klas i Szczegóły klasy.

Modyfikowanie składowych typów

Projektant klas umożliwia modyfikowanie składowych typów, które są wyświetlane na diagramie. Można modyfikować składowe dowolnego typu wyświetlane na diagramie klasy, które nie są tylko do odczytu. Elementy członkowskie typów można modyfikować przy użyciu edycji w miejscu na powierzchni projektowej, okno Właściwości i w oknie Szczegóły klasy.

Wszystkie elementy członkowskie wyświetlane w oknie Szczegóły klasy reprezentują elementy członkowskie typów na diagramie klas. Istnieją cztery rodzaje elementów członkowskich: metody, właściwości, pola i zdarzenia.

Wszystkie wiersze elementów członkowskich pojawiają się pod nagłówkami, które grupują elementy członkowskie według rodzaju. Na przykład wszystkie właściwości są wyświetlane pod nagłówkiem Właściwości, które jako węzeł w siatce można zwinąć lub rozwinąć.

Każdy wiersz elementu członkowskiego zawiera następujące elementy:

  • Ikona elementu członkowskiego

    Każdy rodzaj elementu członkowskiego jest reprezentowany przez własną ikonę. Wskaż wskaźnik myszy na ikonę elementu członkowskiego, aby wyświetlić podpis członka. Kliknij ikonę elementu członkowskiego lub przestrzeń z lewej strony ikony elementu członkowskiego, aby zaznaczyć wiersz.

  • Nazwa elementu członkowskiego

    Kolumna Nazwa w wierszu elementu członkowskiego wyświetla nazwę elementu członkowskiego. Ta nazwa jest również wyświetlana we właściwości Name w okno Właściwości. Ta komórka służy do zmiany nazwy któregokolwiek elementu członkowskiego, który ma uprawnienia odczytu i zapisu.

    Jeśli kolumna Nazwa jest zbyt wąska, aby wyświetlić całą nazwę, wskazanie myszy na nazwie elementu członkowskiego spowoduje wyświetlenie całej nazwy.

  • Typ elementu członkowskiego

    Komórka MemberType używa funkcji IntelliSense, która umożliwia wybranie z listy wszystkich typów dostępnych w bieżącym projekcie lub przywoływałych projektów.

  • Modyfikator składowych

    Zmień modyfikator widoczności elementu członkowskiego na Public (), (), Private (private), FriendinternalProtected (protected), () () Protected Friend lub Defaultprotected internal.public

  • <dodawanie elementu członkowskiego>

    Ostatni wiersz w oknie Szczegóły klasy zawiera tekst dodawania< elementu członkowskiego> w komórce Nazwa. Po kliknięciu tej komórki, można utworzyć nowy element członkowski. Aby uzyskać więcej informacji, zobacz Tworzenie członków.

  • Właściwości elementu członkowskiego w okno Właściwości

    W oknie Szczegóły klasy zostanie wyświetlony podzbiór właściwości składowych wyświetlanych w okno Właściwości. Zmiana właściwości w jednej lokalizacji zaktualizuje globalnie wartość właściwości. Obejmuje to wyświetlanie jej wartości w innej lokalizacji.

  • Podsumowanie

    Komórka Podsumowanie uwidacznia podsumowanie informacji o elemencie członkowskim. Kliknij wielokropek w komórce Podsumowanie, aby wyświetlić lub edytować informacje o podsumowaniu, typie zwracaniu i uwagach dla elementu członkowskiego.

  • Ukryj

    Po zaznaczeniu pola wyboru Ukryj element członkowski nie jest wyświetlany w typie.

Aby zmodyfikować element członkowski typu

  1. Za pomocą Projektanta klas, wybierz typ.

  2. Jeśli okno Szczegóły klasy nie jest wyświetlane, kliknij przycisk Szczegóły klasy na pasku narzędzi Klasa Projektant.

  3. Edytuj wartości w polach siatki okna Szczegóły klasy. Po każdej modyfikacji naciśnij klawisz ENTER lub w inny sposób przenieś fokus kursora z edytowanego pola, na przykład, naciskając klawisz TAB. Zmiany odzwierciedlają się bezpośrednio w kodzie.

    Uwaga

    Jeśli chcesz zmodyfikować jedynie nazwę elementu członkowskiego, możesz to zrobić za pomocą edycji w miejscu.

Dodawanie parametrów do metod

Dodaj parametry do metod przy użyciu okna Szczegóły klasy. Parametry mogą być skonfigurowane jako wymagane lub opcjonalne. Podanie wartości opcjonalnej właściwości Default parametru powoduje, że projektant wygeneruje kod jako opcjonalny parametr.

Wiersze parametrów zawierają następujące elementy:

  • Nazwa/nazwisko

    Kolumna Name w wierszu parametru wyświetla nazwę parametru. Ta nazwa jest również wyświetlana we właściwości Name w okno Właściwości. Ta komórka służy do zmiany nazwy któregokolwiek parametru, który ma uprawnienia odczytu i zapisu.

    Wskazanie nazwy parametru powoduje wyświetlenie nazwy parametru, jeśli kolumna Name jest zbyt zawężona, aby wyświetlić całą nazwę.

  • Type

    Komórka Typ parametru używa funkcji IntelliSense, która umożliwia wybranie spośród listy wszystkich typów dostępnych w bieżącym projekcie lub przywoływałych projektach.

  • Modyfikator

    Komórka Modyfikator w wierszu parametru akceptuje i wyświetla nowy modyfikator parametru. Aby wprowadzić nowy modyfikator parametrów, użyj pola listy rozwijanej, aby wybrać pozycję Brak, ref, out lub params w języku C# i ByVal, ByRef lub ParamArray w języku VB.

  • Podsumowanie

    Komórka Podsumowanie w wierszu parametru umożliwia wprowadzanie komentarzy kodu wyświetlanych w funkcji IntelliSense podczas wprowadzania parametru w edytorze kodu.

  • <dodawanie parametru>

    Ostatni wiersz parametru elementu członkowskiego zawiera tekst dodawania <parametru>w komórce Nazwa . Kliknięcie tej komórki pozwala utworzyć nowy parametr. Aby uzyskać więcej informacji, zobacz Aby dodać parametr do metody.

W oknie Właściwości są wyświetlane te same właściwości parametrów wyświetlane w oknie Szczegóły klasy: Nazwa, Typ, Modyfikator, Podsumowanie, a także opcjonalna właściwość Domyślna. Zmiana właściwości w jednej lokalizacji aktualizuje globalnie wartość właściwości, włącznie z wyświetlaniem jej wartości w innej lokalizacji.

Uwaga

Aby dodać parametr do delegata, zobacz Tworzenie elementów członkowskich.

Uwaga

Chociaż destruktor jest metodą, to nie może mieć parametrów.

Aby dodać parametr do metody

  1. Na powierzchni diagramu kliknij typ zawierający metodę, do której chcesz dodać parametr.

    Typ uzyskuje fokus i jego zawartość wyświetlaną w oknie Szczegóły klasy.

  2. W oknie Szczegóły klasy rozwiń wiersz metody, do której chcesz dodać parametr.

    Zostanie wyświetlony wcięcie wiersz parametru zawierający tylko parę nawiasów, a słowa <dodają parametr>.

  3. Kliknij pozycję Dodaj parametr>, wpisz nazwę nowego parametru i naciśnij klawisz Enter.<

    Nowy parametr jest dodawany do metody i kodu metody. Zostanie on wyświetlony w oknie Szczegóły klasy i okno Właściwości.

  4. Opcjonalnie określ inne szczegóły dotyczące parametru, takie jak jego typ.

Aby dodać opcjonalny parametr do metody

  1. Na powierzchni diagramu kliknij typ zawierający metodę, do której chcesz dodać opcjonalny parametr.

    Typ uzyskuje fokus i jego zawartość wyświetlaną w oknie Szczegóły klasy.

  2. W oknie Szczegóły klasy rozwiń wiersz metody, do której chcesz dodać opcjonalny parametr.

    Zostanie wyświetlony wcięcie wiersz parametru zawierający tylko parę nawiasów, a słowa <dodają parametr>.

  3. Kliknij pozycję Dodaj parametr>, wpisz nazwę nowego parametru i naciśnij klawisz Enter.<

    Nowy parametr jest dodawany do metody i kodu metody. Zostanie on wyświetlony w oknie Szczegóły klasy i okno Właściwości.

  4. W okno Właściwości wpisz wartość właściwości Optional Default. Ustawienie właściwości Opcjonalny domyślny parametru powoduje, że ten parametr staje się opcjonalny.

    Uwaga

    Opcjonalne parametry muszą być ostatnimi parametrami na liście parametrów.

Uwagi dotyczące użycia szczegółów klasy

Zapoznaj się z poniższymi wskazówkami dotyczącymi korzystania z okna Szczegóły klasy.

Komórki edytowalne i nieedytowalne

Wszystkie komórki w oknie Szczegóły klasy można edytować z kilkoma wyjątkami:

  • Cały typ jest tylko do odczytu, gdy na przykład znajduje się w zestawie, do których się odwołuje. Po wybraniu kształtu w Projektant Klasa w oknie Szczegóły klasy zostaną wyświetlone jego szczegóły w stanie tylko do odczytu.

  • Dla indeksatorów nazwa jest tylko do odczytu, a pozostałe (typ, modyfikator, podsumowanie) są edytowalne.

  • Wszystkie typy ogólne mają parametry tylko do odczytu w oknie Szczegóły klasy. Aby zmienić parametr rodzajowy, wyedytuj jego kod źródłowy.

  • Nazwa parametru typu, który jest zdefiniowany w typie rodzajowym, jest tylko do odczytu.

  • Gdy kod typu jest uszkodzony (nierozłączalny), w oknie Szczegóły klasy zostanie wyświetlona zawartość typu jako tylko do odczytu.

Okno Szczegóły klasy i kod źródłowy

  • Kod źródłowy można wyświetlić, klikając kształt prawym przyciskiem myszy w oknie Szczegóły klasy (lub Projektant Klasy), a następnie klikając polecenie Wyświetl kod. Plik źródłowy kodu otwiera się i przewija do wybranego elementu.

  • Zmiana kodu źródłowego jest natychmiast odzwierciedlana w wyświetlaniu informacji o podpisie w Projektant Klasy i oknie Szczegóły klasy. Jeśli okno Szczegóły klasy zostanie zamknięte w tym czasie, nowe informacje będą widoczne przy następnym otwarciu.

  • Gdy kod typu jest uszkodzony (nierozłączalny), w oknie Szczegóły klasy zostanie wyświetlona zawartość typu jako tylko do odczytu.

Funkcja Schowka w oknie Szczegóły klasy

Możesz skopiować lub wyciąć pola lub wiersze z okna Szczegóły klasy i wkleić je do innego typu. Wiersz można wyciąć tylko wtedy, gdy nie jest tylko do odczytu. Po wklejeniu wiersza okno Szczegóły klasy przypisuje nową nazwę (pochodną nazwy skopiowanego wiersza), aby uniknąć konfliktu.

Wyświetlanie informacji tylko do odczytu

Projektant klas i okno Szczegóły klasy może wyświetlać typy (i składowe typów) dla następujących elementów:

  • projekt, który zawiera diagram klas

  • projekt stanowiący odwołanie z projektu, który zawiera diagram klas

  • zestaw stanowiący odwołanie z projektu, który zawiera diagram klas

W dwóch ostatnich przypadkach, jednostka, do której istnieje odwołanie (typ lub składowa), jest tylko do odczytu na diagramie klasy, który ją reprezentuje.

Cały projekt lub jego części, takie jak pojedyncze pliki, mogą być tylko do odczytu. Najbardziej typowe przypadki, w których projekt lub jeden z jego plików jest tylko do odczytu, występują wtedy, gdy projekt jest pod kontrolą kodu źródłowego (i nie jest wyewidencjonowany), istnieje w zestawie zewnętrznym, lub gdy system operacyjny uzna, że pliki są tylko do odczytu.

Kontrola kodu źródłowego

Ponieważ diagram klas jest zapisywany jako plik w projekcie, należy wyewidencjonować projekt, aby zapisać wszelkie zmiany wprowadzone w klasie Projektant lub w oknie Szczegóły klasy.

Projekty tylko do odczytu

Projekt może być tylko do odczytu z przyczyn innych niż kontrola kodu źródłowego. Zamknięcie projektu wyświetla okno dialogowe z pytaniem, czy zastąpić plik projektu, odrzucić zmiany (nie zapisać) lub anulować operację zamknięcia. Jeśli wybierzesz zastąpienie, pliki projektu są zastępowane i udostępnione do odczytu i zapisu. Dodawany jest nowy plik diagramu klasy.

Typy tylko do odczytu

Jeśli spróbujesz zapisać projekt zawierający typ, którego plik kodu źródłowego jest tylko do odczytu, zostanie wyświetlone okno dialogowe Zapisywanie pliku tylko do odczytu, co umożliwia wybranie opcji zapisania pliku pod nową nazwą lub nową lokalizacją lub zastąpienie pliku tylko do odczytu. Jeśli plik zostanie zastąpiony, nowa kopia nie będzie już tylko do odczytu.

Jeśli plik kodu zawiera błąd składni, kształty wyświetlające kod w tym pliku zostaną tymczasowo ustawione tylko do odczytu, dopóki błąd składni nie zostanie poprawiony. Kształty w tym stanie wyświetlają czerwony tekst i czerwoną ikonę, która wyświetla etykietkę z napisem „plik kodu źródłowego zawiera błąd analizy składni”.

Przywołyany typ (taki jak typ platformy .NET), który istnieje w innym węźle projektu lub w węźle zestawu, do którego odwołuje się zestaw, jest wskazywany na powierzchni projektowej Klasa Projektant jako tylko do odczytu. Typ lokalny, który istnieje w otwartym projekcie, jest do odczytu i zapisu, a jego kształt na powierzchni projektowej Projektanta klas jest odpowiednio opisany.

Indeksatory są do odczytu i zapisu w kodzie, a okno Szczegóły klasy, ale nazwa indeksatora jest tylko do odczytu.

Nie można edytować metod częściowych przy użyciu Projektant klasy lub okna Szczegóły klasy. Aby je edytować, należy użyć Edytora kodu.

Nie można edytować natywnego kodu C++ przy użyciu Projektant klasy lub okna Szczegóły klasy. Aby edytować natywny kod C++, musisz użyć Edytora kodu.

Powiązana zawartość