propriedade DataRecordset.Name (Visio)

Obtém ou define o nome para exibição do conjunto de registros de dados. Leitura/gravação.

Sintaxe

expressão. Nome

expressão Uma variável que representa um objeto DataRecordset .

Valor de retorno

Cadeia de caracteres

Comentários

O nome a apresentar de um objeto DataRecordset é o nome que transmitiu como o parâmetro Nome para o método DataRecordsets.Add, DataRecordsets.AddFromConnectionFile ou DataRecordsets.AddFromXML quando criou o conjunto de registos de dados pela primeira vez; ou o nome que atribuiu posteriormente ao definir esta propriedade. Se não atribuir um nome quando cria um conjunto de registos de dados, o Microsoft Visio atribui um nome predefinido, como Folha1 , que seria o nome atribuído se importasse dados de um livro do Microsoft Excel.

Se você especificar (no parâmetro AddOptions de um dos métodos Add) a exibição da janela Dados Externos na interface do usuário do Visio, o nome para exibição aparecerá na guia da janela Dados Externos que corresponde ao conjunto de registros de dados.

O valor de propriedade Name deve ser exclusivo em um documento específico — não é possível atribuir o mesmo nome para exibição a mais de um conjunto de registros de dados. Se você tentar atribuir o valor de propriedade Name de um conjunto de registros de dados existente a outro conjunto de registros de dados no mesmo documento, a atribuição falhará. Se você adicionar um novo conjunto de registros de dados a um documento usando o método Add e se passar para o método Add o nome de um conjunto de registros de dados existente como um nome para exibição, o Visio acrescentará um traço e um numeral (-1, por exemplo) ao nome para torná-lo exclusivo no contexto do documento.

Entretanto, se excluir um conjunto de registros de dados, você poderá reutilizar o nome para exibição do conjunto de registros de dados excluído para outro conjunto de registros de dados no mesmo documento. Isto contrasta com o caso com o valor da propriedade DataRecordset.ID . Um ID específico é exclusivo para a vida útil do documento e não pode reutilizá-lo, mesmo que elimine o conjunto de registos de dados ao qual foi atribuído.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.