UriBuilder.Query Свойство

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Исходный код:

UriBuilder.cs

Возвращает или задает любые сведения о запросе, включенные в URI, включая символ "?", если не пустой.

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

Значение свойства

String

Сведения запроса, включенные в URI.

Примеры

В следующем примере задается Query свойство .

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

Комментарии

Свойство Query содержит все сведения о запросе, включенные в URI. Сведения о запросе отделяются от сведений о пути вопросительным знаком (?) и продолжаются до конца URI. Возвращаемые сведения запроса включают в себя ведущий вопросительный знак. При установке свойства:Query

• В платформа .NET Framework вопросительный знак всегда добавляется к строке, даже если строка уже начинается с вопросительного знака.
• В .NET 5 (и .NET Core) и более поздних версиях вопросительный знак добавляется к строке, если она еще отсутствует.

Данные запроса экранируются в соответствии с RFC 2396.

Примечание

Чтобы добавить значение к существующим сведениям о запросе в платформа .NET Framework, необходимо удалить вопросительный знак, прежде чем присвоить свойству новое значение. Это связано с тем, что платформа .NET Framework всегда добавляет вопросительный знак при задании свойства. .NET 5 (и .NET Core) и более поздних версий относятся к началу вопросительного знака и при необходимости будут добавляться только к одному.

См. также раздел

• Uri
• Query