Tworzenie i konfigurowanie typów członków (Projektant klas)

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

Typ	Elementy członkowskie, które mogą się tam znajdować
Class	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
Interface	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
Delegate	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łną sygnaturę, w menu Diagram klas wybierz Zmień format elementów członkowskich, Wyświetl pełną sygnaturę.Aby uzyskać więcej informacji dotyczących automatycznie implementowanych właściwości, zobacz Właściwości zaimplementowane automatycznie (Przewodnik programowania w języku C#).

Typowe zadania

Zadanie	Zawartość pomocnicza
Rozpoczęcie pracy: Zanim utworzysz i skonfigurujesz elementy członkowskie typu, musisz otworzyć okno Szczegóły klasy.	Otwieranie okna Szczegóły klasy Uwagi dotyczące użycia okna Szczegóły klasy Wyświetlanie informacji tylko do odczytu Skróty przy użyciu klawiatury i myszy w oknie Diagram klas i Szczegóły klasy (Projektant klas)
Tworzenie i modyfikowanie elementów członkowskich typu: Możesz tworzyć nowe elementy członkowskie, modyfikować je i dodawać parametry do metody za pomocą okna Szczegóły klasy.	Tworzenie elementów członkowskich Modyfikowanie elementów członkowskich typu Dodawanie parametrów do metod

Tworzenie elementów członkowskich

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 to szczególne rodzaje metod i jako takie pojawiają się 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 zauważyć, że procedura „Aby utworzyć element członkowski przy użyciu paska narzędzi okna Szczegóły klasy” nie jest prawidłowa dla tej czynności.

Aby utworzyć element członkowski za pomocą Projektanta klas

1. Kliknij prawym przyciskiem myszy typ, do którego chcesz dodać element członkowski, wskaż Dodaj i kliknij Dodaj <element członkowski>.

   Nowa sygnatura elementu członkowskiego jest tworzona i dodawana do typu.Jest mu nadawana nazwa domyślna, którą można zmienić w Projektancie klas, okno Szczegóły klasy, lub w oknie dialogowym Właściwości.

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

Aby utworzyć element członkowski za pomocą 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ść jest wyświetlana w oknie Szczegóły klasy.

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

   Kursor przesuwa się do pola Nazwa w wierszu dla rodzaju elementu członkowskiego, który chcesz dodać.Na przykład, jeśli została kliknięta Nowa właściwość, kursor zostaje 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 Projektancie klas, w oknie Szczegóły klasy i w oknie Właściwości.

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

Aby utworzyć element członkowski za pomocą okna Szczegóły klasy

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

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

2. W oknie Szczegóły klasy, w sekcji zawierającej rodzaj dodawanego elementu członkowskiego, kliknij <dodaj element członkowski>.Na przykład, jeśli chcesz dodać pole, kliknij <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 Projektancie klas, w oknie Szczegóły klasy i w oknie Właściwości.

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

   Uwaga: Do tworzenia elementów członkowskich można też używać skrótów klawiaturowych.Aby uzyskać więcej informacji, zobacz Skróty przy użyciu klawiatury i myszy w oknie Diagram klas i Szczegóły klasy (Projektant klas).

Modyfikowanie elementów członkowskich typu

Projektant klas umożliwia modyfikowanie elementów członkowskich typów, które są wyświetlane na diagramie.Można modyfikować elementy członkowskie dowolnego typu wyświetlane na diagramie klasy, które nie są tylko do odczytu. (Zobacz Display of Read-Only Information). Elementy członkowskie typu modyfikuje się za pomocą edycji w miejscu na powierzchni projektowej, w oknie 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 klasy.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óry, jako węzeł w siatce, może być zwijany i rozwijany.

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ż myszą ikonę elementu członkowskiego, aby wyświetlić sygnaturę elementu członkowskiego.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 jego nazwę.Ta nazwa jest także wyświetlana we właściwości Nazwa w oknie 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 myszą na nazwę elementu członkowskiego powoduje wyświetlenie całej nazwy.

• Typ elementu członkowskiego

  Komórka Element członkowskiTyp korzysta z technologii IntelliSense, która pozwala na wybranie z listy wszystkich typów dostępnych w bieżącym projekcie lub w projektach odwołania.

• Modyfikator elementu członkowskiego

  Zmień modyfikator widoczności elementy członkowskiego na Public (public), Private (private), Friend (internal) Protected (protected), ProtectedFriend (protectedinternal) lub Default.

• <dodaj element członkowski>

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

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

  Okno Szczegóły klasy zawiera podzbiór właściwości elementów członkowskich, które są wyświetlane w oknie 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 dotyczących elementu członkowskiego.Kliknij przycisk wielokropka w komórce Podsumowanie, aby wyświetlić lub edytować informacje o Podsumowaniu, Typie zwracanym i Uwagach dla elementu członkowskiego.

• Ukryj

  Gdy pole wyboru Ukryj jest zaznaczone, element członkowski nie jest wyświetlany w polu Typ.

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 Okno Szczegóły klasy na pasku narzędzi Projektanta klas.

3. Edytuj wartości w polach w siatce 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 dla właściwości Opcjonalny domyślny parametru powoduje, że projektant generuje kod jako parametr opcjonalny.

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

• Name

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

  Wskazanie myszą na nazwę parametru powoduje wyświetlenie jego nazwy, jeśli kolumna Nazwa jest zbyt wąska, aby wyświetlić całą nazwę.

• Typ

  Komórka Typ parametru korzysta z technologii IntelliSense, która pozwala na wybranie z listy wszystkich typów dostępnych w bieżącym projekcie lub w projektach odwołania.

• Modyfikator

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

• Podsumowanie

  Komórka Podsumowanie w wierszu parametru umożliwia wprowadzanie komentarzy do kodu, które są wyświetlane w IntelliSense podczas wprowadzania parametru w edytorze kodu.

• <dodaj parametr>

  Ostatni wiersz parametru elementu członkowskiego zawiera tekst <dodaj parametr> 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łaściwości parametru w oknie Właściwości

Okno Właściwości wyświetla te same właściwości parametru, co wyświetlane w oknie Szczegóły klasy: Nazwa, Typ, Modyfikator, Podsumowanie, jak również właściwość Opcjonalny domyślny.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 obiektu delegującego, 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świetla się w oknie Szczegóły klasy.

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

   Pojawi się wiersz parametru z wcięciem, zawierający tylko parę nawiasów i wyrazy <dodaj parametr>.

3. Kliknij <dodaj parametr>, wpisz nazwę nowego parametru, a następnie naciśnij klawisz Enter.

   Nowy parametr jest dodawany do metody i kodu metody.Wyświetla się w oknie Szczegóły klasy i w oknie 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świetla się w oknie Szczegóły klasy.

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

   Pojawi się wiersz parametru z wcięciem, zawierający tylko parę nawiasów i wyrazy <dodaj parametr>.

3. Kliknij <dodaj parametr>, wpisz nazwę nowego parametru, a następnie naciśnij klawisz Enter.

   Nowy parametr jest dodawany do metody i kodu metody.Wyświetla się w oknie Szczegóły klasy i w oknie Właściwości.

4. W oknie Właściwości wpisz wartość dla właściwości Opcjonalny domyślny.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.

Otwieranie okna Szczegóły klasy

Domyślnie, okno Szczegóły klasy pojawia się automatycznie po otwarciu nowego diagramu klas (zobacz Porady: dodawanie diagramów klasy do projektu (Projektant klas)).Okno Szczegóły klasy można otworzyć także jawnie, w następujący sposób.

Aby otworzyć okno Szczegóły klasy

1. Kliknij prawym przyciskiem myszy powierzchnię diagramu klasy, aby wyświetlić menu kontekstowe.

2. W menu kontekstowym kliknij Okno Szczegóły klasy.

— lub —

• Wskaż Inne okna w menu Widok, a następnie kliknij polecenie Szczegóły klasy.

Uwagi dotyczące użycia okna Szczegóły klasy

Zwróć uwagę na poniższe porady dotyczące korzystania z okna Szczegóły klasy.

Komórki edytowalne i nieedytowalne

Wszystkie komórki w oknie Szczegóły klasy są edytowalne, z kilkoma wyjątkami:

• Cały typ jest tylko do odczytu, kiedy, na przykład, znajduje się w zestawie odwołania (zobacz Display of Read-Only Information.) Po zaznaczeniu kształtu w Konstruktorze klasy, okno Szczegóły klasy wyświetla 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 elementy rodzajowe 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.

• Jeżeli kod typu jest uszkodzony (błędny), zawartość typu jest wyświetlana w oknie Szczegóły klasy jako tylko do odczytu.

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

• Możesz wyświetlić kod źródłowy, klikając prawym przyciskiem myszy kształt w oknie Szczegóły klasy (lub Projektant klasy), a następnie klikając przycisk 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 sygnatury w Projektancie klas i w oknie Szczegóły klasy.Jeśli okno Szczegóły klasy jest akurat zamknięte, nowe informacje są widoczne przy następnym otwarciu.

• Jeżeli kod typu jest uszkodzony (błędny), zawartość typu jest wyświetlana w oknie Szczegóły klasy jako tylko do odczytu.

Funkcja schowka w oknie Szczegóły klasy.

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

Wyświetlanie informacji tylko do odczytu

Projektant klasy i okno Szczegóły klasy mogą wyświetlać typy (i elementy członkowskie 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 element członkowski), 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ć zmiany wprowadzone w Projektancie klas lub 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 zapisywać), czy 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

Podczas próby zapisania projektu zawierającego typ, którego plik kodu źródłowego jest tylko do odczytu, pojawi się okno dialogowe Zapis pliku tylko do odczytu, które daje wybór, czy zapisać plik pod nową nazwą lub w nowej lokalizacji, lub czy zastąpić plik 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”.

Odwołanie typu (np. typ .NET Framework), które występuje w obszarze innego węzła projektu lub węzła odwołania do zestawu, jest wskazany na powierzchni projektowej Projektanta klas 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 i oknie Szczegóły klasy, ale nazwa indeksatora jest tylko do odczytu.

Metod częściowych nie można edytować za pomocą Projektanta klas lub okna Szczegóły klasy; do ich edycji należy użyć Edytora kodu.

Macierzystego kodu C++ nie można edytować za pomocą Projektanta klas lub okna Szczegóły klasy; do jego edycji należy użyć Edytora kodu.

Tematy pokrewne

Tytuł	Opis
Wyświetlanie typów i relacji (Projektant klas)	Na diagramie klasy można wyświetlić istniejące typy, elementy członkowskie i relacje.
Refaktoryzacja klas i typów (Projektant klas)	Za pomocą refaktoryzacji można łatwo zmienić typ i elementy członkowskie typu.Można także przenosić elementy między klasami, podzielić klasę na klasy częściowe i implementować interfejsy.