UriBuilder.Query-Eigenschaft

Ruft zum URI gehörende Abfrageinformationen ab oder legt diese fest.

Namespace: System
Assembly: System (in system.dll)

Syntax

'Declaration
Public Property Query As String
'Usage
Dim instance As UriBuilder
Dim value As String

value = instance.Query

instance.Query = value

public string Query { get; set; }

public:
property String^ Query {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_Query ()

/** @property */
public void set_Query (String value)

public function get Query () : String

public function set Query (value : String)

Eigenschaftenwert

Die zum URI gehörenden Abfrageinformationen.

Hinweise

Die Query-Eigenschaft enthält die im URI enthaltenen Abfrageinformationen. Abfrageinformationen werden mit einem Fragezeichen (?) von den Pfadinformationen getrennt und reichen bis zum Ende des URIs. Die zurückgegebenen Abfrageinformationen enthalten das führende Fragezeichen.

Die Abfrageinformationen werden gemäß RFC 2396 mit Escapesequenzen versehen.

Hinweis   In den Versionen 1.0 und 1.1 von .NET Framework wurde die Query-Eigenschaft gelöscht, wenn die Fragment-Eigenschaft auf einen beliebigen Wert einschließlich NULL (Nothing in Visual Basic) festgelegt wurde, und wenn die Fragment-Eigenschaft auf NULL (Nothing in Visual Basic) oder String.Empty festgelegt wurde, wurde die Eigenschaft ebenfalls gelöscht. In der Version 2.0 dagegen sind die Fragment-Eigenschaft und die Query-Eigenschaft unabhängig.

Hinweis   Fügen Sie keine Zeichenfolge direkt an diese Eigenschaft an. Wenn die Länge von Query größer als 1 ist, rufen Sie den Eigenschaftenwert als eine Zeichenfolge ab, entfernen das vorangestellte Fragezeichen, fügen eine neue Abfragezeichenfolge an und legen die Eigenschaft auf die zusammengesetzte Zeichenfolge fest.

Beispiel

Im folgenden Beispiel wird die Query-Eigenschaft festgelegt.

UriBuilder baseUri = new UriBuilder("https://www.contoso.com/default.aspx?Param1=7890");
string queryToAppend = "param2=1234";

if (baseUri.Query != null && baseUri.Query.Length > 1)
    baseUri.Query = baseUri.Query.Substring(1) + "&" + queryToAppend; 
else
    baseUri.Query = queryToAppend; 

UriBuilder^ baseUri = gcnew UriBuilder 
    ("https://www.contoso.com/default.aspx?Param1=7890");
String^ queryToAppend = "param2=1234";
if (baseUri->Query != nullptr && baseUri->Query->Length > 1)
{
    baseUri->Query = baseUri->Query->Substring(1)+ "&" + queryToAppend;
}

else
{
    baseUri->Query = queryToAppend;
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

UriBuilder-Klasse
UriBuilder-Member
System-Namespace