Tipos de valor anuláveis (Visual Basic)

2025-06-19

Às vezes, você trabalha com um tipo de valor que não tem um valor definido em determinadas circunstâncias. Por exemplo, um campo em um banco de dados pode ter que distinguir entre ter um valor atribuído que seja significativo e não ter um valor atribuído. Os tipos de valor podem ser estendidos para usar seus valores normais ou um valor nulo. Essa extensão é chamada de tipo anulável.

Cada tipo de valor anulável é construído a partir da estrutura genérica Nullable<T> . Considere um banco de dados que rastreia atividades relacionadas ao trabalho. O exemplo a seguir constrói um tipo anulável Boolean e declara uma variável desse tipo. Você pode escrever a declaração de três maneiras:

Dim ridesBusToWork1? As Boolean
Dim ridesBusToWork2 As Boolean?
Dim ridesBusToWork3 As Nullable(Of Boolean)

A variável ridesBusToWork pode conter um valor de True, um valor de False, ou nenhum valor. O valor padrão inicial dela é nenhum valor, o que, nesse caso, pode significar que as informações ainda não foram obtidas para essa pessoa. Por outro lado, False pode significar que as informações foram obtidas e que a pessoa não anda de ônibus para o trabalho.

Você pode declarar variáveis e propriedades com tipos de valor anuláveis e declarar uma matriz com elementos de um tipo de valor anulável. Você pode declarar procedimentos com tipos de valor anuláveis como parâmetros e pode retornar um tipo de valor anulável de um Function procedimento.

Não é possível construir um tipo anulável em um tipo de referência, como uma matriz, uma Stringou uma classe. O tipo subjacente deve ser um tipo de valor. Para obter mais informações, consulte tipos de valor e tipos de referência.

Usando uma variável de tipo anulável

Os membros mais importantes de um tipo de valor anulável são suas propriedades HasValue e Value. Para uma variável de um tipo de valor anulável, HasValue informa se a variável contém um valor definido. Se HasValue estiver True, você pode ler o valor de Value. Observe que ambas HasValue e Value são ReadOnly propriedades.

Valores padrão

Quando você declara uma variável com um tipo de valor anulável, sua HasValue propriedade tem um valor padrão de False. Isso significa que, por padrão, a variável não tem nenhum valor definido, em vez do valor padrão de seu tipo de valor subjacente. No exemplo a seguir, a variável numberOfChildren inicialmente não tem nenhum valor definido, embora o valor padrão do Integer tipo seja 0.

Dim numberOfChildren? As Integer

Um valor nulo é útil para indicar um valor indefinido ou desconhecido. Se numberOfChildren tivesse sido declarado como Integer, não haveria nenhum valor que pudesse indicar que as informações não estão disponíveis no momento.

Armazenando valores

Você armazena um valor em uma variável ou propriedade de um tipo de valor anulável da maneira típica. O exemplo a seguir atribui um valor à variável numberOfChildren declarada no exemplo anterior.

numberOfChildren = 2

Se uma variável ou propriedade de um tipo de valor anulável contiver um valor definido, você poderá fazer com que ele reverta para seu estado inicial de não ter um valor atribuído. Você faz isso definindo a variável ou a propriedade como Nothing, como mostra o exemplo a seguir.

numberOfChildren = Nothing

Observação

Embora você possa atribuir Nothing a uma variável de um tipo de valor anulável, não é possível testá-la para Nothing com o sinal de igual. Comparação que usa o sinal de igual, someVar = Nothingsempre é avaliada como Nothing. Você pode testar a propriedade HasValue da variável False, ou testar usando o operador Is ou IsNot.

Recuperando valores

Para recuperar o valor de uma variável de um tipo de valor anulável, primeiro você deve testar sua HasValue propriedade para confirmar que ela tem um valor. Se você tentar ler o valor quando HasValue estiver False, o Visual Basic gerará uma exceção InvalidOperationException . O exemplo a seguir mostra a maneira recomendada de ler a variável numberOfChildren dos exemplos anteriores.

If numberOfChildren.HasValue Then
    MsgBox("There are " & CStr(numberOfChildren) & " children.")
Else
    MsgBox("It is not known how many children there are.")
End If

Comparando Tipos que Permitem Valores Nulos

Quando variáveis anuláveis Boolean são usadas em expressões boolianas, o resultado pode ser True, Falseou Nothing. A seguir está a tabela de verdade para And e Or. Como b1 e b2 agora têm três valores possíveis, há nove combinações a serem avaliadas.

b1	b2	b1 E b2	b1 Ou b2
`Nothing`	`Nothing`	`Nothing`	`Nothing`
`Nothing`	`True`	`Nothing`	`True`
`Nothing`	`False`	`False`	`Nothing`
`True`	`Nothing`	`Nothing`	`True`
`True`	`True`	`True`	`True`
`True`	`False`	`False`	`True`
`False`	`Nothing`	`False`	`Nothing`
`False`	`True`	`False`	`True`
`False`	`False`	`False`	`False`

Quando o valor de uma variável booliana ou expressão é Nothing, ele não é nem true nem false. Considere o exemplo a seguir.

Dim b1? As Boolean
Dim b2? As Boolean
b1 = True
b2 = Nothing

' The following If statement displays "Expression is not true".
If (b1 And b2) Then
    Console.WriteLine("Expression is true")
Else
    Console.WriteLine("Expression is not true")
End If

' The following If statement displays "Expression is not false".
If Not (b1 And b2) Then
    Console.WriteLine("Expression is false")
Else
    Console.WriteLine("Expression is not false")
End If

Neste exemplo, b1 And b2 é avaliado como Nothing. Como resultado, a Else cláusula é executada em cada If instrução e a saída é a seguinte:

Expression is not true

Expression is not false

Observação

AndAlso e OrElse, que usam a avaliação de curto-circuito, precisam avaliar os segundos operandos quando o primeiro for avaliado como Nothing.

Propagação

Se um ou ambos os operandos de uma operação aritmética, de comparação, de deslocamento ou de tipo for um tipo de valor anulável, o resultado da operação também será um tipo de valor anulável. Se ambos os operandos contiverem valores que não sejam Nothing, a operação será realizada diretamente sobre os valores próprios dos operandos, como se nenhum deles fosse de tipo de valor anulável. No exemplo a seguir, as variáveis compare1 e sum1 são digitadas implicitamente. Se você descansar o ponteiro do mouse sobre elas, verá que o compilador infere tipos de valor anuláveis para ambas.

' Variable n is a nullable type, but both m and n have proper values.
Dim m As Integer = 3
Dim n? As Integer = 2

' The comparison evaluated is 3 > 2, but compare1 is inferred to be of 
' type Boolean?.
Dim compare1 = m > n
' The values summed are 3 and 2, but sum1 is inferred to be of type Integer?.
Dim sum1 = m + n

' The following line displays: 3 * 2 * 5 * True
Console.WriteLine($"{m} * {n} * {sum1} * {compare1}")

Se um ou ambos os operandos tiverem um valor de Nothing, o resultado será Nothing.

' Change the value of n to Nothing.
n = Nothing

Dim compare2 = m > n
Dim sum2 = m + n

' Because the values of n, compare2, and sum2 are all Nothing, the
' following line displays: 3 * <null> * <null> * <null>
Console.WriteLine($"{m} * {If(n, "<null>")} * {If(sum2, "<null>")} * {If(compare2, "<null>")}")

Usando tipos anuláveis com dados

Um banco de dados é um dos locais mais importantes para usar tipos de valor anuláveis. Nem todos os objetos de banco de dados atualmente suportam tipos de valor anuláveis, mas os adaptadores de tabela gerados pelo designer sim. Consulte o suporte do TableAdapter para tipos anuláveis.

Compartilhar via