Lista de tipos (Visual Basic)
Especifica os parâmetros de tipo para um elemento de programação genérico. Vários parâmetros são separados por vírgulas. A sintaxe de um parâmetro de tipo está apresentada a seguir.
Sintaxe
[genericmodifier] typename [ As constraintlist ]
Partes
Termo | Definição |
---|---|
genericmodifier |
Opcional. Pode ser usado somente em interfaces genéricas e delegados. Você pode declarar um tipo covariante usando a palavra-chave Out ou contravariante usando a palavra-chave In. Consulte Covariância e contravariância. |
typename |
Obrigatórios. Nome do parâmetro de tipo. Esse é um espaço reservado, a ser substituído por um tipo definido fornecido pelo argumento de tipo correspondente. |
constraintlist |
Opcional. Lista de requisitos que restringem o tipo de dados que pode ser fornecido para typename . Se você tiver várias restrições, coloque-as entre chaves ({ } ) e separe-as com vírgulas. Você deve introduzir a lista de restrições com a palavra-chave As. Você usa As apenas uma vez, no início da lista. |
Comentários
Cada elemento de programação genérico deve ter pelo menos um parâmetro de tipo. Um parâmetro de tipo é um espaço reservado para um tipo específico (um elemento construído) que o código do cliente especifica quando cria uma instância do tipo genérico. Você pode definir uma classe genérica, estrutura, interface, procedimento ou delegado.
Para obter mais informações sobre quando definir um tipo genérico, confira Tipos Genéricos no Visual Basic. Para obter mais informações sobre nomes de parâmetro de tipo, confira Nomes de Elementos Declarados.
Regras
Parênteses. Se você fornecer uma lista de parâmetros de tipo, deverá colocá-la entre parênteses e apresentar a lista com a palavra-chave Of. Você usa
Of
apenas uma vez, no início da lista.Restrições. Uma lista de restrições em um parâmetro de tipo pode incluir os seguintes itens em qualquer combinação:
Qualquer número de interfaces. O tipo fornecido deve implementar todas as interfaces nesta lista.
No máximo uma classe. O tipo fornecido deve herdar dessa classe.
A palavra-chave
New
. O tipo fornecido deve expor um construtor sem parâmetros que o tipo genérico pode acessar. Isso será útil se você restringir um parâmetro de tipo por uma ou mais interfaces. Um tipo que implementa interfaces não necessariamente expõe um construtor e, dependendo do nível de acesso de um construtor, o código dentro do tipo genérico pode não ser capaz de acessá-lo.A palavra-chave
Class
ouStructure
. A palavra-chaveClass
restringe um parâmetro de tipo genérico para exigir que o argumento de tipo passado para ele seja um tipo de referência, como cadeia de caracteres, matriz ou delegado ou um objeto criado por meio de uma classe. A palavra-chaveStructure
restringe um parâmetro de tipo genérico para exigir que o argumento de tipo passado para ele seja um tipo de valor, como estrutura, enumeração ou tipo de dados elementar. Você não pode incluirClass
eStructure
no mesmoconstraintlist
.
O tipo fornecido deve atender a todos os requisitos que você incluir em
constraintlist
.Restrições em cada parâmetro de tipo são independentes de restrições em outros parâmetros de tipo.
Comportamento
Substituição do tempo de compilação. Ao criar um tipo construído por meio de um elemento de programação genérico, você fornece um tipo definido para cada parâmetro de tipo. O compilador do Visual Basic substitui o tipo fornecido para cada ocorrência de
typename
dentro do elemento genérico.Ausência de restrições. Se você não especificar nenhuma restrição em um parâmetro de tipo, o código será limitado às operações e aos membros compatíveis com o Tipo de Dados de Objeto para esse parâmetro de tipo.
Exemplo 1
O exemplo a seguir mostra uma definição de esqueleto de uma classe de dicionário genérica, incluindo uma função de esqueleto para adicionar uma nova entrada ao dicionário.
Public Class dictionary(Of entryType, keyType As {IComparable, IFormattable, New})
Public Sub add(ByVal et As entryType, ByVal kt As keyType)
Dim dk As keyType
If kt.CompareTo(dk) = 0 Then
End If
End Sub
End Class
Exemplo 2
Como dictionary
é genérico, o código que o usa pode criar uma variedade de objetos com base nele, cada um com a mesma funcionalidade, mas atuando em um tipo de dados distinto. O exemplo a seguir mostra uma linha de código que cria um objeto dictionary
com entradas String
e chaves Integer
.
Dim dictInt As New dictionary(Of String, Integer)
Exemplo 3
O exemplo a seguir mostra a definição de esqueleto equivalente gerada pelo exemplo anterior.
Public Class dictionary
Public Sub Add(ByVal et As String, ByVal kt As Integer)
Dim dk As Integer
If kt.CompareTo(dk) = 0 Then
End If
End Sub
End Class