ConvertToString-Methode (RDS)

Konvertiert ein Recordset in eine MIME-Zeichenfolge, die die Recordsetdaten darstellt.

Wichtig

Ab Windows 8 und Windows Server 2012 sind RDS-Serverkomponenten nicht mehr im Windows-Betriebssystem enthalten (weitere Informationen finden Sie in den jeweiligen Kompatibilitäts-Cookbooks zu Windows 8 und Windows Server 2012). RDS-Clientkomponenten werden in einer zukünftigen Version von Windows entfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Anwendungen, die RDS verwenden, sollten zu WCF Data Service migriert werden.

Syntax

  
DataFactory.ConvertToString(Recordset)  

Parameter

DataFactory
Eine Objektvariable, die ein RDSServer.DataFactory-Objekt darstellt.

Recordset
Eine Objektvariable, die ein Recordset-Objekt darstellt.

Bemerkungen

Bei .asp-Dateien verwenden Sie ConvertToString, um das Recordset in eine auf dem Server generierte HTML-Seite einzubetten, um es auf einen Clientcomputer zu übertragen.

ConvertToString lädt zuerst das Recordset in die Cursordiensttabellen und generiert dann einen Strom im MIME-Format.

Auf dem Client kann der Remotedatendienst die MIME-Zeichenfolge wieder in ein voll funktionsfähiges Recordset umwandeln. Es eignet sich gut für die Verarbeitung von weniger als 400 Datenzeilen mit nicht mehr als 1024 Bytes Breite pro Zeile. Sie sollten es nicht für das Streaming von BLOB-Daten und großen Resultsets über HTTP verwenden. Die Zeichenfolge wird nicht komprimiert, so dass die Übertragung sehr großer Datensätze über HTTP im Vergleich zum drahtoptimierten Tablegram-Format, das von Remotedatendienst als natives Transportprotokollformat definiert und eingesetzt wird, erhebliche Zeit in Anspruch nimmt.

Hinweis

Wenn Sie Active Server Pages verwenden, um die resultierende MIME-Zeichenfolge in eine Client-HTML-Seite einzubetten, beachten Sie bitte, dass Versionen von VBScript vor Version 2.0 die Größe der Zeichenfolge auf 32K begrenzen. Wenn dieses Limit überschritten wird, wird ein Fehler zurückgegeben. Halten Sie den Abfragebereich relativ klein, wenn Sie MIME-Einbettungen über .asp-Dateien verwenden. Um dieses Problem zu beheben, laden Sie die neueste Version von VBScript von der Microsoft Windows Script Technologies Website herunter.

Gilt für

DataFactory-Objekt (RDSServer)

Weitere Informationen

ConvertToString-Methode – Beispiel (VB)
ConvertToString-Methode – Beispiel (VBScript)