Sdílet prostřednictvím

FramingWriter.NewRecord Method ()

  • Článek

Creates and returns a new framed record with default ID, payload type and format that uses chunked mode.

Namespace: Microsoft.Web.Services3.Messaging.Framing
Assembly: Microsoft.Web.Services3 (in microsoft.web.services3.dll)

Usage

'Usage
Dim returnValue As FramingRecord
Dim framingWriter1 As FramingWriter
returnValue = framingWriter1.NewRecord()

Syntax

'Declaration
Overloads Public Function NewRecord() As FramingRecord

public FramingRecord NewRecord();

public:
FramingRecord^ NewRecord();

public FramingRecord NewRecord();

public function NewRecord() : FramingRecord;

Return Value

The next FramingRecord to write in the framed message with the specified values.

Exceptions

Exception type Condition
InvalidOperationException

Either the framed message has been closed.

-or-

A last record has already been written for this framed message.

Remarks

The default payload type is "application/octet-stream" and the default typeFormat is "TypeFormatEnum.MediaType".

When the NewRecord method is used to create the last record containing a positive payload length, Close will then be called and an additional empty last record will be appended to the framed message. This occurs, for example, when the size of the message is not known and its payload is being chunked.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows 2000, Windows 2000 Server, Windows 2000 Advanced Server

Target Platforms

See Also

Reference

FramingWriter Class
FramingWriter Members
Microsoft.Web.Services3.Messaging.Framing Namespace