UriBuilder.Query Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define qualquer informação de consulta incluída no URI, incluindo o caractere '?' à esquerda, 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, setPublic Property Query As StringValor da propriedade
As informações de consulta incluídas na URI.
Exemplos
O exemplo a seguir define a Query propriedade .
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
Comentários
A Query propriedade contém todas as informações de consulta incluídas no URI. As informações de consulta são separadas das informações do caminho por um ponto de interrogação (?) e continuam até o final do URI. As informações de consulta retornadas incluem o ponto de interrogação à esquerda. Ao definir a Query propriedade :
- Em .NET Framework, um ponto de interrogação é sempre anexado à cadeia de caracteres, mesmo que a cadeia de caracteres já comece com um ponto de interrogação.
- No .NET 5 (e no .NET Core) e em versões posteriores, um ponto de interrogação será anexado à cadeia de caracteres se ainda não estiver presente.
As informações de consulta são escapadas de acordo com a RFC 2396.
Observação
Para acrescentar um valor às informações de consulta existentes no .NET Framework, você deve remover o ponto de interrogação à esquerda antes de definir a propriedade com o novo valor. Isso ocorre porque .NET Framework sempre precede o ponto de interrogação ao definir a propriedade . O .NET 5 (e o .NET Core) e versões posteriores são tolerantes a um ponto de interrogação principal e só anexarão um, se necessário.
