QueryStringConverter Klasse

Definition

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.Web.dll

Diese Klasse konvertiert einen Parameter in einer Abfragezeichenfolge in ein Objekt des entsprechenden Typs. Außerdem kann diese Klasse einen Parameter von einem Objekt in seine Abfragezeichenfolgendarstellung konvertieren.

public ref class QueryStringConverter

public class QueryStringConverter

type QueryStringConverter = class

Public Class QueryStringConverter

Vererbung

Object

QueryStringConverter

Abgeleitet

System.ServiceModel.Dispatcher.JsonQueryStringConverter

Beispiele

Im folgenden Codebeispiel wird die Verwendung der QueryStringConverter-Klasse zum Konvertieren zwischen einer Zeichenfolge und einer 32-Bit-Ganzzahl veranschaulicht.

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)

Hinweise

Parameter können in einer Abfragezeichenfolge in einem URL angegeben werden. Diese Klasse konvertiert die in einer Zeichenfolge angegebenen Parameter in Objekte. Beispielsweise kann der folgende Vertrag definiert werden.

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

Ein Windows Communication Foundation (WCF)-Dienst implementiert diese Schnittstelle und macht sie auf einem Endpunkt mit dem WebHttpBehavior at http://localhost:8000/MyCalcServiceverfügbar. Der Add Dienstvorgang kann aufgerufen werden, indem ein HTTP GET an http://localhost:8000/MyCalcService/Add?n1=10&n2=5. Der QueryStringConverter erhält diese URL und konvertiert die beiden darin angegebenen Parameter (n1 und n2) in zwei long-Objekte mit den entsprechenden Werten.

Sie können eine Klasse von QueryStringConverter ableiten, um zu steuern, wie Abfragezeichenfolgenparameter den Parametern eines Dienstvorgangs zugeordnet werden.

Der QueryStringConverter unterstützt standardmäßig die folgenden Typen:

• Byte

• SByte

• Int16

• Int32

• Int64

• UInt16

• UInt32

• UInt64

• Single

• Double

• Char

• Decimal

• Boolean

• String

• DateTime

• TimeSpan

• Guid

• Byte-Array

• Uri

• Object

• DateTimeOffset

• Enumerationen

• Typen, die über ein TypeConverterAttribute verfügen, mit dem der Typ in eine Zeichenfolgendarstellung bzw. aus einer Zeichenfolgendarstellung konvertiert werden kann.

Konstruktoren

QueryStringConverter()

Initialisiert eine neue Instanz der QueryStringConverter-Klasse.

Methoden

CanConvert(Type)	Ermittelt, ob der angegebene Typ in eine bzw. aus einer Zeichenfolgendarstellung konvertiert werden kann.
ConvertStringToValue(String, Type)	Konvertiert einen Abfragezeichenfolgenparameter in den angegebenen Typ.
ConvertValueToString(Object, Type)	Konvertiert einen Parameter in eine Abfragezeichenfolgendarstellung.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)