UriBuilder.Query Vlastnost

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Zdroj:

UriBuilder.cs

Získá nebo nastaví všechny informace dotazu zahrnuté v identifikátoru URI, včetně počátečního znaku "?", pokud není prázdný.

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

Hodnota vlastnosti

String

Informace o dotazu zahrnuté v identifikátoru URI.

Příklady

Následující příklad nastaví Query vlastnost.

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

Poznámky

Vlastnost Query obsahuje všechny informace o dotazu zahrnuté v identifikátoru URI. Informace o dotazu jsou od informací o cestě odděleny otazníkem (?) a pokračují až na konec identifikátoru URI. Informace o dotazu, které se vrátí, zahrnují počáteční otazník. Při nastavování Query vlastnosti:

• V rozhraní .NET Framework je otazník vždy před řetězcem, a to i v případě, že řetězec již začíná otazníkem.
• V .NET 5 (a .NET Core) a novějších verzích je otazník před řetězcem, pokud ještě neexistuje.

Informace o dotazu se uniknou podle RFC 2396.

Poznámka

Chcete-li přidat hodnotu k existující dotaz informace v rozhraní .NET Framework, je nutné odebrat úvodní otazník před nastavením vlastnosti s novou hodnotou. Je to proto, že rozhraní .NET Framework při nastavování vlastnosti vždy předestavuje otazník. .NET 5 (a .NET Core) a novější verze jsou odolné vůči hlavnímu otazníku a v případě potřeby ho předvedou.

Viz také

• Uri
• Query