UriBuilder.Query Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property Query As StringEigenschaftswert
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.
