Novidades do ADO

Aplica-se ao: Access 2013, Office 2013

Os novos recursos a seguir e a documentação aperfeiçoada foram incluídos no ADO versão 2.5. A lista abrange o ADO, o ADO MD e o ADOX.

Novos recursos

  • Registros e fluxos

    Esta versão do ADO apresenta o objeto Record , que pode representar e gerenciar itens como diretórios e arquivos em um sistema de arquivos e pastas e mensagens em um sistema de email. Um Record também pode representar uma linha em um Recordset, embora os objetos Record e Recordset tenham métodos e propriedades diferentes.

    O novo objeto Stream permite ler, gravar e gerenciar o fluxo binário de bytes ou o texto que abrange um fluxo de arquivo ou de mensagem.

  • Uso da URL

    Esta versão também introduz o uso de URLs, uma alternativa para sequências de conexão e texto de comando, para nomear objetos de repositório de dados. As URLs podem ser usadas com os objetos Connection e Recordset existentes, e também com os novos objetos Record e Stream.

    Com esta versão, o ADO oferece suporte a provedores OLE DB que reconhecem seus próprios esquemas URL. Por exemplo, o OLE DB Provider for Internet Publishing, que acessa o sistema de arquivos do Windows 2000, reconhece o esquema HTTP existente.

  • Campos especiais para provedores de origem de documentos

    Uma classe especial de provedores, denominada provedores de fonte de documentos, gerencia pastas e documentos. Quando um objeto Record representa um documento, ou um objeto Recordset representa uma pasta de documentos, o provedor de fonte de documentos preenche esses objetos com um conjunto exclusivo de campos que descrevem as características do documento. Esses campos constituem um recursoRecord ou Recordset.

Novos tópicos de referência

Propriedades

As novas propriedades a seguir foram incluídas nesta versão.

Propriedade

Descrição

Conjunto de caracteres

Indica o conjunto de caracteres no qual o conteúdo de um objeto Stream de texto deve ser convertido.

EOS

Indica se a posição atual é o final do fluxo.

Separador de linha

Indica o caractere binário a ser usado como separador de linha em objetos Stream de texto.

Modo

Indica as permissões disponíveis para modificação de dados em um objeto Connection, Record ou Stream.

ParentURL

Indica uma sequência de URL absoluta que aponta para o Record pai do objeto Record atual.

Posição

Indica a posição atual em um objeto Stream.

RecordType

Indica o tipo de objeto Record.

Tamanho

Indica o tamanho do fluxo em número de bytes.

Fonte

Indica a entidade representada pelo objeto Record.

Estado

Indica todos os objetos aplicáveis, independentemente de seu estado: aberto ou fechado. Para todos os objetos aplicáveis que executam um método assíncrono, indica se o estado atual do objeto é em conexão, em execução ou em recuperação.

Tipo

Indica o tipo de dados contido no objeto Stream (binário ou de texto).

Métodos

Os novos métodos a seguir foram incluídos nesta versão.

Método

Descrição

CopyRecord

Copia um arquivo ou um diretório, e seu conteúdo, para outro local.

CopyTo

Copia o número especificado de caracteres ou bytes (dependendo do tipo) no objetoStream para outro objeto Stream.

ExcluirRegistro

Exclui um arquivo ou um diretório e todos os respectivos subdiretórios.

Flush

Força o conteúdo do objeto Stream restante no buffer do ADO para o objeto subjacente ao qual o objeto Stream está associado.

GetChildren

Retorna um Recordset cujas linhas representam os arquivos e os subdiretórios no diretório representado por este Record.

LoadFromFile

Carrega o conteúdo de um arquivo existente para um objeto Stream.

MoveRecord

Move um arquivo, ou um diretório e seu conteúdo, para outro local.

Abrir

Abre um objeto Record existente ou cria um novo arquivo ou diretório.

Abrir

Abre um objeto Stream para manipular fluxos de dados binários ou de texto.

Leitura

Lê um número especificado de bytes a partir de um objeto Stream binário.

ReadText

Lê um número especificado de caracteres a partir de um objeto Stream de texto.

SaveToFile

Salva o conteúdo binário de um Stream em um arquivo.

SetEOS

Define a posição para o final do fluxo.

SkipLine

Ignora uma linha inteira na leitura de um objeto Stream de texto.

Escrever

Grava dados binários em um objeto Stream.

Gravar Texto

Grava uma sequência de texto especificada em um objeto Stream.

Documentação nova e aprimorada

  • Tópicos de exemplo de código

    Os exemplos foram expandidos para conter exemplos de código escritos em Microsoft Visual C++ e Microsoft Visual J++. Você pode copiar e colar esses exemplos de código em seu editor.

  • Tópicos de provedor

    Um novo tópico foi incluído e explica como usar o ADO com o OLE DB Provider for Internet Publishing.

  • Programando com o ADO

    Esta nova seção contém dicas e truques para o uso do ADO com diversas linguagens de programação. Ele contém os índices de sintaxe existentes para as extensões Visual C++ para ADO e ADO/WFC, bem como novas informações específicas para desenvolvedores que usam o Microsoft Visual Basic, Microsoft Visual Basic Scripting Edition, Microsoft JScript, Microsoft Visual C++ ou Microsoft Visual J++.