WebMethodAttribute.BufferResponse プロパティ
この要求に対する応答がバッファリングされるどうかを取得または設定します。 名前空間: System.Web.Services
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文
プロパティ値
この要求に対する応答がバッファリングされる場合は true。それ以外の場合は false。既定値は true です。 解説
使用例
プラットフォーム
バージョン情報
参照
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文Dim instance As WebMethodAttribute Dim value As Boolean value = instance.BufferResponse instance.BufferResponse = value
/** @property */ public boolean get_BufferResponse () /** @property */ public void set_BufferResponse (boolean value)
public function get BufferResponse () : boolean public function set BufferResponse (value : boolean)
この要求に対する応答がバッファリングされる場合は true。それ以外の場合は false。既定値は true です。
解説BufferResponse を true に設定すると、XML Web サービス メソッドの応答は、その応答が完全にシリアル化されるか、バッファがいっぱいになるまでメモリ バッファにシリアル化されます。応答は、バッファリングされると、ネットワーク経由で XML Web サービス クライアントに返されます。BufferResponse が false の場合、XML Web サービス メソッドに対する応答は、シリアル化されるとクライアントに返されます。通常、BufferResponse を false に設定するのは、XML Web サービス メソッドがクライアントに大量のデータを返すことがわかっている場合だけです。データ量が少ない場合、BufferResponse を true に設定すると、XML Web サービスのパフォーマンスは向上します。
BufferResponse が false の場合、XML Web サービス メソッドの SOAP 拡張機能は無効になります。
使用例BufferResponse プロパティを false に設定し、クライアントに返すテキスト ファイルのストリームを処理するコード例を次に示します。このコード例では、IEnumerable インターフェイスを実装するクラスを使用して、クライアントに大量のデータをストリーム転送する方法を示します。
<%@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; } } }
プラットフォームWindows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- WebMethodAttribute.BufferResponse プロパティのページへのリンク
