[ Microsoft’s MSDN ] – Recommended Tags for Documentation Comments

Recommended Tags for Documentation Comments (C# Programming Guide)

The C# compiler processes documentation comments in your code and formats them as XML in a file whose name you specify in the /doc command-line option. To create the final documentation based on the compiler-generated file, you can create a custom tool, or use a tool such as Sandcastle.

Here are some Recommended Tags for Documentation Comments

<c>

<para>

<see>*

<code>

<param>*

<seealso>*

<example>

<paramref>

<summary>

<exception>*

<permission>*

<typeparam>*

<include>*

<remarks>

<typeparamref>

<list>

<returns>

<value>

Advertisements

[ Microsoft’s MSDN ] The Summary Tag in C#

(C# Programming Guide)

The <summary> tag should be used to describe a type or a type member. Use <remarks> to add supplemental information to a type description. Use the cref Attribute to enable documentation tools such as Sandcastle to create internal hyperlinks to documentation pages for code elements.

The text for the <summary> tag is the only source of information about the type in IntelliSense, and is also displayed in the Object Browser Window.

Compile with /doc to process documentation comments to a file. To create the final documentation based on the compiler-generated file, you can create a custom tool, or use a tool such as Sandcastle.

[ Stack Overflow ] c# – What is the difference between explicit and implicit type casts?

c# – What is the difference between explicit and implicit type casts? – Stack Overflow

What is the difference between explicit and implicit type casts?

What’s the difference between the President of the United States and the President of Canada?

Since there is no President of Canada, it’s hard to answer the question. The right thing to do is to push back and ask for clarification of the question. By “the President of Canada”, does the questioner mean the Queen (ceremonial head of state), the Governor General (who can veto bills) or the Prime Minister (who effectively acts as the executive), or something else? Hard to say without clarification.

And even with clarification, it’s a vague question. What differences do you want to know about?

Since there is no such thing as an “implicit cast” in C# it is hard to answer your question. In C#, casting is an operator. So I’ll push back on it.

Did you mean to ask “what’s the difference between an explicit conversion and an implicit conversion?” Or did you mean to ask about the semantics of the cast operator? Or the difference between the cast operator and other type conversion operators? Or situations in which cast operators can be “implicitly” inserted into your code by the compiler? (For example, the foreach loop and the += operator can both implicitly insert an invisible cast.)

[ Stack Overflow ] – c# – httpWebRequest (The underlying connection was closed: The connection was closed unexpectedly.)

In beginning coding in C# DotNet, we usually come across such errors, and it’s good to look into them, see link below for more details

c# – httpWebRequest (The underlying connection was closed: The connection was closed unexpectedly.) – Stack Overflow

.NET has a bug where it expects that the server will include a Connection: close response header if it will close the connection after the response is complete. If the server closes the connection without the Connection: Close header (entirely valid per RFC2616), .NET will encounter the closed connection when attempting to send the next request on the connection and it will throw this exception. What .NET should be doing is silently creating a new connection and resending the request on that new connection.

[ 4GuysFromRolla.com ] Parsing HTML Documents with the Html Agility Pack

Parsing HTML Documents with the Html Agility Pack – 4GuysFromRolla.com

Screen scraping is the process of programmatically accessing and processing information from an external website. For example, a price comparison website might screen scrape a variety of online retailers to build a database of products and what various retailers are selling them for. Typically, screen scraping is performed by mimicking the behavior of a browser – namely, by making an HTTP request from code and then parsing and analyzing the returned HTML.

The .NET Framework offers a variety of classes for accessing data from a remote website, namely the WebClient class and the HttpWebRequest class. These classes are useful for making an HTTP request to a remote website and pulling down the markup from a particular URL, but they offer no assistance in parsing the returned HTML. Instead, developers commonly rely on string parsing methods like String.IndexOf, String.Substring, and the like, or through the use of regular expressions.

Another option for parsing HTML documents is to use the Html Agility Pack, a free, open-source library designed to simplify reading from and writing to HTML documents. The Html Agility Pack constructs a Document Object Model (DOM) view of the HTML document being parsed. With a few lines of code, developers can walk through the DOM, moving from a node to its children, or vice versa. Also, the Html Agility Pack can return specific nodes in the DOM through the use of XPath expressions. (The Html Agility Pack also includes a class for downloading an HTML document from a remote website; this means you can both download and parse an external web page using the Html Agility Pack.)

This article shows how to get started using the Html Agility Pack and includes a number of real-world examples that illustrate this library’s utility. A complete, working demo is available for download at the end of this article. Read on to learn more!

Creating virtual hosts in XAMPP

If you do not want to keep your files in the xampp/htdocs directory and type in a long URL for every page load, you can create virtual hosts for each of your sites instead. For example, you may like to keep all your sites in your My Documents folder for easy backup. Or you could create a root directory on your hard drive such as c:/sites/example/ which will make using shell commands easier. Wherever you choose to store your sites, you can always easily move them at a later date. Continue reading