QueryStringConverter Class

Definition

Cette classe convertit un paramètre dans une chaîne de requête en un objet du type approprié.This class converts a parameter in a query string to an object of the appropriate type. Elle peut également convertir un paramètre à partir d'un objet en sa représentation sous forme de chaîne de requête.It can also convert a parameter from an object to its query string representation.

public ref class QueryStringConverter
public class QueryStringConverter
type QueryStringConverter = class
Public Class QueryStringConverter
Inheritance
QueryStringConverter
Derived

Examples

Le code suivant illustre la classe QueryStringConverter afin de convertir entre une chaîne et un entier 32 bits.The following code shows how to use the QueryStringConverter class to convert between a string and a 32-bit integer.

QueryStringConverter converter = new QueryStringConverter();
if (converter.CanConvert(typeof(Int32)))
    converter.ConvertStringToValue("123", typeof(Int32));
int value = 321;
string strValue = converter.ConvertValueToString(value, typeof(Int32));
Console.WriteLine("the value = {0}, the string representation of the value = {1}", value, strValue);
Dim converter As New QueryStringConverter()
If (converter.CanConvert(GetType(Int32))) Then
    converter.ConvertStringToValue("123", GetType(Int32))
End If

Dim value As Integer = 321
Dim strValue As String = converter.ConvertValueToString(value, GetType(Int32))
Console.WriteLine("the value = {0}, the string representation of the value = {1}", value, strValue)

Remarks

Des paramètres peuvent être spécifiés dans une chaîne de requête dans une URL.Parameters can be specified in a query string within a URL. Cette classe prend les paramètres spécifiés dans une chaîne et les convertit en objets.This class takes those parameters specified in a string and converts them into objects. Par exemple, le contrat suivant est défini.For example, the following contract is defined.

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

Un service Windows Communication Foundation (WCF) implémente cette interface et l’expose sur un point de terminaison avec le WebHttpBehavior à http://localhost:8000/MyCalcService.A Windows Communication Foundation (WCF) service implements this interface and exposes it on an endpoint with the WebHttpBehavior at http://localhost:8000/MyCalcService. L’opération de service Add peut être appelée en envoyant un HTTP d’extraction à http://localhost:8000/MyCalcService/Add?n1=10&n2=5.The Add service operation can be called by sending an HTTP GET to http://localhost:8000/MyCalcService/Add?n1=10&n2=5. QueryStringConverter reçoit cette URL et convertit les deux paramètres (n1 et n2) spécifiés dans l'URL en deux objets long avec les valeurs appropriées.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.

Vous pouvez dériver une classe de QueryStringConverter pour contrôler comment les paramètres de chaîne de requête sont mappés dans les paramètres d'une opération de service.You can derive a class from QueryStringConverter to control how query string parameters are mapped into a service operation's parameters.

QueryStringConverter prend en charge les types suivants par défaut :The QueryStringConverter supports the following types by default:

Constructors

QueryStringConverter()

Initialise une nouvelle instance de la classe QueryStringConverter.Initializes a new instance of the QueryStringConverter class.

Methods

CanConvert(Type)

Détermine si le type spécifié peut être converti vers et depuis une représentation sous forme de chaîne.Determines whether the specified type can be converted to and from a string representation.

ConvertStringToValue(String, Type)

Convertit un paramètre de chaîne de requête en type spécifié.Converts a query string parameter to the specified type.

ConvertValueToString(Object, Type)

Convertit un paramètre en une représentation sous forme de chaîne.Converts a parameter to a query string representation.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Applies to