Mostrar tudo

Ocultar tudo

A função StringFromGUID converte um GUID (GUID: campo de 16 bytes utilizado numa base de dados do Access para estabelecer um identificador exclusivo para a replicação. Os GUID são utilizados para identificar réplicas, conjuntos de réplicas, tabelas, registos e outros objectos. Numa base de dados do Access, os GUID são designados por ID de replicação.), que é uma matriz (matriz: é utilizada para criar fórmulas únicas que produzam vários resultados ou que funcionem num grupo de argumentos dispostos em linhas e colunas. Um intervalo de matriz partilha uma fórmula comum; uma constante de matriz é um grupo de constantes utilizado como um argumento.) de tipo Byte (tipo de dados Byte: tipo de dados de uma base de dados do Access utilizado para conter pequenos números inteiros positivos entre 0 e 255.) numa cadeia (cadeia: colecção de caracteres que pode incluir números e texto.).

Sintaxe

StringFromGUID(guid)

O argumento guid obrigatório é uma matriz de dados de Byte utilizada para identificar exclusivamente uma aplicação, componente ou item de dados para o sistema operativo.

Observações

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 os dados Byte de um controlo (controlo: objecto de interface gráfica do utilizador como, por exemplo, uma caixa de texto, caixa de verificação, barra de deslocamento ou botão de comando que permite aos utilizadores controlar o programa. Os controlos são utilizados para apresentar dados ou opções, executar uma determinada acção ou facilitar a leitura da interface do utilizador.) num formulário (formulário: objecto de base de dados do Access, no qual pode colocar controlos para executar acções ou para introduzir, apresentar e editar dados em campos.) ou num relatório (relatório: objecto de base de dados do Access que imprime informações formatadas e organizadas de acordo com as especificações do utilizador. Alguns exemplos de relatórios são os resumos de vendas, as listas telefónicas e as etiquetas de endereço.). Para converter o valor de um GUID de um controlo, tem de o converter numa cadeia. Para converter um GUID numa cadeia, utilize a função StringFromGUID. Para converter uma cadeia novamente num GUID, utilize a função GUIDFromString.

Por exemplo, poderá necessitar de fazer referência a um campo que contenha um GUID quando utilizar a replicação de bases de dados. Para devolver o valor de um controlo num formulário vinculado a um campo que contenha um GUID, utilize a função StringFromGUID para converter o GUID numa cadeia.

Exemplo

 Nota   Os exemplos que se seguem demonstram a utilização desta função num módulo do Visual Basic for Applications (VBA). Para mais informações sobre como trabalhar com VBA, seleccione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de procura.

O exemplo que se segue devolve o valor do controlo s_GUID num formulário Empregados em formato de cadeia e atribui-o a uma cadeia disponível. O controlo s_GUID está vinculado ao campo s_GUID, um dos campos do sistema adicionado 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