QueryStringConverter Classe

Definizione

Spazio dei nomi:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.Web.dll

Questa classe converte un parametro di una stringa di query in un oggetto del tipo adatto. Può inoltre convertire un parametro da un oggetto nella relativa rappresentazione della stringa di query.

public ref class QueryStringConverter

public class QueryStringConverter

type QueryStringConverter = class

Public Class QueryStringConverter

Ereditarietà

Object

QueryStringConverter

Derivato

System.ServiceModel.Dispatcher.JsonQueryStringConverter

Esempio

Nel codice seguente viene illustrato l'utilizzo della classe QueryStringConverter per eseguire la conversione tra una stringa e un valore integer a 32 bit.

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)

Commenti

È possibile specificare parametri in una stringa di query all'interno di un URL. Questa classe accetta i parametri specificati in una stringa e li converte in oggetti. Si supponga, ad esempio, che venga definito il contratto seguente:

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

Un servizio Windows Communication Foundation (WCF) implementa questa interfaccia ed espone l'interfaccia in un endpoint con all'indirizzo WebHttpBehavior .http://localhost:8000/MyCalcService È possibile chiamare l'operazione Add del servizio inviando un HTTP GET a http://localhost:8000/MyCalcService/Add?n1=10&n2=5. QueryStringConverter riceve l'URL e converte i due parametri (n1 e n2) specificati nell'URL in due oggetti long con i valori appropriati.

È possibile derivare una classe da QueryStringConverter per controllare la modalità di esecuzione del mapping dei parametri della stringa di query ai parametri di un'operazione del servizio.

Per impostazione predefinita, QueryStringConverter supporta i seguenti tipi:

• Byte

• SByte

• Int16

• Int32

• Int64

• UInt16

• UInt32

• UInt64

• Single

• Double

• Char

• Decimal

• Boolean

• String

• DateTime

• TimeSpan

• Guid

• Matrice Byte

• Uri

• Object

• DateTimeOffset

• Enumerazioni

• Tipi con TypeConverterAttribute in grado di convertire il tipo in e da una rappresentazione di stringa.

Costruttori

QueryStringConverter()

Inizializza una nuova istanza della classe QueryStringConverter.

Metodi

CanConvert(Type)	Determina se sia possibile convertire il tipo specificato in e da una rappresentazione di stringa.
ConvertStringToValue(String, Type)	Converte un parametro della stringa di query nel tipo specificato.
ConvertValueToString(Object, Type)	Converte un parametro in una rappresentazione della stringa di query.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)