Método Index.CreateField (DAO)

Aplica-se ao: Access 2013, Office 2013

Cria um novo objeto Field (apenas espaços de trabalho do Microsoft Access).

Sintaxe

expressão .CreateField(Name, Type, Size)

Expressão Uma variável que representa um objeto Index .

Parâmetros

Nome	Necessária/opcional	Tipo de dados	Descrição
Name	Opcional	Variant	Uma cadeia de caracteres que nomeia o novo objeto Field. Consulte a propriedade Name para obter detalhes sobre nomes válidos de Field.
Type	Opcional	Variant	O argumento não tem suporte neste objeto.
Tamanho	Opcional	Variant	O argumento não tem suporte neste objeto.

Valor de retorno

Campo

Comentários

Você pode usar o método CreateField para criar um novo campo, bem como especificar o nome, o tipo dos dados e o tamanho do campo. Se você omitir uma ou mais das partes opcionais ao utilizar CreateField, poderá usar uma instruções de atribuição apropriada para definir ou redefinir a propriedade correspondente antes de acrescentar o novo objeto a uma coleção. Depois de acrescentar o novo objeto, será possível alterar algumas, mas não todas as suas configurações de propriedade. Consulte os tópicos de propriedade individuais para obter mais detalhes.

Os argumentos de tipo e tamanho se aplicam apenas a objetos Field em um objeto TableDef . Estes argumentos são ignorados quando um objeto Field está associado a um objeto Index ou Relation.

Se o nome se referir a um objeto que já é um membro da coleção, ocorrerá um erro em tempo de execução ao usar o método Append .

Para remover um objeto Field de uma coleção Fields, use o método Delete na coleção. Não é possível excluir um objeto Field de uma coleção Fields do objeto TableDef depois de criar um index que faça referência ao campo.