TextReturnReader-Klasse

Artikel
08/20/2007

Liest Rückgabewerte aus HTTP-Antworttext für mit HTTP und ohne SOAP implementierte Webdienstclients.

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Class TextReturnReader
    Inherits MimeReturnReader
'Usage
Dim instance As TextReturnReader

public class TextReturnReader : MimeReturnReader

public ref class TextReturnReader : public MimeReturnReader

public class TextReturnReader extends MimeReturnReader

public class TextReturnReader extends MimeReturnReader

Hinweise

TextReturnReader und andere Klassen im System.Web.Services.Protocols-Namespace unterstützen die Implementierungen von Webdiensten von .NET Framework über die HTTP-GET- und HTTP-POST-Operationen. Webdienstwriter und -reader serialisieren bzw. deserialisieren zwischen den Parametern oder Rückgabeobjekten von Webmethoden und den HTTP-Anforderungsstreams bzw. -Antwortstreams. Webdienstwriter und -reader verwenden HTTP für den Transport, tauschen jedoch keine Meldungen mithilfe des SOAP-Standards aus.

Die TextReturnReader-Klasse implementiert das clientbasierte Einlesen von Nicht-XML-Text in Rückgabewerte der Webmethode. Zum Abrufen eines Rückgabewerts wird der im Text einer HTTP-Antwort codierte Text mithilfe des Mustervergleichs für reguläre Ausdrücke analysiert, wie durch das Attribut MatchAttribute angegeben, das auf eine Webmethode in einem Clientproxy angewendet werden kann. Für die eigentliche Ausführung des Mustervergleichs ruft die TextReturnReader-Klasse die PatternMatcher-Klasse auf.

Durch Textmustervergleiche können Webdienste HTML-Inhalt abrufen, ohne diesen in XML-Dokumente zu konvertieren, die an XML-Schemadefinititionen gebunden sein müssen. Suchziele für reguläre Ausdrücke werden in einem WSDL-Dokument (Web Services Description Language) über match-XML-Elemente in text-Elementen angegeben. Beide Elemente gehören zum Namespace https://microsoft.com/wsdl/mime/textMatching/.

Wenn match-Elemente in einem WSDL-Dokument angegeben sind, wendet das WSDL-Tool MatchAttribute-Attribute auf die entsprechenden Webmethoden in der generierten Clientproxyklasse an. Außerdem wird TextReturnReader anstelle von XmlReturnReader verwendet. Dies ist die Standardklasse zum Deserialisieren von Rückgabewerten der Webmethode entsprechend den Implementierungen von .NET Framework-Webdiensten über die HTTP-GET- und HTTP-POST-Operationen.

In der Regel ist die direkte Verwendung von TextReturnReader nicht erforderlich.

Vererbungshierarchie

System.Object
   System.Web.Services.Protocols.MimeFormatter
     System.Web.Services.Protocols.MimeReturnReader
      System.Web.Services.Protocols.TextReturnReader

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

TextReturnReader-Member
System.Web.Services.Protocols-Namespace
MimeFormatter-Klasse
MimeReturnReader-Klasse
PatternMatcher-Klasse
MatchAttribute-Klasse

Freigeben über