UriBuilder.Query Свойство

Определение

Возвращает или задает всевозможные сведения запроса, включенные в 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;

Комментарии

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

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

Сведения о запросе преобразуются в соответствии с RFC 2396.

Примечание

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

Применяется к

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