UriBuilder.Query Vlastnost

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.Extensions.dll

Sestavení:: System.Runtime.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Zdroj:: UriBuilder.cs

Zdroj:: UriBuilder.cs

Zdroj:: UriBuilder.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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.

Platí pro

Viz také

Uri
Query