Propriedade Name

Aplica-se a
Access para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Aplicável a

AccessObject Objeto CodeProject Objeto Form Objeto ObjectFrame Objeto Reference Objeto SubForm Objeto
AccessObjectProperty Objeto ComboBox Objeto Image Objeto OptionButton Objeto Report Objeto TabControl Coleção
AdditionalData Objeto CommandButton Objeto Label Objeto OptionGroup Objeto Section Objeto TextBox Objeto
Application Objeto CurrentProject Objeto Line Objeto Page Objeto SmartTag Objeto ToggleButton Objeto
BoundObjectFrame Objeto CustomControl Objeto ListBox Objeto PageBreak Objeto SmartTagAction Objeto
CheckBox Objeto DataAccessPage Objeto Module Objeto Rectangle Objeto SmartTagProperty Objeto

Você pode usar a Name propriedade para especificar ou determinar a expressão de cadeia de caracteres que identifica o nome de um objeto. Esta propriedade é uma leitura/gravação String para os seguintes objetos: AdditionalData, , BoundObjectFrame, CheckBox, CustomControlCommandButtonComboBoxForm, OptionButtonListBoxModuleObjectFrameLinePageBreakPageRectangleImageLabelReportOptionGroup, , Section, , SmartTagProperty, SubForm, TabControlTextBoxe .ToggleButton É somente leitura String para os seguintes objetos: AccessObject, , AccessObjectProperty, Application, CodeProject, CurrentProject, DataAccessPage, Reference, , SmartTage SmartTagAction.

Sintaxe

expression.Name

expression Necessário. Uma expressão que retorna um dos objetos anteriores.

Comentários

Um nome válido deve seguir as convenções de nomenclatura padrão do Access. Para objetos do Microsoft Access, o nome pode ter até 64 caracteres. Para controles, ele pode ter até 255 caracteres de comprimento.

Para novos objetos, defina a Name propriedade selecionando Salvar na Barra de Ferramentas de Acesso Rápido e inserindo um nome válido. Para alterar o nome de um objeto existente no Painel de Navegação, clique com o botão direito do mouse no nome e selecione Renomear. Para alterar o nome de um objeto existente enquanto ele estiver aberto, selecione Salvar Como na Barra de Ferramentas de Acesso Rápido.

Para uma seção ou controle, você pode definir essa propriedade usando o código Folha de Propriedades, uma macro ou Visual Basic for Applications (VBA). Você pode usar a Name propriedade em expressões de objeto.

O nome padrão para novos objetos é o nome de objeto mais um número inteiro único. Por exemplo, o primeiro novo formulário é Form1, o segundo novo formulário é Form2, e assim por diante. Um formulário não pode ter o mesmo nome que outro objeto do sistema, como o Screen objeto.

Para um controle desvinculado, o nome padrão é o tipo de controle mais um inteiro exclusivo. Por exemplo, se o primeiro controle que você adicionar a um formulário for uma caixa de texto, sua Name configuração de propriedade será Text1.

Para um controle vinculado, o nome padrão é o nome do campo na fonte de dados subjacente. Se você criar um controle arrastando um campo da lista de campos, a configuração da propriedade do FieldName campo será copiada para a caixa de propriedade do Name controle.

Você não pode usar Form ou Report nomear um controle ou seção.

Controles no mesmo formulário, relatório ou página de acesso a dados não podem ter o mesmo nome. Controles em diferentes formulários, relatórios ou páginas de acesso a dados podem ter o mesmo nome. Um controle e uma seção no mesmo formulário não podem compartilhar o mesmo nome.

Exemplo

O exemplo a seguir retorna a Name propriedade para o primeiro formulário da Forms coleção.

Dim strFormName As String
strFormName = Forms(0).Name