Rebex.Net.ProxySocket Provides methods for constructing exception messages. Represents a block of unmanaged memory. Allocates a block of unmanaged memory with the specified length. The length of unmanaged memory block. Creates an unmanaged block that represents a block of memory specified by the supplied pointer. Pointer to a block of unmanaged memory. Returns a pointer to the current unmanaged memory block. A pointer to unamanged memory block. Reads a 32-bit signed integer from the specified offset of the memory block. Offset in the memory block. Writes a 32-bit signed integer to the specified offset of the memory block. Offset in the memory block. The value to write. Writes a pointer to the specified offset of the memory block. Offset in the memory block. The value to write. Disposes the object and releases resources. Calling this method ensures that all resources are freed. Releases the unmanaged resources and optionally releases the managed resources. true to release both managed and unmanaged resources; false to release only unmanaged resources. Finalizer called by garbage collector. Contains proxy settings for a socket connection. Initializes a new instance of the class with serialized data. The object that holds the serialized object data. The contextual information about the source or destination. Sets the with information about the . The object that holds the serialized object data. The contextual information about the source or destination. Creates a copy of the instance. A new instance. Returns the proxied URI for a destination. The of the requested FTP server. The of the FTP server if the resource is on the bypass list; otherwise, the of the proxy. Indicates whether to use the proxy server for the specified host. The of the host to check for proxy use. true if the proxy server should not be used for host; otherwise, false. Indicates whether to use the proxy server for the specified host. The host address to check for proxy use. The port port. true if the proxy server should not be used for host; otherwise, false. Initializes an empty instance of the class. The default constructor initializes an empty instance of the class with the property set to ProxyType.None. When the is set to ProxyType.None, the method returns true, and the method returns the destination address. Initializes a new instance of the class with the specified type, hostname, and port. The type of the proxy. The hostname of the proxy server. The port of the proxy server. Initializes a new instance of the class with the specified type, hostname, port, and username. The type of the proxy. The hostname of the proxy server. The port of the proxy server. A user name to submit to the proxy server for authentication. Initializes a new instance of the class with the specified type, hostname, port, and credentials with base authentification. The type of the proxy. Authentication method. The hostname of the proxy server. The port of the proxy server. A to submit to the proxy server for authentication. Initializes a new instance of the class with the specified type, hostname, port, bypass setting, list of URIs to bypass, and credentials, with base authentification. The type of the proxy. Authentication method. The hostname of the proxy server. The port of the proxy server. true to bypass the proxy for local addresses; otherwise, false. A to submit to the proxy server for authentication. Initializes a new instance of the class with the specified type, hostname, port, bypass setting, list of URIs to bypass, and credentials. The type of the proxy. Authentication method. The hostname of the proxy server. The port of the proxy server. true to bypass the proxy for local addresses; otherwise, false. An array of regular expression strings containing the URIs of the servers to bypass. A to submit to the proxy server for authentication. Not supported by Rebex FTP for .NET Compact Framework. Gets or sets the hostname of the proxy server. The hostname of the proxy server. Gets or sets the port of the proxy server. The port of the proxy server. Gets or sets the type of the proxy server. The type of the proxy server. Gets or sets the authentication method to use for HTTP CONNECT proxy. An authentication method. Gets or sets the credentials to submit to the proxy server for authentication. An containing the credentials to submit to the proxy server for authentication. Only credentials of type are supported. Gets or sets the username to submit to the proxy server for authentication. A username to submit to the proxy server for authentication. Gets or sets the username to submit to the proxy server for authentication. A username to submit to the proxy server for authentication. Gets or sets the domain to submit to the proxy server for authentication. A domain to submit to the proxy server for authentication. Gets or sets a value indicating whether to bypass the proxy server for local addresses. true to bypass the proxy server for local addresses; otherwise, false. The default value is false. Gets a list of addresses that do not use the proxy server. An containing a list of regular expressions that describe URIs that will not use the proxy server when accessed. Not supported by Rebex FTP for .NET Compact Framework. Gets or sets an array of addresses that do not use the proxy server. An array containing a list of regular expressions that describe URIs that will not use the proxy server when accessed. Not supported by Rebex FTP for .NET Compact Framework. Base class for proxied sockets. Implements socket connections through HTTP CONNECT method. HTTP CONNECT proxy server authentication method. Basic authentication. NTLM authentication. Type of proxy to use to connect to the remote machine. No proxy. Direct connection. Connection through Socks4 proxy. Connection through Socks4A proxy (capable of resolving domain names). Connection through Socks5 proxy. Connection through HTTP proxy using the CONNECT method. Defines status codes for the class. The remote service point could not be contacted at the transport level. The connection was prematurely closed The error at transport level occured. The name resolver service could not resolve the host name. The response received from the server was complete but indicated a protocol-level error. For example, an FTP protocol error such as 550 Access Denied would use this status. The name resolver service could not resolve the proxy host name. A complete response was not received from the remote server. An unclassifiable error occurred. This is the default value for . The server response was not a valid response. General exception in asynchronous call. The socket is not connected. The exception that is thrown when a proxy error or socket error occurs. Initializes a new instance of the class with serialized data. The object that holds the serialized object data. The contextual information about the source or destination. Sets the with information about the . The object that holds the serialized object data. The contextual information about the source or destination. Initializes a new instance of the class with the specified error message and status. The message that describes the error. One of the values. Initializes a new instance of the class with the specified error message, status, and a reference to the inner exception that is the cause of this exception. The message that describes the error. One of the values. The exception that is the cause of the current exception. If the innerException parameter is not a null reference, the current exception is raised in a catch block that handles the inner exception. Initializes a new instance of the class with the reference to the socket exception that is the cause of this exception. The socket exception that is the cause of the current exception. Returns an exception message for the supplied SocketException. Socket exception. Exception message. Gets the status of the error. One of the values. Gets the error code associated with this exception if the error status is SocketError. Returns 0 otherwise. An integer error code associated with this exception (or 0). Represents a TCP/IP port range. Specifies a port range that makes the OS assign an available port number. Creates a port range that includes a single port. Returns the string representation of the port range. Port range. Creates a port range that includes a single port. Implements the subset of the Berkeley sockets interface (or the class) and adds the ability to connect through Socks4/Socks5 or HTTP proxies.

This class is suitable for extending your client applications with the ability to connect through proxies.

This class is limited to operations supported by proxies - it is not a replacementfor the . This means it is perfect for writing clients, but useless for writing servers.

Only connection-oriented protocols are supported at the moment

Initializes an empty instance of the class. The default constructor initializes an instance of the class with the property set to ProxyType.None. Initializes a new instance of the class with the specified proxy type, hostname, and port. The type of the proxy. The hostname of the proxy server. The port of the proxy server. Initializes a new instance of the class with the specified type, hostname, port, and username. The type of the proxy. The hostname of the proxy server. The port of the proxy server. A user name to submit to the proxy server for authentication. Initializes a new instance of class with parameters provided in the supplied object. Contains parameters used to initialize this . Initializes a new instance of the class with the specified type, hostname, port, and credentials. The type of the proxy. The hostname of the proxy server. The port of the proxy server. A user name to submit to the proxy server for authentication. A password to submit to the proxy server for authentication. Initializes a new instance of the class with the specified type, authentication method, hostname, port, and credentials. The type of the proxy. Authentication method. The hostname of the proxy server. The port of the proxy server. A user name to submit to the proxy server for authentication. A password to submit to the proxy server for authentication. A domain to submit to the proxy server for authentication. Sends data to a connected . The data to be sent. The number of bytes sent. Prior to sending data, the socket must be connected using either a call to method or a call to and methods. Sends data to a connected using the supplied flags. The data to be sent. A bitwise combination of the values. The number of bytes sent. Prior to sending data, the socket must be connected using either a call to method or a call to and methods. Sends the specified amount of data to a connected using the supplied flags. The data to be sent. The number of bytes to send. A bitwise combination of the values. The number of bytes sent. Prior to sending data, the socket must be connected using either a call to method or a call to and methods. Sends the specified amount of data to a connected starting at the indicated location in the data and using the supplied flags. The data to be sent. The position in the data buffer to begin sending data. The number of bytes to send. A bitwise combination of the values. The number of bytes sent. Prior to sending data, the socket must be connected using either a call to method or a call to and methods. Sends data asynchronously to a connected . The data to be sent. The position in the data buffer to begin sending data. The number of bytes to send. A bitwise combination of the values. The delegate. An object containing state information for this request. An that references the asynchronous send.

Prior to sending data, the socket must be connected using either a call to method or a call to and methods.

The BeginSend method starts asynchronously sending data through a ProxySocket. You should create a callback method that implements the AsyncCallback delegate. This callback method should use the EndSend method to complete the asynchronous operation. See the .NET Framework SDK Reference for more information on asynchronous methods.

Receives data from a connected . The storage location for the received data. The number of bytes received. Prior to receiving data, the socket must be connected using either a call to method or a call to and methods. Receives data from a connected using the supplied flags. The storage location for the received data. A bitwise combination of the values. The number of bytes received. Prior to receiving data, the socket must be connected using either a call to method or a call to and methods. Receives the specified amount of data from a connected using the supplied flags. The storage location for the received data. The number of bytes to receive. A bitwise combination of the values. The number of bytes received. Prior to receiving data, the socket must be connected using either a call to method or a call to and methods. Receives the specified amount of data from a connected into a specific location of the receive buffer and using the supplied flags. The storage location for the received data. The position in the buffer at which to store the received data. The number of bytes to receive. A bitwise combination of the values. The number of bytes received. Prior to receiving data, the socket must be connected using either a call to method or a call to and methods. Begins to asynchronously receive data from a connected . The storage location for the received data. The position in the buffer at which to store the received data. The number of bytes to receive. A bitwise combination of the values. The delegate. An object containing state information for this request. An that references the asynchronous read.

Prior to receiving data, the socket must be connected using either a call to method or a call to and methods.

The BeginReceive method starts asynchronously reading data from a ProxySocket. You should create a callback method that implements the AsyncCallback delegate. This callback method should use the EndSend method to complete the asynchronous operation. See the .NET Framework SDK Reference for more information on asynchronous methods.

Ends a pending asynchronous send. Stores state information for this asynchronous operation as well as any user-defined data. The number of bytes sent. The EndSend method completes a request to accept a connection that was started with the method. Ends a pending asynchronous read. Stores state information for this asynchronous operation as well as any user-defined data. The number of bytes received. The EndReceive method completes a request to accept a connection that was started with the method. Forces a connection to close.

The application should call before calling Close to ensure that all pending data is sent or received before the Socket is closed.

Disables sends and receives on a . The value specifying the operation that will no longer be allowed. See the reference for for details. Converts the host address and port into an IP endpoint. If host is not IP address, returns null. Host IP address. Host port. IP endpoint. Returns the long value of the IP address of the instance of IPAddress. An instance of IPAddress. The long value of the IP address. Returns an array of bytes of the IP address of the instance of IPAddress. An instance of IPAddress. An array of address bytes. Starts a request to listen for an incoming connection using the specified control socket as a base. The control socket to use as a base. The endpoint to which a connection from a remote host can be made.

This method differs from :

  • A control connection socket needs to be specified. This is used by a proxy server to decide whether the request for Listen is appropriate.
  • Only a single incoming connection is accepted by a proxy server.
To accept an incoming connection, use the or method of the same instance.

Note: When not connected through a proxy server, the controlSocket parameter is ignored.

Note: When connected through a HTTP proxy server, this method will fail.

Establishes a connection to a remote device. The hostname (or IP address) of the remote device. The port number associated with the hostname. The Connect method establishes a network connection to a device identified by the remoteEP parameter. Once the connection has been made, you can send data to the remote device with the Send method, or receive data from the remote device with the Receive method. Establishes a connection to a remote device. An that represents the remote device. The Connect method establishes a network connection to a device identified by the remoteEP parameter. Once the connection has been made, you can send data to the remote device with the Send method, or receive data from the remote device with the Receive method. Acepts an incoming connection.

A call to Accept is only allowed after a call to or methods of the same instance.

This method differs to a great extent from . It does not return a new instance of the class. Instead, the current instance is used to handle the incoming connection.

Starts an asynchronously request to listen for an incoming connection using the specified control socket as a base. The control socket to use as a base. The delegate. An object containing state information for this request. An that references the asynchronous request.

This method differs from :

  • A control connection socket needs to be specified. This is used by a proxy server to decide whether the request for Listen is appropriate.
  • Only a single incoming connection is accepted by a proxy server.
To accept an incoming connection, use the or method of the same instance.

Note: When connected through a HTTP proxy server, this method will fail.

Begins an asynchronous request to accept an incoming connection. The delegate. An object containing state information for this request. An that references the asynchronous request.

A call to Accept is only allowed after a call to or methods of the same instance.

This method differs to a great extent from . It does not return a new instance of the class. Instead, the current instance is used to handle the incoming connection.

Begins an asynchronous request for a connection to a network device. The hostname (or IP address) of the remote device. The port number associated with the hostname. The delegate. An object containing state information for this request. An that references the asynchronous connection. The Connect method establishes a network connection to a device identified by the remoteEP parameter. Once the connection has been made, you can send data to the remote device with the Send method, or receive data from the remote device with the Receive method. Begins an asynchronous request for a connection to a network device. An that represents the remote device. The delegate. An object containing state information for this request. An that references the asynchronous connection. The Connect method establishes a network connection to a device identified by the remoteEP parameter. Once the connection has been made, you can send data to the remote device with the Send method, or receive data from the remote device with the Receive method. Ends a pending asynchronous connection request. Stores state information for this asynchronous operation as well as any user-defined data. The EndConnect method completes a request to accept a connection that was started with the method. Ends an asynchronous request to accept an incoming connection. Stores state information for this asynchronous operation as well as any user defined data. The EndAccept method completes a request to accept a connection that was started with the method. Ends an asynchronous request to listen for an incoming connection. Stores state information for this asynchronous operation as well as any user defined data. The endpoint to which a connection from a remote host can be made. The EndListen method completes a request to listen for a connection that was started with the method. Gets or sets the hostname of the proxy server. The hostname of the proxy server. Gets or sets the port of the proxy server. The port of the proxy server. Gets or sets the local TCP port range to which to bind the connections. The port range. Gets or sets the type of the proxy server. The type of the proxy server. Gets or sets the authentication method to use for HTTP CONNECT proxy. An authentication method. Gets or sets the username to submit to the proxy server for authentication. A username to submit to the proxy server for authentication. Gets or sets the username to submit to the proxy server for authentication. A username to submit to the proxy server for authentication. Gets or sets the domain to submit to the proxy server for authentication. A domain to submit to the proxy server for authentication. Gets or sets the length of time before the , or operation times out. The length of time, in milliseconds, until the operation times out, or the value -1 or 0 to indicate that the request does not time out. Default is -1. Gets the internal value. The internal value. Gets the remote endpoint. The remote endpoint that the is using for communications. The RemoteEndPoint property gets the network connection information associated with either the remote host or the proxy server. RemoteEndPoint is set by methods that establish a connection to a remote host. Gets the local endpoint. The local endpoint that the is using for communications. The LocalEndPoint property contains the network connection information associated with the local network device. Gets a value indicating whether a is connected to a remote resource. true if the is connected to a remote resource; otherwise, false.

Gets the connection state of the . This property will return the latest known state of the ProxySocket. When it returns false, the ProxySocket was either never connected, or no longer connected. When it returns true, the ProxySocket was connected at the time of the last I/O operation or the property.

Note: There is no guarantee that the Socket is still connected even though Connected returns true.

Gets the amount of data that has been received from the network and is available to be read. The number of bytes of data that has been received from the network and are available to be read, or 0 if either no data is available or the is no longer connected.

The available data is generally the total amount of data queued on the current instance, or -1 if the socket was closed.

Gets the operating system handle for the inner . An representing the operating system handle for the . Implements Socks4 and Socks4a protocols. Implements Socks5 protocol.