Tworzenie typu dopuszczalnego do wartości null w Projektant klasy

Niektóre typy wartości nie zawsze mają (lub potrzebują) zdefiniowanej wartości. Jest to powszechna praktyka w bazach danych, w której niektóre pola mogą nie mieć przypisanej żadnej wartości. Możesz na przykład przypisać wartość null do pola bazy danych, aby oznaczyć, że nie została jeszcze przypisana wartość.

Typ dopuszczający wartość null jest typem wartości, który rozszerza się, tak aby pobierał typowy zakres wartości dla tego typu, a także wartość null. Na przykład można przypisać dowolną wartość z parametru Int32-2147483648 do 2147483647 lub przypisać wartość null jako null<int32>. Wartość logiczna dopuszczana do<wartości null można przypisać wartości True, Falselub null (bez wartości w ogóle).>

Typy dopuszczane do wartości null to wystąpienia Nullable<T> struktury. Każde wystąpienie typu dopuszczalnego wartości null ma dwie publiczne właściwości tylko do odczytu i HasValueValue:

  • HasValue jest typu bool i wskazuje, czy zmienna zawiera zdefiniowaną wartość. True oznacza, że zmienna zawiera wartość inną niż null. Możesz przetestować zdefiniowaną wartość przy użyciu instrukcji , takiej jak if (x.HasValue) lub if (y != null).

  • Value jest tego samego typu co typ bazowy. Jeśli HasValue parametr ma Truewartość , Value zawiera zrozumiałą wartość. Jeśli HasValue parametr to False, uzyskanie Value dostępu spowoduje zgłoszenie nieprawidłowego wyjątku operacji.

Domyślnie podczas deklarowania zmiennej jako typu dopuszczalnego wartości null nie ma zdefiniowanej wartości (HasValue to False), innej niż domyślna wartość bazowego typu wartości.

Klasa Projektant wyświetla typ dopuszczający wartość null, tak jak wyświetla jego typ bazowy.

Aby uzyskać więcej informacji na temat typów dopuszczanych do wartości null w języku C#, zobacz Typy dopuszczane do wartości null. Aby uzyskać więcej informacji na temat typów dopuszczanych do wartości null w Visual Basic, zobacz Typy wartości dopuszczanych do wartości null.

Uwaga

Na komputerze mogą być wyświetlane różne nazwy lub lokalizacje niektórych elementów interfejsu użytkownika programu Visual Studio w tym artykule. Być może używasz innej wersji programu Visual Studio lub innych ustawień środowiska. Aby uzyskać więcej informacji, zobacz Personalizowanie środowiska IDE.

Aby dodać typ dopuszczalny do wartości null przy użyciu Projektant klasy

  1. Na diagramie klas rozwiń istniejącą klasę lub utwórz nową klasę.

  2. Aby dodać klasę do projektu, w menu Diagram klas kliknij pozycję Dodaj>klasę.

  3. Aby rozwinąć kształt klasy, w menu Diagram klas kliknij pozycję Rozwiń.

  4. Wybierz kształt klasy. W menu Diagram klas kliknij pozycję Dodaj>pole. Nowe pole o domyślnej nazwie Pole pojawi się w kształcie klasy, a także w oknie Szczegóły klasy.

  5. W kolumnie Nazwa okna Szczegóły klasy (lub w samym kształcie klasy) zmień nazwę nowego pola na prawidłową i zrozumiałą nazwę.

  6. W kolumnie Typ okna Szczegóły klasy zadeklaruj typ jako typ dopuszczający wartość null, określając następujące elementy:

    • int? (Visual C#)
    • Nullable(Of Integer) (Visual Basic)

Aby dodać typ dopuszczalny do wartości null przy użyciu Edytora kodu

  1. Dodaj klasę do projektu. Wybierz węzeł projektu w Eksplorator rozwiązań, a następnie w menu Projekt kliknij pozycję Dodaj klasę.

  2. W pliku .cs lub .vb dla nowej klasy dodaj co najmniej jeden typ dopuszczalny do wartości null w nowej klasie do deklaracji klasy.

    // Declare a nullable type in Visual C#:
    class Test
    {
       int? building_number = 5;
    }
    
  3. Z widoku klasy przeciągnij ikonę nowej klasy do powierzchni projektowej Klasa Projektant. Kształt klasy jest wyświetlany na diagramie klasy.

  4. Rozwiń szczegóły kształtu klasy i przesuń wskaźnik myszy nad składowych klasy. Etykietka narzędzia wyświetla deklarację każdego elementu członkowskiego.

  5. Kliknij prawym przyciskiem myszy kształt klasy i kliknij pozycję Szczegóły klasy. Właściwości nowego typu można wyświetlić lub zmodyfikować w oknie Szczegóły klasy.