UriBuilder.Query Propriedade

Definição

Espaço de Nomes:
System
Assemblagens:
System.dll, System.Runtime.Extensions.dll
Assemblagem:
System.dll
Assemblagem:
System.Runtime.Extensions.dll
Assemblagem:
netstandard.dll

Recebe ou define qualquer informação de consulta incluída no URI, incluindo o caractere '?' inicial, se não estiver vazio.

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

Valor de Propriedade

String

A informação da consulta incluída no URI.

Exemplos

O exemplo seguinte define a Query propriedade.

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

Observações

A Query propriedade contém qualquer informação de consulta incluída no URI. A informação da consulta é separada da informação do caminho por um ponto de interrogação (?) e continua até ao final do URI. A informação da consulta que é devolvida inclui o ponto de interrogação inicial. Ao definir a Query propriedade:

  • No .NET Framework, um ponto de interrogação é sempre colocado no início da sequência, mesmo que esta já comece com um ponto de interrogação.
  • No .NET 5 (e no .NET Core) e versões posteriores, um ponto de interrogação é colocado na cadeia se ainda não estiver presente.

A informação da consulta é escapada de acordo com o RFC 2396.

Note

Para adicionar um valor à informação de consulta existente no .NET Framework, deve remover o ponto de interrogação inicial antes de definir a propriedade com o novo valor. Isto porque o .NET Framework coloca sempre o ponto de interrogação ao definir a propriedade. .NET 5 (e .NET Core) e versões posteriores são tolerantes a um ponto de interrogação inicial, e só colocam um se necessário.

Aplica-se a

Ver também