Método Save
Salva o Recordset em um arquivo ou objeto stream.
Sintaxe
recordset.Save Destination, PersistFormat
Parâmetros
de destino do
Opcional. Um Variant que representa o nome completo do caminho do arquivo em que o Recordset deve ser salvo ou uma referência a um objeto Stream.
PersistFormat
Opcional. Um valor PersistFormatEnum que especifica o formato no qual o Recordset deve ser salvo (XML ou ADTG). O valor padrão é adPersistADTG.
Observações
O método Save Method só pode ser invocado em um de conjunto de registrosaberto. Use o método Open Method (ADO Recordset) para restaurar posteriormente o do conjunto de registros do Destination.
Se a propriedade Filter estiver em vigor para o Recordset, somente as linhas acessíveis sob o filtro serão salvas. Se o conjunto de registros for hierárquico, o do Recordset filho atual e seus filhos serão salvos, incluindo o recordset dopai. Se o método Save de um recordset filho for chamado, a criança e todos os seus filhos serão salvos, mas o pai não.
Na primeira vez que você salvar o conjunto de registros , é opcional especificar Destino. Se você omitir de Destino, um novo arquivo será criado com um nome definido como o valor da propriedade Source do recordset.
Omita Destino quando você chamar Salvar após o primeiro salvamento ou ocorrerá um erro em tempo de execução. Se você chamar posteriormente Salvar com um novo de Destino, o do conjunto de registros será salvo no novo destino. No entanto, o novo destino e o destino original estarão abertos.
Salvar não fecha o recordset ou de destino, portanto, você pode continuar a trabalhar com o conjunto de registros e salvar suas alterações mais recentes. de Destino permanece aberto até que o do conjunto de registros seja fechado.
Por motivos de segurança, o método Salvar permite apenas o uso de configurações de segurança baixa e personalizada de um script executado pelo Microsoft Internet Explorer.
Se o método Salvar for chamado enquanto um conjunto de registros assíncrono busca, execução ou operação de atualização estiver em andamento, Salvar aguardará até que a operação assíncrona seja concluída.
Os registros são salvos a partir da primeira linha do conjunto de registros . Quando o método Salvar for concluído, a posição da linha atual será movida para a primeira linha do conjunto de registros .
Para obter melhores resultados, defina a propriedade de propriedade CursorLocation (ADO) para adUseClient com Salvar. Se o provedor não der suporte a todas as funcionalidades necessárias para salvar objetos Recordset, o Serviço de Cursor fornecerá essa funcionalidade.
Quando um Recordset é mantido com a propriedade CursorLocation definida como adUseServer, a funcionalidade de atualização do Recordset é limitada. Normalmente, somente atualizações de tabela única, inserções e exclusões são permitidas (dependendo da funcionalidade do provedor). O método método Resync do também não está disponível nessa configuração.
Nota
Não há suporte para salvar um Recordset com campos do tipo adVariant, adIDispatch ou adIUnknown e pode causar resultados imprevisíveis.
Somente filtros na forma de Cadeias de Caracteres de Critério (por exemplo, OrderDate > '31/12/1999') afetam o conteúdo de um conjunto de registros persistente. Os filtros criados com uma matriz de indicadores de ou usando um valor da FilterGroupEnum não afetarão o conteúdo do conjunto de registros persistente. Essas regras se aplicam a do Recordset criados com cursores do lado do cliente ou do servidor.
Como o parâmetro Destination pode aceitar qualquer objeto que dê suporte à interface OLE DB IStream, você pode salvar um conjunto de registros diretamente no objeto de resposta ASP. Para obter mais detalhes, consulte o cenário de persistência do conjunto de registros XML .
Você também pode salvar um conjunto de registros em formato XML em uma instância de um objeto DOM MSXML, conforme mostrado no seguinte código do Visual Basic:
Dim xDOM As New MSXML.DOMDocument
Dim rsXML As New ADODB.Recordset
Dim sSQL As String, sConn As String
sSQL = "SELECT customerid, companyname, contactname FROM customers"
sConn="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=Northwind.mdb"
rsXML.Open sSQL, sConn
rsXML.Save xDOM, adPersistXML 'Save Recordset directly into a DOM tree.
...
Nota
Duas limitações se aplicam ao salvar conjuntos de registros hierárquicos (formas de dados) no formato XML. Você não poderá salvar em XML se o conjunto de registros de hierárquico contiver atualizações pendentes e não puder salvar um conjunto de registros hierárquico com parâmetros .
Um conjunto de registros salvo no formato XML é salvo usando o formato UTF-8. Quando esse arquivo é carregado em um Fluxo do ADO, o objeto Stream não tentará abrir um recordset do fluxo, a menos que a propriedade Charset do fluxo seja definida como o valor apropriado para o formato UTF-8.
Aplica-se a
do objeto Recordset (ADO)
Consulte Também
exemplo de métodos Save e Open (VB)
exemplo de métodos salvar e abrir (VC++)
do método Open (ADO Recordset)
do método Open (Fluxo do ADO)
Método SaveToFile