MongoGridFSFileMBS.Constructor   Private

MongoGridFSFileMBS.NewStream as MongoStreamMBS

Var GridFS As MongoGridFSMBS = Client.GridFS("test", "fs")

// now find the file and read it
Var file As MongoGridFSFileMBS = GridFS.FindOneByFileName( "test.txt")

// open a stream
Var stream As MongoStreamMBS = file.NewStream

// write new content
Var bytes As Integer = stream.Write("Just a test! more bytes")
MessageBox "bytes written: "+bytes.ToString

// this will do file.save internally
stream.Close

GridFS files are created with CreateFile() or CreateFileFromStream().

This function does not transfer ownership of file. Therefore, file must remain valid for the lifetime of this stream.

Note, the returned stream uses the “socketTimeoutMS” and “connectTimeoutMS” values from the MongoDB URI.

Some examples using this method:

• /MongoDB/MongoDB Test

MongoGridFSFileMBS.Read(ByteCount as Integer, MinBytes as Integer = -1) as String

MinBytes: The minimum number of bytes that must be read or an error will be synthesized.

This function performs a scattered read from file, potentially blocking to read from the MongoDB server.

MongoGridFSFileMBS.ReadAll as String

This function performs a scattered read from file, potentially blocking to read from the MongoDB server.

MongoGridFSFileMBS.ReadAllMemory as MemoryBlock

This function performs a scattered read from file, potentially blocking to read from the MongoDB server.

MongoGridFSFileMBS.ReadMemory(ByteCount as Integer, MinBytes as Integer = -1) as MemoryBlock

MinBytes: The minimum number of bytes that must be read or an error will be synthesized.

This function performs a scattered read from file, potentially blocking to read from the MongoDB server.

MongoGridFSFileMBS.Remove

MongoGridFSFileMBS.Save

Modifying GridFS files is NOT thread-safe. Only one thread or process can access a GridFS file while it is being modified.

MongoGridFSFileMBS.Seek(delta as Int64, whence as Integer = 0)

The whence argument is interpreted as in fseek:

SeekSet	Set the position relative to the start of the file.
SeekCurrent	Move delta relative to the current file position.
SeekEnd	Move delta relative to the end of the file.

On success, the file’s underlying position pointer is set appropriately. On failure, the file position is NOT changed and an exception is raised.

MongoGridFSFileMBS.Write(Data as MemoryBlock) as Integer

Modifying GridFS files is NOT thread-safe. Only one thread or process can access a GridFS file while it is being modified.

Returns the number of bytes written.

See also:

• Write(Data as String) as Integer

MongoGridFSFileMBS.Write(Data as String) as Integer

Modifying GridFS files is NOT thread-safe. Only one thread or process can access a GridFS file while it is being modified.

Returns the number of bytes written.

See also:

• Write(Data as MemoryBlock) as Integer