{"id":145,"date":"2011-10-27T13:12:56","date_gmt":"2011-10-27T05:12:56","guid":{"rendered":"https:\/\/www.techcoil.com\/blog\/?p=145"},"modified":"2018-09-03T21:09:46","modified_gmt":"2018-09-03T13:09:46","slug":"the-http-response-and-how-it-relates-to-system-net-httplistener","status":"publish","type":"post","link":"https:\/\/www.techcoil.com\/blog\/the-http-response-and-how-it-relates-to-system-net-httplistener\/","title":{"rendered":"The HTTP response and how it relates to System.Net.HttpListener"},"content":{"rendered":"

This is part 3 of the sequel to \"How to build a web based user interaction layer in C#<\/a>\". In this post, I will discuss how to send a HTTP response back to the client.<\/p>\n

In part 1, we learn how we can get an instance of the System.Net.HttpListenerContext class whenever a client sends a HTTP request<\/a>.<\/p>\n

In part 2, we learn how we can process the HTTP request received from the client in your C# program<\/a>. <\/p>\n

Continuing the sequel<\/h3>\n

An instance of the System.Net.HttpListenerResponse<\/a> class will be available via the Response<\/a> property from the same HttpListenerContext<\/code> instance that was received from the HttpListener<\/code> instance when a client sends a HTTP request. <\/p>\n

\r\nHttpListenerResponse serverResponse = context.Request;\r\n<\/pre>\n
We can use the HttpListenerResponse<\/code> instance to send build a HTTP response to send back to the client.<\/p>\n
The HTTP status code<\/h3>\n
The HTTP status code<\/a> is a way to reflect the outcome of processing the HTTP request that the client sent. For instance, to indicate that a HTTP request is successfully processed, we set 200 to the StatusCode<\/code><\/a> property of the HttpListenerResponse<\/code> instance. We can also use the OK<\/code> value from the System.Net.HttpStatusCode<\/a> enumeration to do that.<\/p>\n
\r\nserverResponse.StatusCode = (int) System.Net.HttpStatusCode.OK;\r\n<\/pre>\n
The content type<\/h3>\n
The ContentType<\/a> property of the HttpListenerResponse<\/code> class can be set to let the client know what kind of content is contained in the HTTP response body. <\/p>\n
\r\n\/\/ Indicate that the response body contain a HTML document\r\nserverResponse.ContentType = "text\/html";\r\n<\/pre>\n
The length of the content<\/h3>\n
The ContentLength64<\/code><\/a> property of the HttpListenerResponse<\/code> class describe the size of the HTTP response body that the client will be receiving, in bytes.<\/p>\n
\r\n\/\/ Set the size of the HTML file as the content length\r\n\/\/ of the HTTP response\r\nserverResponse.ContentLength64 = htmlFileInfo.Length;\r\n<\/pre>\n
The content<\/h3>\n
With the OutputStream<\/code><\/a> property of the HttpListenerResponse instance, you can fill the contents for the HTTP response body. <\/p>\n
\r\nSystem.IO.Stream serverResponseOutput = serverResponse.OutputStream;\r\n<\/pre>\n
Send the response back to the client<\/h3>\n
After you are done with filling up the HttpListenerResponse<\/code> instance with information for the HTTP response, you need to call the Close<\/code><\/a> method to send it back to the client.<\/p>\n
\r\nserverResponse.Close();\r\n<\/pre>\n
Next in the line<\/h3>\n
This concludes part 3 of \"How to build a web based user interaction layer in C#<\/a>\".<\/p>\n
In part 4, I will sum up the sequel with how to implement a mechanism for serving HTTP requests in C#<\/a>.<\/p>\n
Further reading elsewhere<\/h3>\n
What I had mentioned in this post is probably enough for your C# program to construct HTTP responses back to clients in most situation. If your program needs to furnish more information in the HTTP responses to clients, check out the MSDN reference for the System.Net.HttpListenerResponse<\/code> class<\/a>.   <\/p>\n\n