Mostrar tudo

Ocultar tudo

A função GUIDFromString converte uma cadeia (cadeia: colecção de caracteres que pode incluir números e texto.) num 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.) do 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.).

Sintaxe

GUIDFromString(expressãodecadeia)

O argumento expressãodecadeia é uma expressão de cadeia que resulta num GUID no formulário da cadeia.

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 num GUID, utilize a função GUIDFromString.

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 seguinte utiliza a função GUIDFromString para converter uma cadeia num GUID. A cadeia é um GUID armazenado no formulário da cadeia numa tabela Empregados replicada. O campo, s_GUID, é um campo oculto adicionado a todas as tabelas replicadas numa base de dados replicada.

Sub CheckGUIDType()

    Dim dbsConn As ADODB.Connection
    Dim rstEmployees As ADODB.Recordset

    ' Make a connection to the current database.
    Set dbsConn = Application.CurrentProject.Connection
    Set rstEmployees = New ADODB.Recordset
    rstEmployees.Open "Employees", _
        dbsConn, , , adCmdTable

    ' Print the GUID to the immediate window.
    Debug.Print rst!s_GUID
    Debug.Print TypeName(rst!s_GUID)
    Debug.Print TypeName(GuidFromString(rst!s_GUID))

    Set rstEmployees = Nothing
    Set dbsConn = Nothing

End Sub