Função StringFromGUID

Aplica-se A
Access para Microsoft 365 Access 2021 Access 2019 Access 2016

A função StringFromGUID converte um GUID, que é uma matriz do tipo Byte, em uma cadeia de caracteres.

Sintaxe

StringFromGUID(guid)

O argumento guid necessário é uma matriz de dados Byte usada para identificar exclusivamente um aplicativo, componente ou item de dados para o sistema operacional.

    

Comentários

O motor de base de dados do Microsoft Access armazena GUIDs como matrizes do tipo Byte. No entanto, o Microsoft Office Access 2007 não pode devolver dados Byte de um controlo num formulário ou relatório. Para retornar o valor de um GUID de um controle, você deve convertê-lo em uma cadeia de caracteres. Para converter um GUID em uma cadeia de caracteres, use a função StringFromGUID . Para converter uma cadeia de caracteres novamente em um GUID, use a função GUIDFromString .

Por exemplo, poderá ter de fazer referência a um campo que contenha um GUID quando utilizar a replicação de bases de dados. Para retornar o valor de um controle em um formulário vinculado a um campo que contém um GUID, use a função StringFromGUID para converter o GUID em uma cadeia de caracteres.

Exemplo

Nota

Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

O exemplo a seguir retorna o valor do controle s_GUID em um formulário Employees no formato de cadeia e o atribui a uma variável de cadeia de caracteres. O controlo de s_GUID está vinculado ao campo s_GUID, um dos campos de sistema adicionados a cada tabela replicada numa base de dados replicada.

Public Sub StringValueOfGUID()
    Dim ctl As Control
    Dim strGUID As String
    ' Get the GUID.
    Set ctl = Forms!Employees!s_GUID
    Debug.Print TypeName(ctl.Value)
    ' Convert the GUID to a string.
    strGUID = StringFromGUID(ctl.Value)
    Debug.Print TypeName(strGUID)
End Sub