How To Write Pluggable Protocol to Support FTP in Managed Classes by Using Visual C# .NET (812409)

Create the FtpWebResponse and FtpWebRequest Classes

The WebRequest and WebResponse classes are the basis of pluggable protocols. The descendant classes of WebRequest are registered with the WebRequest class to manage the details of making the actual connections to Internet resources.

In the earlier example of FtpClient, the FtpWebResponse class inherits from the WebResponse class. You have to override ContentType and GetResponseStream methods. The ContentType property provides special information that the client requires to identify the type of content that is delivered by the server. The GetResponseStream method returns a data stream from the internet resource.

In the earlier example, the FtpStream class is used to handle the data stream that is delivered to the server together with the request. The following sample code describes how this is done:

	public class FtpWebResponse : WebResponse
	{
		public override String ContentType 
		{
			get	{/* override */} 
			set { /* override */ }
		}
		public override Stream GetResponseStream()
		{
			/* override */
		}	
	}

Similarly, using WebRequest you can manage the details of a request to an Internet resource. The sample uses the FtpWebRequest class that inherits from the WebRequest class. The WebRequest.Create method creates FTP WebRequest instance based on the URI that is passed. The instance that is returned is a typecast to the FtpWebRequest class to access protocol-specific properties. In most cases, the WebRequest instance provides all the necessary information to formulate a request.

The following example demonstrates the methods that are implemented or overridden in FtpWebRequest class. For more information and implementation, visit the Download Center for the FtpClient.exe file that is mentioned earlier in this article.

	public class FtpWebRequest : WebRequest
	{
		public override String Method
		{/* override */ }
	
		public override ICredentials Credentials 
		{
			/* override */  get {}
			/* override */ set {}
		}

		public override string ConnectionGroupName 
		{
			/* override */ get {}
			/* override */ set {}
		}

		public  override long ContentLength 
		{
			/* override */ get {}
			/* override */ set {}
		}

		public  override string ContentType 
		{
			/* override */ get {}
			/* override */ set {}
		}
		public override IWebProxy Proxy 
		{
			/* override */ get {}
			/* override */ set {}
		}
     
		public override Stream GetRequestStream()
		{/*override*/}
	
		public override WebResponse GetResponse() 
		{/*override*/}
	}

back to top

Create FtpClient

The FtpClient application accesses the information from the Internet using a request-response model. You can retrieve protocol-specific information by using the WebRequest and WebResponse classes. To retrieve protocol-specific information, register the descendants of WebRequest by using the WebRequest.RegisterPrefix static method. The IWebRequestCreate interface defines the method that WebRequest descendants will use to register with the WebRequest.Create method.

The following sample code demonstrates how to use IWebRequestCreate:

public class FtpRequestCreator : IWebRequestCreate
{
    public FtpRequestCreator()
    {
    }
    
    public WebRequest Create(Uri  Url)

    {
        return new FtpWebRequest(Url);
    }
}

The following sample code demonstrates how the RegisterPrefix method is used and how to create a WebRequest instance:

		// FtpRequestCreator class implements IWebRequestCreate class, which implement Create method
 FtpRequestCreator Creator = new FtpRequestCreator();
	WebRequest.RegisterPrefix("ftp:", Creator);

	String szUri= new String("ftp://localhost");

	// Create WebRequest
	WebRequest w = WebRequest.Create(szUri);

The WebRequest.RegisterPrefix method registers the class and notifies the descendants to use FTP protocol for retrieving the data. After registration, descendants of WebRequest are created by using the WebRequest.Create method with an argument passed as URI. The WebRequest instance exposes properties, such as GetResponse, that control the request to the server and access to the data stream that is sent to the server. The GetResponse method of the WebRequest instance sends the request from the client application to the server that is identified in the URI.

	WebResponse r = w.GetResponse();
	Stream respstream = r.GetResponseStream();
	if(respstream.CanRead) 
	{
		StreamReader rdr = new StreamReader(respstream);
		String resp = rdr.ReadToEnd();
		rdr.Close();
		Console.WriteLine(resp);		
	}	

The GetResponse method returns a WebResponse instance. The WebResponse provides access to the data that is returned by the server in the form of a stream returned by the GetResponseStream method. This stream can be used and modified in an application. You can derive a class from the stream class and override the method, based on application requirements.

For more information, visit the Download Center for the FtpClient.exe file that is mentioned earlier in this article.

back to top

Steps to Run the FtpClient Executable

1. Download the FtpClient.exe file that is mentioned earlier in this article.
2. Extract the file.
3. Open the Readme.htm file in the browser.
4. To read the steps to build the application, click Building the sample.
5. To read the steps to run the application, click Running the sample.

back to top