TextReturnReader Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Liest Rückgabewerte aus HTTP-Antworttext für Webdienstclients, die mit HTTP, aber ohne SOAP implementiert wurden.
public ref class TextReturnReader : System::Web::Services::Protocols::MimeReturnReaderpublic class TextReturnReader : System.Web.Services.Protocols.MimeReturnReadertype TextReturnReader = class
inherit MimeReturnReaderPublic Class TextReturnReader
Inherits MimeReturnReader- Vererbung
Hinweise
TextReturnReader und andere Klassen im System.Web.Services.Protocols Namespace unterstützen die .NET Framework-Implementierungen von Webdiensten über die vorgänge HTTP-GET und HTTP-POST. Webdienstautoren und Leser serialisieren bzw. deserialisieren zwischen den Parametern oder Rückgabeobjekten von Webmethoden und den HTTP-Anforderungs- oder Antwortdatenströmen. Webdienstautoren und -leser verwenden HTTP für den Transport, tauschen jedoch keine Nachrichten mithilfe des SOAP-Standards aus.
Die TextReturnReader Klasse implementiert das clientseitige Lesen von Nicht-XML-Text in Rückgabewerte der Webmethode. Um einen Rückgabewert zu erhalten, wird der Text, der im Textkörper einer HTTP-Antwort codiert ist, mithilfe eines Musterabgleichs mit regulären Ausdrücken analysiert, wie durch das Attribut MatchAttributeangegeben, das auf eine Webmethode in einer Clientproxyklasse angewendet werden kann. Die TextReturnReader Klasse ruft die PatternMatcher Klasse auf, um den Musterabgleich tatsächlich auszuführen.
Der Textmusterabgleich ermöglicht Webdiensten das Abrufen von HTML-Inhalten, ohne ihn in XML-Dokumente zu konvertieren, die an XML-Schemadefinitionen gebunden werden müssen. Suchziele für reguläre Ausdrücke werden in einem WSDL-Dokument (Web Services Description Language) über match XML-Elemente innerhalb von text Elementen angegeben. Beide Elemente gehören zum Namespace http://microsoft.com/wsdl/mime/textMatching/.
Wenn Übereinstimmungselemente in einem WSDL-Dokument angegeben werden, wendet MatchAttribute das tool Wsdl.exe Attribute auf die entsprechenden Webmethoden in der generierten Clientproxyklasse an. Darüber hinaus wird TextReturnReader anstelle von XmlReturnReader verwendet, die Standardklasse zum Deserialisieren der Webmethode gibt Werte gemäß den Implementierungen von Webdiensten des .NET Frameworks über die HTTP-GET- und HTTP-POST-Vorgänge zurück.
Normalerweise müssen Sie die TextReturnReader Klasse nicht direkt verwenden.
Konstruktoren
| Name | Beschreibung |
|---|---|
| TextReturnReader() |
Initialisiert eine neue Instanz der TextReturnReader-Klasse. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetInitializer(LogicalMethodInfo) |
Gibt einen Initialisierer für die angegebene Methode zurück. |
| GetInitializers(LogicalMethodInfo[]) |
Wenn eine abgeleitete Klasse überschrieben wird, wird ein Array von Initialisierungsobjekten zurückgegeben, das einem Eingabearray von Methodendefinitionen entspricht. (Geerbt von MimeFormatter) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| Initialize(Object) |
Initialisiert eine Instanz. |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| Read(WebResponse, Stream) |
Analysiert Text, der in der HTTP-Antwort enthalten ist. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
