Freigeben über


UriBuilder.Query Eigenschaft

Definition

Ruft alle im URI enthaltenen Abfrageinformationen ab, einschließlich des führenden "?"-Zeichens, falls nicht leer.

public:
 property System::String ^ Query { System::String ^ get(); void set(System::String ^ value); };
public string Query { get; set; }
member this.Query : string with get, set
Public Property Query As String

Eigenschaftswert

Die zum URI gehörenden Abfrageinformationen.

Beispiele

Im folgenden Beispiel wird die Query -Eigenschaft festgelegt.

UriBuilder^ baseUri = gcnew UriBuilder 
    ("http://www.contoso.com/default.aspx?Param1=7890");
String^ queryToAppend = "param2=1234";
if (baseUri->Query != nullptr && baseUri->Query->Length > 1)
{
    // Note: In .NET Core and .NET 5+, you can simplify by removing
    // the call to Substring(), which removes the leading "?" character.
    baseUri->Query = baseUri->Query->Substring(1)+ "&" + queryToAppend;
}
else
{
    baseUri->Query = queryToAppend;
}
UriBuilder baseUri = new UriBuilder("http://www.contoso.com/default.aspx?Param1=7890");
string queryToAppend = "param2=1234";

if (baseUri.Query != null && baseUri.Query.Length > 1)
    // Note: In .NET Core and .NET 5+, you can simplify by removing
    // the call to Substring(), which removes the leading "?" character.
    baseUri.Query = baseUri.Query.Substring(1) + "&" + queryToAppend; 
else
    baseUri.Query = queryToAppend;
open System

let baseUri = UriBuilder "http://www.contoso.com/default.aspx?Param1=7890"
let queryToAppend = "param2=1234"

baseUri.Query <-
    if baseUri.Query <> null && baseUri.Query.Length > 1 then
        // Note: In .NET Core and .NET 5+, you can simplify by removing
        // the call to Substring(), which removes the leading "?" character.
        baseUri.Query.Substring 1 + "&" + queryToAppend 
    else
        queryToAppend

Hinweise

Die Query -Eigenschaft enthält alle Abfrageinformationen, die im URI enthalten sind. Abfrageinformationen werden durch ein Fragezeichen (?) von den Pfadinformationen getrennt und werden bis zum Ende des URI fortgesetzt. Die zurückgegebenen Abfrageinformationen enthalten das führende Fragezeichen. Beim Festlegen der Query Eigenschaft:

  • In .NET Framework wird der Zeichenfolge immer ein Fragezeichen vorangestellt, auch wenn die Zeichenfolge bereits mit einem Fragezeichen beginnt.
  • In .NET 5 (und .NET Core) und höheren Versionen wird der Zeichenfolge ein Fragezeichen vorangestellt, sofern es noch nicht vorhanden ist.

Die Abfrageinformationen werden gemäß RFC 2396 escaped.

Hinweis

Um einen Wert an vorhandene Abfrageinformationen in .NET Framework anzufügen, müssen Sie das führende Fragezeichen entfernen, bevor Sie die Eigenschaft mit dem neuen Wert festlegen. Dies liegt daran, dass .NET Framework beim Festlegen der Eigenschaft immer dem Fragezeichen vorangestellt wird. .NET 5 (und .NET Core) und höhere Versionen sind gegenüber einem führenden Fragezeichen tolerant und werden nur bei Bedarf vorangestellt.

Gilt für:

Weitere Informationen