Fluxos e persistência

Artigo
05/30/2023

O objeto Recordset no método Save armazena ou persiste um Recordset em um arquivo, e o método Open restaura o Recordset desse arquivo.

Com o ADO 2.7 ou posterior, os métodos Save e Open também podem persistir um Recordset em um objeto Stream. Esse recurso é especialmente útil ao trabalhar com o RDS (Serviço de Dados Remoto) e o ASP (Páginas do Servidor Ativo).

Para obter mais informações sobre como a persistência pode ser usada em páginas ASP, consulte a documentação atual do ASP.

Veja a seguir alguns cenários que mostram como os objetos Stream e a persistência podem ser usados.

Cenário 1

Esse cenário simplesmente salva um Recordset em um arquivo e, em seguida, em um Stream. Depois, ele abre o fluxo persistente em outro Recordset.

Dim rs1 As ADODB.Recordset  
Dim rs2 As ADODB.Recordset  
Dim stm As ADODB.Stream  
  
Set rs1 = New ADODB.Recordset  
Set rs2 = New ADODB.Recordset  
Set stm = New ADODB.Stream  
  
rs1.Open   "SELECT * FROM Customers", "Provider=sqloledb;" & _  
        "Data Source=MyServer;Initial Catalog=Northwind;" & _  
        "Integrated Security=SSPI;""", adopenStatic, adLockReadOnly, adCmdText  
rs1.Save "c:\myfolder\mysubfolder\myrs.xml", adPersistXML  
rs1.Save stm, adPersistXML  
rs2.Open stm

Cenário 2

Esse cenário persiste um Recordset em um Stream no formato XML. Em seguida, ele lê o Stream em uma cadeia de caracteres que você pode examinar, manipular ou exibir.

Dim rs As ADODB.Recordset  
Dim stm As ADODB.Stream  
Dim strRst As String  
  
Set rs = New ADODB.Recordset  
Set stm = New ADODB.Stream  
  
' Open, save, and close the recordset.   
rs.Open "SELECT * FROM Customers", "Provider=sqloledb;" & _  
        "Data Source=MyServer;Initial Catalog=Northwind;" & _  
        "Integrated Security=SSPI;"""  
rs.Save stm, adPersistXML  
rs.Close  
Set rs = nothing  
  
' Put saved Recordset into a string variable.  
strRst = stm.ReadText(adReadAll)  
  
' Examine, manipulate, or display the XML data.  
...

Cenário 3

Este código de exemplo mostra o código ASP persistindo um Recordset como XML diretamente para o objeto Response:

...  
<%  
response.ContentType = "text/xml"  
  
' Create and open a Recordset.  
Set rs = Server.CreateObject("ADODB.Recordset")  
rs.Open "select * from Customers", "Provider=sqloledb;" & _  
        "Data Source=MyServer;Initial Catalog=Northwind;" & _  
        "Integrated Security=SSPI;"""  
  
' Save Recordset directly into output stream.  
rs.Save Response, adPersistXML   
  
' Close Recordset.  
rs.Close  
Set rs = nothing  
%>  
...

Cenário 4

Nesse cenário, o código ASP grava o conteúdo do Recordset no formato ADTG no cliente. O Microsoft Cursor Service for OLE DB pode usar esses dados para criar um Recordset desconectado.

Uma nova propriedade no RDS DataControl, URL, aponta para a página .asp que gera o Recordset. Isso significa que um objeto Recordset pode ser obtido sem RDS usando o objeto DataFactory do servidor ou o usuário escrevendo um objeto de negócios. Isso simplifica significativamente o modelo de programação RDS.

Código do servidor, chamado https://server/directory/recordset.asp:

<%  
Dim rs   
Set rs = Server.CreateObject("ADODB.Recordset")  
rs.Open "select au_fname, au_lname, phone from Authors", ""& _  
        "Provider=sqloledb;Data Source=MyServer;" & _  
        "Initial Catalog=Pubs;Integrated Security=SSPI;"  
response.ContentType = "multipart/mixed"  
rs.Save response, adPersistADTG  
%>

Código do cliente:

<HTML>  
<HEAD>  
<TITLE>RDS Query Page</TITLE>  
</HEAD>  
<body>  
<CENTER>  
<H1>Remote Data Service 2.5</H1>  
<TABLE DATASRC="#DC1">  
   <TR>   
      <TD><SPAN DATAFLD="au_fname"></SPAN></TD>  
      <TD><SPAN DATAFLD="au_lname"></SPAN></TD>  
      <TD><SPAN DATAFLD="phone"></SPAN></TD>  
   </TR>  
</TABLE>  
<BR>  
  
<OBJECT classid="clsid:BD96C556-65A3-11D0-983A-00C04FC29E33"  
    ID=DC1 HEIGHT=1 WIDTH = 1>  
    <PARAM NAME="URL" VALUE="https://server/directory/recordset.asp">  
</OBJECT>  
  
</SCRIPT>  
</BODY>  
</HTML>

Os desenvolvedores também têm a opção de usar um objeto Recordset no cliente:

...  
function GetRs()   
    {  
    rs = CreateObject("ADODB.Recordset");  
    rs.Open "https://server/directory/recordset.asp"  
    DC1.SourceRecordset = rs;  
    }  
...

Consulte Também

Método Open (Conjunto de registros ADO)
Objeto Record (ADO)
Método Save

Compartilhar via