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 mecanismo de banco de dados do Microsoft Access armazena GUIDs como matrizes do tipo Byte. No entanto, o Microsoft Office Access 2007 não pode retornar dados byte de um controle em um 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 de volta em um GUID, use a função GUIDFromString .

Por exemplo, talvez seja necessário consultar um campo que contém um GUID ao usar a replicação de banco de dados. Para retornar o valor de um controle em um formulário associado a um campo que contém um GUID, use a função StringFromGUID para converter o GUID em uma cadeia de caracteres.

Exemplo

Observação

Exemplos a seguir demonstram o uso dessa função em um módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência do Desenvolvedor na lista suspensa ao lado de Pesquisar e insira 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 formulário de cadeia de caracteres e o atribui a uma variável de cadeia de caracteres. O controle s_GUID está associado ao campo s_GUID, um dos campos do sistema adicionados a cada tabela replicada em um banco de dados replicado.

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