This function appends the given file to the specified stream. The data will be read from the local file starting at offset and the number of bytes appended will be equal to length. The file must use new line characters '\n', '\r', "\n\r", and/or "\r\n" (the file can contain more than one of these) with lines being less than or equal to 4MB (including new line characters). The append starts at the given streamFixedOffset in the destination stream. If the stream already contains data in the streamFixedOffset position and it is different from the data that is being appended, then this operation will fail.

Namespace: Microsoft.Cosmos.Management
Assembly: VcClient (in VcClient.dll) Version: 1.0.0.0 (1.8.400.4142)

Syntax

C#
public void AppendFile(
	CosmosUri stream,
	string fileName,
	long offset,
	long length,
	long streamFixedOffset,
	bool compression,
	bool preserveLineBoundary
)
Visual Basic
Public Sub AppendFile ( _
	stream As CosmosUri, _
	fileName As String, _
	offset As Long, _
	length As Long, _
	streamFixedOffset As Long, _
	compression As Boolean, _
	preserveLineBoundary As Boolean _
)
Visual C++
public:
void AppendFile(
	CosmosUri^ stream, 
	String^ fileName, 
	long long offset, 
	long long length, 
	long long streamFixedOffset, 
	bool compression, 
	bool preserveLineBoundary
)

Parameters

stream
Type: CosmosUri
The name of the stream to which the data needs to be appended.
fileName
Type: String
The name of the local file from which the data needs to be copied.
offset
Type: Int64
The position in the local file from which data needs to be copied
length
Type: Int64
The number of bytes to be appended
streamFixedOffset
Type: Int64
This is for fixed offset append. Offset in the stream for the beginning of append
compression
Type: Boolean
Whether compression should be used while transferring data to the VC.
preserveLineBoundary
Type: Boolean
If the appended file is a text file and if the line should not be broke over extent boundaries, this parameter should be set true.

See Also