UriBuilder.Query Właściwość

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Źródło:

UriBuilder.cs

Pobiera lub ustawia wszystkie informacje o kwerendzie zawarte w identyfikatorze URI, w tym wiodący znak "?", jeśli nie jest pusty.

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

Wartość właściwości

String

Informacje o kwerendzie zawarte w identyfikatorze URI.

Przykłady

W poniższym przykładzie właściwość jest ustawiana 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;

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

Uwagi

Właściwość Query zawiera wszystkie informacje o kwerendzie zawarte w identyfikatorze URI. Informacje o kwerendzie są oddzielone od informacji o ścieżce znakiem zapytania (?) i nadal kończą się identyfikatorem URI. Zwrócone informacje o zapytaniu zawierają wiodący znak zapytania. Podczas ustawiania Query właściwości:

• W .NET Framework znak zapytania jest zawsze poprzedzany ciągiem, nawet jeśli ciąg zaczyna się już od znaku zapytania.
• W programach .NET 5 (i .NET Core) i nowszych wersjach znak zapytania jest poprzedzany ciągiem, jeśli jeszcze nie istnieje.

Informacje o kwerendzie są uciekane zgodnie z RFC 2396.

Uwaga

Aby dołączyć wartość do istniejących informacji o kwerendzie w .NET Framework, należy usunąć wiodący znak zapytania przed ustawieniem właściwości przy użyciu nowej wartości. Dzieje się tak, ponieważ .NET Framework zawsze poprzedza znak zapytania podczas ustawiania właściwości. Platforma .NET 5 (i .NET Core) i nowsze wersje są odporne na wiodący znak zapytania i będą w razie potrzeby poprzedzać tylko jeden.

Zobacz też

• Uri
• Query