Web Service Method Attribute Properties

[WebMethod(Description = "This Method Returns Square of given Int Number")]
public int GetSqureByNumber(int number)
{
    int ResultedSqure;
    return ResultedSqure = number * number;
}

Suppose the first time the user makes a request to the method for the addition of 20 and 30 it returns from the method and the output is stored in the cache when the next time a request comes for the same number then the result is returned to the client from the cache instead of executing the function again. The following is the syntax of defining the CacheDuration property for a web method attribute.

For example

[WebMethod(CacheDuration = 100)]
public int GetSqureByNumber(int number)
{
    int ResultedSqure;
    return ResultedSqure = number * number;
}

The preceding method will hold the output in a cache for 100 seconds.

TransactionOption

This property determines whether the transaction is used or not in a method that is supported by the namespace System.EnterpriseServices and it must be used.

The following are some Transaction Options supported by the TransactionOption property.

1. Disabled
2. NotSupported
3. Required
4. RequiresNew
5. Supported.

The following image shows an example of the TransactionOption property.

The preceding example shows the various options of the TransactionOption Property.

BufferResponse

This is a boolean property having true or false values that decides whether or not the output of the request buffer, by default it is true. It is not recommended to buffer the response when the requested output data is huge because the response will become slow when we store a maximum amount of data in the buffer.

The following example shows the syntax and use of the BufferResponse property.

[WebMethod(BufferResponse = false)]
public int GetSquareByNumber(int number)
{
    int ResultedSquare;
    return ResultedSquare = number * number;
}

The preceding property sets the BufferResponse to false.

EnableSession

This property allows the enabling of the session in an XML Web service. Only those web service methods support a session derived from the class System.Web.Services.

It's a boolean property having the values true or false, by default it is false. The following are the session modes supported by the web service method.

1. InProc
2. OutProc
3. Custom
4. Off.

The following example shows the syntax and example of the EnableSession property.

[WebMethod(EnableSession = true)]
public int GetSquareByNumber(int number)
{
    int ResultedSquare;
    return ResultedSquare = number * number;
}

The preceding property enables the session.

MessageName

This property differentiates the two methods having the same name, parameters and type for ease of understanding. Let us see the following example having the same name and the same number of parameters which is method overloading.

For example

[WebMethod(MessageName = "This returns Squre")]
public int GetSqureByNumber(int number)
{
    int ResultedSqure;
    return ResultedSqure = number * number;
}

[WebMethod(MessageName = "This Returns addition of two numbers")]
public int GetSqureByNumber(int number, int b)
{
    int ResultedSqure;
    return ResultedSqure = number + number;
}

In the preceding example, I overloaded the GetSqureByNumber method and at the client site to differentiate the two methods I gave the message of which method does what because if you see in the preceding two methods the names are the same so to avoid difficulty of understanding I have given the message for each method. When you the run code above then see the methods that have the same name.

In the preceding image you have seen the method names are the same but the client doesn't know what method does what. Now click on each method. It shows the message we set for each method name.

Now in the preceding example, you see that at the top of the method, it's showing the message to provide a better understandability of the method. Now click on the second method, and it will show.

See the message at the top, so from all the above examples it is clear that the messageName property is useful for differentiating the methods having the same name.

Note. If you are a beginner to web services then please refer to my following articles.

1. Introduction to Web Service with Example in ASP.Net.
2. Consuming Web Service in Web Application.

Summary

From all the examples we have learned about the web method attribute properties. I hope this article is useful for all students and beginners. If you have any suggestion related to this article then please contact me and thanks to all. This is my article number 100. It happened only because of your huge support and responses.