QueryStringConverter Classe

Definição

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.Web.dll

Essa classe converte um parâmetro contido em uma cadeia de caracteres de consulta em um objeto do tipo apropriado. Ela também pode converter um parâmetro de um objeto em sua representação de cadeia de caracteres de consulta.

public ref class QueryStringConverter

public class QueryStringConverter

type QueryStringConverter = class

Public Class QueryStringConverter

Herança

Object

QueryStringConverter

Derivado

System.ServiceModel.Dispatcher.JsonQueryStringConverter

Exemplos

O código a seguir mostra como usar a QueryStringConverter classe para converter entre uma cadeia de caracteres e um inteiro de 32 bits.

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)

Comentários

Os parâmetros podem ser especificados em uma cadeia de caracteres de consulta dentro de uma URL. Essa classe usa esses parâmetros especificados em uma cadeia de caracteres e os converte em objetos. Por exemplo, o contrato a seguir é definido.

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

Um serviço WCF (Windows Communication Foundation) implementa essa interface e a expõe em um ponto de extremidade com o WebHttpBehavior em http://localhost:8000/MyCalcService. A Add operação de serviço pode ser chamada enviando um HTTP GET para http://localhost:8000/MyCalcService/Add?n1=10&n2=5. O QueryStringConverter recebe essa URL e converte os dois parâmetros (n1 e n2) especificados na URL em dois long objetos com os valores apropriados.

Você pode derivar uma classe de QueryStringConverter para controlar como os parâmetros de cadeia de caracteres de consulta são mapeados para os parâmetros de uma operação de serviço.

O QueryStringConverter dá suporte aos seguintes tipos por padrão:

• Byte

• SByte

• Int16

• Int32

• Int64

• UInt16

• UInt32

• UInt64

• Single

• Double

• Char

• Decimal

• Boolean

• String

• DateTime

• TimeSpan

• Guid

• Matriz Byte

• Uri

• Object

• DateTimeOffset

• Enumerações

• Os tipos que têm um TypeConverterAttribute que pode converter o tipo em uma representação de cadeia de caracteres.

Construtores

QueryStringConverter()

Inicializa uma nova instância da classe QueryStringConverter.

Métodos

CanConvert(Type)	Determina se o tipo especificado pode ser convertido em uma representação de cadeia de caracteres.
ConvertStringToValue(String, Type)	Converte um parâmetro de cadeia de caracteres de consulta no tipo especificado.
ConvertValueToString(Object, Type)	Converte um parâmetro em uma representação de cadeia de caracteres de consulta.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)