Opening a session
The OpenAsyncSession
method is the only way to retrieve the IAsyncFilesSession
object from the FilesStore
.
Syntax
There are three overloads of the OpenAsyncSession
method:
// Open a session for a 'default' file system configured in 'FilesStore'
IAsyncFilesSession OpenAsyncSession();
// Open a session for a specified file system
IAsyncFilesSession OpenAsyncSession(string filesystem);
// Open a session for a specified file system with custom API Key / Credentials
IAsyncFilesSession OpenAsyncSession(OpenFilesSessionOptions sessionOptions);
The first method is an equivalent of:
store.OpenAsyncSession(new OpenFilesSessionOptions()
{
FileSystem = store.DefaultFileSystem
});
The second overload is an equivalent of:
store.OpenAsyncSession(new OpenFilesSessionOptions()
{
FileSystem = filesystem
});
Parameters | ||
---|---|---|
sessionOptions | OpenFilesSessionOptions | Options containing information such as the name of a file system on which the session will work and the credentials to use. |
Return Value | |
---|---|
IAsyncFilesSession | The session object that implements the IAsyncFilesSession interface. |
Example
using (IAsyncFilesSession session = store.OpenAsyncSession())
{
// code here
}
Always dispose the session
The session needs to allocate additional resources internally. You need to invoke the Dispose
method on it or wrap the session object into the using
statement.