Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gibt zurück oder legt fest, ob die Antwort auf diese Anforderung gepuffert wird.
Namespace: System.Web.Services
Assembly: System.Web.Services (in system.web.services.dll)
Syntax
'Declaration
Public Property BufferResponse As Boolean
'Usage
Dim instance As WebMethodAttribute
Dim value As Boolean
value = instance.BufferResponse
instance.BufferResponse = value
public bool BufferResponse { get; set; }
public:
property bool BufferResponse {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_BufferResponse ()
/** @property */
public void set_BufferResponse (boolean value)
public function get BufferResponse () : boolean
public function set BufferResponse (value : boolean)
Eigenschaftenwert
true, wenn die Antwort auf diese Anforderung gepuffert wird, andernfalls false. Der Standardwert ist true.
Hinweise
Wenn BufferResponse auf true festgelegt ist, wird die Antwort der XML-Webdienstmethode in einen Speicherpuffer serialisiert, bis entweder der Puffer voll oder die Antwort vollständig serialisiert ist. Nachdem die Antwort gepuffert ist, wird sie über das Netzwerk an den XML-Webdienstclient zurückgesendet. Wenn BufferResponse auf false festgelegt ist, wird die Antwort für die XML-Webdienstmethode bei der Serialisierung zurück an den Client gesendet. Im Allgemeinen legen Sie BufferResponse nur dann auf false fest, wenn bekannt ist, dass eine XML-Webdienstmethode große Datenmengen an den Client zurückgibt. Bei kleineren Datenmengen ist der XML-Webdienst leistungsstärker, wenn BufferResponse auf true festgelegt ist.
Wenn BufferResponse auf false festgelegt ist, sind die SOAP-Erweiterungen für die XML-Webdienstmethode deaktiviert.
Beispiel
Das folgende Beispiel legt die BufferResponse-Eigenschaft auf false fest und behandelt das Streaming einer Textdatei zurück an den Client. Im Codebeispiel wird veranschaulicht, wie ein umfangreicher Datenabschnitt unter Verwendung einer Klasse, die die IEnumerable-Schnittstelle implementiert, zurück an den Client übertragen wird.
<%@WebService Class="Streaming" language="VB"%>
Imports System
Imports System.IO
Imports System.Collections
Imports System.Xml.Serialization
Imports System.Web.Services
Imports System.Web.Services.Protocols
Public Class Streaming
<WebMethod(BufferResponse:=False)> _
Public Function GetTextFile(filename As String ) As TextFile
Return New TextFile(filename)
End Function
<WebMethod> _
Public Sub CreateTextFile(contents As TextFile)
contents.Close()
End Sub
End Class
Public Class TextFile
Public filename As String
Private readerWriter As TextFileReaderWriter
Public Sub New()
End Sub
Public Sub New(filename As String)
Me.filename = filename
End Sub
<XmlArrayItem("line")> _
Public ReadOnly Property contents As TextFileReaderWriter
Get
readerWriter = New TextFileReaderWriter(filename)
Return readerWriter
End Get
End Property
Public Sub Close()
If Not (readerWriter Is Nothing) Then
readerWriter.Close()
End If
End Sub
End Class
Public Class TextFileReaderWriter
Implements IEnumerable
Public Filename As String
Private writer As StreamWriter
Public Sub New()
End Sub
Public Sub New(myfilename As String )
Filename = myfilename
End Sub
Function GetEnumerator() As IEnumerator Implements IEnumerable.GetEnumerator
Dim reader As StreamReader = New StreamReader(Filename)
Return New TextFileEnumerator(reader)
End Function
Public Sub Add(line As String)
If (writer Is Nothing) Then
writer = New StreamWriter(Filename)
End If
writer.WriteLine(line)
End Sub
Public Sub Add(obj as Object)
End Sub
Public Sub Close()
If Not (writer Is Nothing) Then writer.Close()
End Sub
End Class
Public Class TextFileEnumerator
Implements IEnumerator
Private currentLine As String
Private reader As StreamReader
Public Sub New(reader As StreamReader)
Me.reader = reader
End Sub
Public Function MoveNext() As Boolean Implements IEnumerator.MoveNext
currentLine = reader.ReadLine()
If (currentLine Is Nothing) Then
reader.Close()
Return False
Else
Return True
End If
End Function
Public Sub Reset() Implements IEnumerator.Reset
reader.BaseStream.Position = 0
End Sub
ReadOnly Property Current As object Implements IEnumerator.Current
Get
Return CurrentLine
End Get
End Property
End Class
<%@WebService class="Streaming" language="C#"%>
using System;
using System.IO;
using System.Collections;
using System.Xml.Serialization;
using System.Web.Services;
using System.Web.Services.Protocols;
public class Streaming {
[WebMethod(BufferResponse=false)]
public TextFile GetTextFile(string filename) {
return new TextFile(filename);
}
[WebMethod]
public void CreateTextFile(TextFile contents) {
contents.Close();
}
}
public class TextFile {
public string filename;
private TextFileReaderWriter readerWriter;
public TextFile() {
}
public TextFile(string filename) {
this.filename = filename;
}
[XmlArrayItem("line")]
public TextFileReaderWriter contents {
get {
readerWriter = new TextFileReaderWriter(filename);
return readerWriter;
}
}
public void Close() {
if (readerWriter != null) readerWriter.Close();
}
}
public class TextFileReaderWriter : IEnumerable {
public string Filename;
private StreamWriter writer;
public TextFileReaderWriter() {
}
public TextFileReaderWriter(string filename) {
Filename = filename;
}
public TextFileEnumerator GetEnumerator() {
StreamReader reader = new StreamReader(Filename);
return new TextFileEnumerator(reader);
}
IEnumerator IEnumerable.GetEnumerator() {
return GetEnumerator();
}
public void Add(string line) {
if (writer == null)
writer = new StreamWriter(Filename);
writer.WriteLine(line);
}
public void Close() {
if (writer != null) writer.Close();
}
}
public class TextFileEnumerator : IEnumerator {
private string currentLine;
private StreamReader reader;
public TextFileEnumerator(StreamReader reader) {
this.reader = reader;
}
public bool MoveNext() {
currentLine = reader.ReadLine();
if (currentLine == null) {
reader.Close();
return false;
}
else
return true;
}
public void Reset() {
reader.BaseStream.Position = 0;
}
public string Current {
get {
return currentLine;
}
}
object IEnumerator.Current {
get {
return Current;
}
}
}
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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
WebMethodAttribute-Klasse
WebMethodAttribute-Member
System.Web.Services-Namespace