Freigeben über


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 Details finden Sie unter Windows 8 und Windows Server 2012 Compatibility Cookbook). RDS-Clientkomponenten werden in einer zukünftigen Version von Windows entfernt. Vermeiden Sie die Verwendung dieses Features in neuer Entwicklungsarbeit, und planen Sie, Anwendungen zu ändern, die derzeit dieses Feature verwenden. Anwendungen, die RDS verwenden, sollten zu WCF Data Servicemigrieren.

Syntax

  
DataFactory.ConvertToString(Recordset)  

Parameter

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

Recordset-
Eine Objektvariable, die ein Recordset-Objekt darstellt.

Bemerkungen

Verwenden Sie mit .asp Dateien ConvertToString-, um das Recordset- in eine HTML-Seite einzubetten, die auf dem Server generiert wird, um es auf einen Clientcomputer zu übertragen.

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

Remote Data Service kann die MIME-Zeichenfolge auf dem Client wieder in ein voll funktionsfähiges Recordset-konvertieren. Es eignet sich gut für die Behandlung von weniger als 400 Datenzeilen mit maximal 1024 Bytes Breite pro Zeile. Sie sollten sie nicht zum Streamen von BLOB-Daten und großen Resultsets über HTTP verwenden. Es wird keine Drahtkomprimierung für die Zeichenfolge durchgeführt, sodass sehr große Datenmengen im Vergleich zum drahtoptimierten Tabellendiagrammformat, das von Remote Data Service als systemeigenes Transportprotokollformat definiert und bereitgestellt wird, erhebliche Zeit in Anspruch nehmen.

Anmerkung

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

Gilt für

DataFactory-Objekt (RDSServer)

Siehe auch

ConvertToString-Methode (Vb-Beispiel)
ConvertToString-Methode (Beispiel) (VBScript)