Criar um tipo anulável no Class Designer

Certos tipos de valor nem sempre têm (ou precisam) de um valor definido. Esta é uma prática comum em bancos de dados, onde alguns campos podem não receber nenhum valor. Por exemplo, você pode atribuir um valor nulo a um campo de banco de dados para indicar que ainda não foi atribuído um valor.

Um tipo anulável é um tipo de valor que você estende para que ele tome o intervalo típico de valores para esse tipo e também um valor nulo. Por exemplo, um anulável de Int32, também indicado como Nullable<Int32>, pode ser atribuído qualquer valor de -2147483648 a 2147483647, ou pode ser atribuído um valor nulo. Um Nullable< bool> pode ter atribuídos os valores True, False, ou null (nenhum valor).

Tipos anuláveis são instâncias da Nullable<T> estrutura. Cada instância de um tipo anulável tem duas propriedades públicas somente leitura, HasValue e Value.

• HasValue é do tipo bool e indica se a variável contém um valor definido. True significa que a variável contém um valor não nulo. Você pode testar um valor definido usando uma instrução como if (x.HasValue) ou if (y != null).

• Value é do mesmo tipo que o tipo subjacente. Se HasValue é True, Value contém um valor significativo. Se HasValue é False, aceder a Value lançará uma exceção de operação inválida.

Por padrão, quando você declara uma variável como um tipo anulável, ela não tem nenhum valor definido (HasValue is False), além do valor padrão de seu tipo de valor subjacente.

O Designer de Classes exibe um tipo anulável da mesma forma que exibe o seu tipo subjacente.

Para obter mais informações sobre tipos anuláveis em C#, consulte Tipos anuláveis. Para obter mais informações sobre tipos anuláveis no Visual Basic, consulte Nullable Value Types.

Para adicionar um tipo anulável usando o Class Designer

1. No diagrama de classes, expanda uma classe existente ou crie uma nova classe.

2. Para adicionar uma classe ao projeto, no menu Diagrama de Classes , clique em Adicionar>Adicionar Classe.

3. Para expandir a forma de classe, no menu Diagrama de Classe , clique em Expandir.

4. Selecione a forma da classe. No menu Diagrama de Classes , clique em Adicionar>Campo. Um novo campo com o nome padrão Campo aparecerá na forma de classe e também na janela Detalhes da classe .

5. Na coluna Nome da janela Detalhes da classe (ou na própria forma da classe), altere o nome do novo campo para um nome válido e significativo.

6. Na coluna Tipo da janela Detalhes da classe , declare o tipo como um tipo anulável especificando o seguinte:

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

Para adicionar um tipo anulável usando o Editor de Códigos

1. Adicione uma classe ao projeto. Selecione o nó do projeto no Gerenciador de Soluções e, no menu Projeto , clique em Adicionar Classe.

2. No arquivo .cs ou .vb para a nova classe, adicione um ou mais tipos anuláveis na nova classe à declaração de classe.

   • C#
   • VB

   // Declare a nullable type in Visual C#:
   class Test
   {
      int? building_number = 5;
   }
   

3. Na Vista da Classe, arraste o novo ícone de classe para a área de trabalho do Designer de Classe. Uma forma de classe aparece no diagrama de classes.

4. Expanda os detalhes da forma de classe e mova o ponteiro do mouse sobre os membros da classe. A dica de ferramenta exibe a declaração de cada membro.

5. Clique com o botão direito do rato na forma da classe e clique em Detalhes da Classe. Você pode exibir ou modificar as propriedades do novo tipo na janela Detalhes da classe .

Conteúdo relacionado

• Nullable<T>
• Tipos anuláveis
• Usando tipos anuláveis
• Identificar um tipo anulável
• Tipos de valor anulável