Criar um tipo anulável no Designer de Classe

Determinados tipos de valor nem sempre têm (ou precisam) um valor definido. Essa é uma prática comum em bancos de dados, em que alguns campos podem não receber nenhum valor. Por exemplo, você pode atribuir um valor nulo a um campo de banco de dados para significar que ele ainda não recebeu um valor.

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

Tipos que permitem valor nulo são instâncias da Nullable<T> estrutura. Cada instância de um tipo anulável possui duas propriedades somente leitura públicas, 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 for False, acessar 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 é False), diferente do valor padrão de seu tipo de valor subjacente.

O Designer de Classe exibe um tipo anulável da mesma forma que exibe 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 Tipos de Valor Anuláveis.

Para adicionar um tipo anulável usando o Designer de Classe

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

2. Para adicionar uma classe ao projeto, no menu Diagrama de Classe , clique em 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 Classe , clique em Adicionar>Campo. Um novo campo que tem o nome padrão Campo será exibido na forma da classe e também na janela Detalhes da Classe .

5. Na coluna Nome da janela Detalhes da Classe (ou na própria forma de 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ódigo

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 da 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 Visualização de Classe, arraste o ícone da nova classe para a área de design do Designer de Classe. Uma forma de classe aparece no diagrama de classe.

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

5. Clique com o botão direito do mouse 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 nulo
• Tipos de valor anuláveis