File
|
public class FileClient : ClientBase
The FileClient type exposes the following members.
Name | Description | |
---|---|---|
FileClient | Initializes a new instance of the FileClient class. | |
FileClient(IContainer) | Initializes a new instance of the FileClient class. | |
FileClient(String) | Initializes a new instance of the FileClient class. |
Name | Description | |
---|---|---|
AtEOF | Gets flags that determines if FileClient is positioned at the end of file. | |
AutoRepeat | Gets or sets a boolean value that indicates whether receiving (reading) of data is to be repeated endlessly. | |
CanRaiseEvents | Gets a value indicating whether the component can raise an event. (Inherited from Component) | |
Client | Gets the FileStream object for the FileClient. | |
ConnectionString |
Gets or sets the data required by the client to connect to the server.
(Inherited from ClientBase) | |
ConnectionTime |
Gets the Time for which the client has been connected to the server.
(Inherited from ClientBase) | |
Container | Gets the IContainer that contains the Component. (Inherited from Component) | |
CurrentState |
Gets the current ClientState.
(Inherited from ClientBase) | |
DesignMode | Gets a value that indicates whether the Component is currently in design mode. (Inherited from Component) | |
DisconnectAtEOF | Gets or sets flag that determines if client should disconnect when end of file has been reached. | |
Enabled |
Gets or sets a boolean value that indicates whether the client is currently enabled.
(Inherited from ClientBase) | |
Events | Gets the list of event handlers that are attached to this Component. (Inherited from Component) | |
FileAccessMode | Gets or sets the FileAccess value to be used when opening the file. | |
FileOpenMode | Gets or sets the FileMode value to be used when opening the file. | |
FileShareMode | Gets or set the FileShare value to be used when opening the file. | |
IsDisposed |
Gets a flag that indicates whether the object has been disposed.
(Inherited from ClientBase) | |
MaxConnectionAttempts |
Gets or sets the maximum number of times the client will attempt to connect to the server.
(Inherited from ClientBase) | |
Name |
Gets the unique identifier of the client.
(Inherited from ClientBase) | |
PersistSettings |
Gets or sets a boolean value that indicates whether the client settings are to be saved to the config file.
(Inherited from ClientBase) | |
ReadIndex |
Gets or sets current read index for received data buffer incremented at each Read(Byte, Int32, Int32) call.
(Inherited from ClientBase) | |
ReceiveBufferSize |
Gets or sets the size of the buffer used by the client for receiving data from the server.
(Inherited from ClientBase) | |
ReceiveInterval | Gets or sets the number of milliseconds to pause before receiving (reading) the next available set of data. | |
ReceiveOnDemand | Gets or sets a boolean value that indicates whether receiving (reading) of data will be initiated manually by calling ReadNextBuffer. | |
SendBufferSize |
Gets or sets the size of the buffer used by the client for sending data to the server.
(Inherited from ClientBase) | |
ServerIndex |
Gets the current server index, when multiple server end points are defined.
(Inherited from ClientBase) | |
ServerUri |
Gets the server URI of the FileClient.
(Overrides ClientBaseServerUri) | |
SettingsCategory |
Gets or sets the category under which the client settings are to be saved to the config file if the PersistSettings property is set to true.
(Inherited from ClientBase) | |
Site | Gets or sets the ISite of the Component. (Inherited from Component) | |
StartingOffset | Gets or sets the starting point relative to the beginning of the file from where the data is to be received (read). | |
Statistics |
Gets the TransportStatistics for the client connection.
(Inherited from ClientBase) | |
Status |
Gets the descriptive status of the client.
(Inherited from ClientBase) | |
TextEncoding |
Gets or sets the Encoding to be used for the text sent to the server.
(Inherited from ClientBase) | |
TrackStatistics |
Determines whether the base class should track statistics.
(Inherited from ClientBase) | |
TransportProtocol |
Gets the TransportProtocol used by the client for the transportation of data with the server.
(Inherited from ClientBase) |
Name | Description | |
---|---|---|
BeginInit |
Performs necessary operations before the client properties are initialized.
(Inherited from ClientBase) | |
Connect |
Connects the client to the server synchronously.
(Inherited from ClientBase) | |
ConnectAsync |
Connects the FileClient to the FileStream asynchronously.
(Overrides ClientBaseConnectAsync) | |
CreateObjRef | Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject) | |
Disconnect |
Disconnects the FileClient from the FileStream.
(Overrides ClientBaseDisconnect) | |
Dispose | Releases all resources used by the Component. (Inherited from Component) | |
Dispose(Boolean) |
Releases the unmanaged resources used by the FileClient and optionally releases the managed resources.
(Overrides ClientBaseDispose(Boolean)) | |
EndInit |
Performs necessary operations after the client properties are initialized.
(Inherited from ClientBase) | |
Equals | Determines whether the specified object is equal to the current object. (Inherited from Object) | |
Finalize | Releases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection. (Inherited from Component) | |
GetHashCode | Serves as the default hash function. (Inherited from Object) | |
GetLifetimeService | Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject) | |
GetService | Returns an object that represents a service provided by the Component or by its Container. (Inherited from Component) | |
GetType | Gets the Type of the current instance. (Inherited from Object) | |
Initialize |
Initializes the client.
(Inherited from ClientBase) | |
InitializeLifetimeService | Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject) | |
LoadSettings |
Loads saved FileClient settings from the config file if the PersistSettings property is set to true.
(Overrides ClientBaseLoadSettings) | |
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object) | |
MemberwiseClone(Boolean) | Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject) | |
OnConnectionAttempt |
Raises the ConnectionAttempt event.
(Inherited from ClientBase) | |
OnConnectionEstablished |
Raises the ConnectionEstablished event.
(Inherited from ClientBase) | |
OnConnectionException |
Raises the ConnectionException event.
(Overrides ClientBaseOnConnectionException(Exception)) | |
OnConnectionTerminated |
Raises the ConnectionTerminated event.
(Inherited from ClientBase) | |
OnEndOfFile | Raises the EndOfFile event. | |
OnReceiveData |
Raises the ReceiveData event.
(Inherited from ClientBase) | |
OnReceiveDataComplete |
Raises the ReceiveDataComplete event.
(Inherited from ClientBase) | |
OnReceiveDataException |
Raises the ReceiveDataException event.
(Inherited from ClientBase) | |
OnSendDataComplete |
Raises the SendDataComplete event.
(Inherited from ClientBase) | |
OnSendDataException |
Raises the SendDataException event.
(Inherited from ClientBase) | |
OnSendDataStart |
Raises the SendDataStart event.
(Inherited from ClientBase) | |
OnUnhandledUserException |
Raises the UnhandledUserException event.
(Inherited from ClientBase) | |
Read |
Reads a number of bytes from the current received data buffer and writes those bytes into a byte array at the specified offset.
(Overrides ClientBaseRead(Byte, Int32, Int32)) | |
ReadNextBuffer | Reads next data buffer from the FileStream. | |
RequestNextServerIndex |
Requests that the client attempt to move to the next ServerIndex.
(Inherited from ClientBase) | |
SaveSettings |
Saves FileClient settings to the config file if the PersistSettings property is set to true.
(Overrides ClientBaseSaveSettings) | |
Send(Byte) |
Sends data to the server synchronously.
(Inherited from ClientBase) | |
Send(Object) |
Sends data to the server synchronously.
(Inherited from ClientBase) | |
Send(String) |
Sends data to the server synchronously.
(Inherited from ClientBase) | |
Send(Byte, Int32, Int32) |
Sends data to the server synchronously.
(Inherited from ClientBase) | |
SendAsync(Byte) |
Sends data to the server asynchronously.
(Inherited from ClientBase) | |
SendAsync(Object) |
Sends data to the server asynchronously.
(Inherited from ClientBase) | |
SendAsync(String) |
Sends data to the server asynchronously.
(Inherited from ClientBase) | |
SendAsync(Byte, Int32, Int32) |
Sends data to the server asynchronously.
(Inherited from ClientBase) | |
SendDataAsync |
Sends (writes) data to the file asynchronously.
(Overrides ClientBaseSendDataAsync(Byte, Int32, Int32)) | |
ToString | Returns a String containing the name of the Component, if any. This method should not be overridden. (Inherited from Component) | |
UpdateBytesReceived |
Updates the Statistics pertaining to bytes received.
(Inherited from ClientBase) | |
UpdateBytesSent |
Updates the Statistics pertaining to bytes sent.
(Inherited from ClientBase) | |
ValidateConnectionString |
Validates the specified connectionString.
(Overrides ClientBaseValidateConnectionString(String)) |
Name | Description | |
---|---|---|
ConnectionAttempt |
Occurs when client is attempting connection to the server.
(Inherited from ClientBase) | |
ConnectionEstablished |
Occurs when client connection to the server is established.
(Inherited from ClientBase) | |
ConnectionException |
Occurs when an Exception is encountered during connection attempt to the server.
(Inherited from ClientBase) | |
ConnectionTerminated |
Occurs when client connection to the server is terminated.
(Inherited from ClientBase) | |
Disposed | Occurs when the component is disposed by a call to the Dispose method. (Inherited from Component) | |
EndOfFile | Occurs when the end of a file has been reached. | |
ReceiveData |
Occurs when unprocessed data has been received from the server.
(Inherited from ClientBase) | |
ReceiveDataComplete |
Occurs when data received from the server has been processed and is ready for consumption.
(Inherited from ClientBase) | |
ReceiveDataException |
Occurs when an Exception is encountered when receiving data from the server.
(Inherited from ClientBase) | |
SendDataComplete |
Occurs when the client has successfully sent data to the server.
(Inherited from ClientBase) | |
SendDataException |
Occurs when an Exception is encountered when sending data to the server.
(Inherited from ClientBase) | |
SendDataStart |
Occurs when the client begins sending data to the server.
(Inherited from ClientBase) | |
UnhandledUserException |
Occurs when an Exception is encountered in a user-defined function via an event dispatch.
(Inherited from ClientBase) |
Name | Description | |
---|---|---|
DefaultAutoRepeat | Specifies the default value for the AutoRepeat property. | |
DefaultConnectionString | Specifies the default value for the ConnectionString property. | |
DefaultDisconnectAtEOF | Specifies the default value for the DisconnectAtEOF property. | |
DefaultFileAccessMode | Specifies the default value for the FileAccessMode property. | |
DefaultFileOpenMode | Specifies the default value for the FileOpenMode property. | |
DefaultFileShareMode | Specifies the default value for the FileShareMode property. | |
DefaultReceiveInterval | Specifies the default value for the ReceiveInterval property. | |
DefaultReceiveOnDemand | Specifies the default value for the ReceiveOnDemand property. | |
DefaultStartingOffset | Specifies the default value for the StartingOffset property. |
Name | Description | |
---|---|---|
GetEnumValueOrDefault |
Gets the enumeration constant for value, if defined in the enumeration, or a default value.
(Defined by EnumExtensions) | |
GetEnumValueOrDefaultT |
Gets the enumeration constant for this value, if defined in the enumeration, or a default value.
(Defined by EnumExtensions) |
using System; using GSF.Communication; class Program { static FileClient s_client; static void Main(string[] args) { // Initialize the client. s_client = new FileClient(@"File=c:\File.txt"); s_client.Initialize(); // Register event handlers. s_client.ConnectionAttempt += s_client_ConnectionAttempt; s_client.ConnectionEstablished += s_client_ConnectionEstablished; s_client.ConnectionTerminated += s_client_ConnectionTerminated; s_client.SendDataComplete += s_client_SendDataComplete; // Connect the client. s_client.Connect(); // Write user input to the file. string input; while (string.Compare(input = Console.ReadLine(), "Exit", true) != 0) { s_client.Send(input + "\r\n"); } // Disconnect the client on shutdown. s_client.Dispose(); } static void s_client_ConnectionAttempt(object sender, EventArgs e) { Console.WriteLine("Client is connecting to file."); } static void s_client_ConnectionEstablished(object sender, EventArgs e) { Console.WriteLine("Client connected to file."); } static void s_client_ConnectionTerminated(object sender, EventArgs e) { Console.WriteLine("Client disconnected from file."); } static void s_client_SendDataComplete(object sender, EventArgs e) { Console.WriteLine(string.Format("Sent data - {0}", s_client.TextEncoding.GetString(s_client.Client.SendBuffer))); } }
using System; using GSF; using GSF.Communication; class Program { static FileClient s_client; static void Main(string[] args) { // Initialize the client. s_client = new FileClient(@"File=c:\File.txt"); s_client.Initialize(); // Register event handlers. s_client.ConnectionAttempt += s_client_ConnectionAttempt; s_client.ConnectionEstablished += s_client_ConnectionEstablished; s_client.ConnectionTerminated += s_client_ConnectionTerminated; s_client.ReceiveDataComplete += s_client_ReceiveDataComplete; // Connect the client. s_client.Connect(); // Wait for client to read data. Console.ReadLine(); // Disconnect the client on shutdown. s_client.Dispose(); } static void s_client_ConnectionAttempt(object sender, EventArgs e) { Console.WriteLine("Client is connecting to file."); } static void s_client_ConnectionEstablished(object sender, EventArgs e) { Console.WriteLine("Client connected to file."); } static void s_client_ConnectionTerminated(object sender, EventArgs e) { Console.WriteLine("Client disconnected from file."); } static void s_client_ReceiveDataComplete(object sender, EventArgs<byte[], int> e) { Console.WriteLine(string.Format("Received data - {0}", s_client.TextEncoding.GetString(e.Argument1, 0, e.Argument2))); } }