QueryStringConverter Class

 

This class converts a parameter in a query string to an object of the appropriate type. It can also convert a parameter from an object to its query string representation.

Namespace:   System.ServiceModel.Dispatcher
Assembly:  System.ServiceModel.Web (in System.ServiceModel.Web.dll)

System.Object
  System.ServiceModel.Dispatcher.QueryStringConverter
    System.ServiceModel.Dispatcher.JsonQueryStringConverter

type QueryStringConverter = class end

NameDescription
System_CAPS_pubmethodQueryStringConverter()

Initializes a new instance of the QueryStringConverter class.

NameDescription
System_CAPS_pubmethodCanConvert(Type)

Determines whether the specified type can be converted to and from a string representation.

System_CAPS_pubmethodConvertStringToValue(String, Type)

Converts a query string parameter to the specified type.

System_CAPS_pubmethodConvertValueToString(Object, Type)

Converts a parameter to a query string representation.

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

Parameters can be specified in a query string within a URL. This class takes those parameters specified in a string and converts them into objects. For example, the following contract is defined.

[ServiceContract]
interface Calculator
{
   [WebGet(UriTemplate="Add?n1={n1}&n2={n2}")]
   [OperationContract]
   long Add(long n1, long n2);
}

A Windows Communication Foundation (WCF) service implements this interface and exposes it on an endpoint with the WebHttpBehavior at http://localhost:8000/MyCalcService. The Add service operation can be called by sending an HTTP GET to http://localhost:8000/MyCalcService/Add?n1=10&n2=5. The QueryStringConverter receives this URL and converts the two parameters (n1 and n2) specified in the URL into two long objects with the appropriate values.

You can derive a class from QueryStringConverter to control how query string parameters are mapped into a service operation's parameters.

The QueryStringConverter supports the following types by default:

The following code shows how to use the QueryStringConverter class to convert between a string and a 32-bit integer.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 3.5
Silverlight
Available since 4.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: