QueryStringConverter Classe

Definição

Espaço de Nomes:
System.ServiceModel.Dispatcher
Assemblagem:
System.ServiceModel.Web.dll

Esta classe converte um parâmetro numa cadeia de consulta num objeto do tipo apropriado. Também pode converter um parâmetro de um objeto para a sua representação da cadeia de consulta.

public ref class QueryStringConverter
public class QueryStringConverter
type QueryStringConverter = class
Public Class QueryStringConverter
Herança
Object
QueryStringConverter
Derivado

Exemplos

O código seguinte 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)

Observações

Os parâmetros podem ser especificados numa cadeia de consulta dentro de uma URL. Esta classe pega nos parâmetros especificados numa cadeia e converte-os em objetos. Por exemplo, está definido o seguinte contrato.

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

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

Pode derivar uma classe de QueryStringConverter para controlar como os parâmetros da string de consulta são mapeados para os parâmetros de uma operação de serviço.

Suporta QueryStringConverter os seguintes tipos por defeito:

Construtores

Name Description
QueryStringConverter()

Inicializa uma nova instância da QueryStringConverter classe.

Métodos

Name Description
CanConvert(Type)

Determina se o tipo especificado pode ser convertido para e a partir de uma representação de cadeia.
ConvertStringToValue(String, Type)

Converte um parâmetro de cadeia de consulta para o tipo especificado.
ConvertValueToString(Object, Type)

Converte um parâmetro numa representação de uma cadeia de consulta.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a