System.IO.IsolatedStorage

Class IsolatedStorageFileStream

java.lang.Object

System.IO.Stream

System.IO.FileStream

System.IO.IsolatedStorage.IsolatedStorageFileStream

All Implemented Interfaces:

IDisposable

public class IsolatedStorageFileStream
extends FileStream

Author:

Halofreak1990

Field Summary

Fields inherited from class System.IO.Stream

Null

Constructor Summary

Constructors

Constructor and Description
IsolatedStorageFileStream(java.lang.String path, FileMode mode, java.util.EnumSet<FileAccess> access, java.util.EnumSet<FileShare> share, IsolatedStorageFile isf)
IsolatedStorageFileStream(java.lang.String path, FileMode mode, java.util.EnumSet<FileAccess> access, IsolatedStorageFile isf)
IsolatedStorageFileStream(java.lang.String path, FileMode mode, IsolatedStorageFile isf) Initializes a new instance of the System.IO.IsolatedStorage.IsolatedStorageFileStream class giving access to the file designated by path, in the specified mode, and in the context of the System.IO.IsolatedStorage.IsolatedStorageFile specified by isf.

Method Summary

Methods

Modifier and Type	Method and Description
IAsyncResult	BeginRead(byte[] buffer, int offset, int numBytes, AsyncCallback userCallback, java.lang.Object stateObject) Begins an asynchronous read.
IAsyncResult	BeginWrite(byte[] buffer, int offset, int numBytes, AsyncCallback userCallback, java.lang.Object stateObject) Begins an asynchronous write.
int	EndRead(IAsyncResult asyncResult) Ends a pending asynchronous read request.
void	EndWrite(IAsyncResult asyncResult) Ends an asynchronous write.
void	Flush() Updates the file with the current state of the buffer then clears the buffer.
int	Read(byte[] buffer, int offset, int count) Copies bytes from the current buffered IsolatedStorageFileStream object to an array.
int	ReadByte() Reads a single byte from the IsolatedStorageFileStream object in isolated storage.
long	Seek(long offset, SeekOrigin origin) When overridden in a derived class, sets the position within the current stream.
void	SetLength(long value) Sets the length of this IsolatedStorageFileStream object to the specified value.
void	Write(byte[] buffer, int offset, int count) Writes a block of bytes to the IsolatedStorageFileStream object using data read from a byte array.
void	WriteByte(byte value) Writes a single byte to the IsolatedStorageFileStream object.

Methods inherited from class System.IO.FileStream

CanRead, CanSeek, CanWrite, finalize, getName, getPosition, Length, setPosition

Methods inherited from class System.IO.Stream

CanTimeout, Close, Dispose, Dispose

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IsolatedStorageFileStream

public IsolatedStorageFileStream(java.lang.String path,
                         FileMode mode,
                         java.util.EnumSet<FileAccess> access,
                         java.util.EnumSet<FileShare> share,
                         IsolatedStorageFile isf)

Parameters:

path -

mode -

access -

share -

isf -

IsolatedStorageFileStream

public IsolatedStorageFileStream(java.lang.String path,
                         FileMode mode,
                         java.util.EnumSet<FileAccess> access,
                         IsolatedStorageFile isf)

Parameters:

path -

mode -

access -

isf -

IsolatedStorageFileStream

public IsolatedStorageFileStream(java.lang.String path,
                         FileMode mode,
                         IsolatedStorageFile isf)

Initializes a new instance of the System.IO.IsolatedStorage.IsolatedStorageFileStream class giving access to the file designated by path, in the specified mode, and in the context of the System.IO.IsolatedStorage.IsolatedStorageFile specified by isf.

Parameters:

path - The relative path of the file within isolated storage.

mode - One of the System.IO.FileMode values.

isf - The System.IO.IsolatedStorage.IsolatedStorageFile in which to open the System.IO.IsolatedStorage.IsolatedStorageFileStream.

Throws:

IsolatedStorageException - isf has been disposed. -or-path is badly formed.-or-path is null. -or-isf is null.-orThe directory in path does not exist.-or-No file was found and the mode is set to System.IO.FileMode.Open.

Method Detail

BeginRead

public IAsyncResult BeginRead(byte[] buffer,
                     int offset,
                     int numBytes,
                     AsyncCallback userCallback,
                     java.lang.Object stateObject)

Begins an asynchronous read.

Overrides:

BeginRead in class Stream

Parameters:

buffer - The buffer to read data into.

offset - The byte offset in buffer at which to begin reading.

numBytes - The maximum number of bytes to read.

userCallback - The method to call when the asynchronous read operation is completed. This parameter is optional.

stateObject - The status of the asynchronous read.

Returns:

An IAsyncResult object that represents the asynchronous read, which is possibly still pending. This IAsyncResult must be passed to this stream's EndRead method to determine how many bytes were read. This can be done either by the same code that called BeginRead or in a callback passed to BeginRead.

Throws:

IOException - An asynchronous read was attempted past the end of the file.

BeginWrite

public IAsyncResult BeginWrite(byte[] buffer,
                      int offset,
                      int numBytes,
                      AsyncCallback userCallback,
                      java.lang.Object stateObject)

Begins an asynchronous write.

Overrides:

BeginWrite in class Stream

Parameters:

buffer - The buffer to write data to.

offset - The byte offset in buffer at which to begin writing.

numBytes - The maximum number of bytes to write.

userCallback - The method to call when the asynchronous write operation is completed. This parameter is optional.

stateObject - The status of the asynchronous write.

Returns:

An IAsyncResult that represents the asynchronous write, which is possibly still pending. This IAsyncResult must be passed to this stream's EndWrite method to ensure that the write is complete, then frees resources appropriately. This can be done either by the same code that called BeginWrite or in a callback passed to BeginWrite.

Throws:

IOException - An asynchronous read was attempted past the end of the file.

EndRead

public int EndRead(IAsyncResult asyncResult)

Ends a pending asynchronous read request.

Overrides:

EndRead in class Stream

Parameters:

asyncResult - The pending asynchronous request.

Returns:

The number of bytes read from the stream, between zero and the number of requested bytes. Streams will only return zero at the end of the stream. Otherwise, they will block until at least one byte is available.

Throws:

ArgumentNullException - The asyncResult is null.

EndWrite

public void EndWrite(IAsyncResult asyncResult)

Ends an asynchronous write.

Overrides:

EndWrite in class Stream

Parameters:

asyncResult - The pending asynchronous I/O request to end.

Throws:

ArgumentNullException - The asyncResult parameter is null.

Flush

public void Flush()

Updates the file with the current state of the buffer then clears the buffer.

Overrides:

Flush in class FileStream

Read

public int Read(byte[] buffer,
       int offset,
       int count)

Copies bytes from the current buffered IsolatedStorageFileStream object to an array.

Overrides:

Read in class FileStream

Parameters:

buffer - The buffer to read.

offset - The offset in the buffer at which to begin writing.

count - The maximum number of bytes to read.

Returns:

The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many bytes are not currently available, or zero if the end of the stream is reached.

ReadByte

public int ReadByte()

Reads a single byte from the IsolatedStorageFileStream object in isolated storage.

Overrides:

ReadByte in class Stream

Returns:

The 8-bit unsigned integer value read from the isolated storage file.

Seek

public long Seek(long offset,
        SeekOrigin origin)

Description copied from class: Stream

When overridden in a derived class, sets the position within the current stream.

Overrides:

Seek in class FileStream

Parameters:

offset -

origin -

Returns:

SetLength

public void SetLength(long value)

Sets the length of this IsolatedStorageFileStream object to the specified value.

Overrides:

SetLength in class FileStream

Parameters:

value - The new length of the IsolatedStorageFileStream object.

Write

public void Write(byte[] buffer,
         int offset,
         int count)

Writes a block of bytes to the IsolatedStorageFileStream object using data read from a byte array.

Overrides:

Write in class FileStream

Parameters:

buffer - The buffer to write.

offset - The byte offset in buffer from which to begin.

count - The maximum number of bytes to write.

Throws:

ArgumentNullException - buffer is null.

IsolatedStorageException - The write attempt exceeds the quota for the IsolatedStorageFileStream object.

WriteByte

public void WriteByte(byte value)

Writes a single byte to the IsolatedStorageFileStream object.

Overrides:

WriteByte in class Stream

Parameters:

value - The byte value to write to the isolated storage file.

Throws:

IsolatedStorageException - The write attempt exceeds the quota for the IsolatedStorageFileStream object.