UriBuilder.Query Proprietà

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Origine:

UriBuilder.cs

Ottiene o imposta le informazioni di query incluse nell'URI, incluso il carattere iniziale '?' se non è vuoto.

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

Valore della proprietà

String

Informazioni sulle query incluse nell'URI.

Esempio

Nell'esempio seguente viene impostata la Query proprietà .

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

Commenti

La Query proprietà contiene informazioni sulla query incluse nell'URI. Le informazioni sulle query sono separate dalle informazioni sul percorso da un punto interrogativo (?) e continuano fino alla fine dell'URI. Le informazioni sulla query restituite includono il punto interrogativo iniziale. Quando si imposta la Query proprietà :

• In .NET Framework un punto interrogativo viene sempre anteporto alla stringa, anche se la stringa inizia già con un punto interrogativo.
• In .NET 5 (e .NET Core) e versioni successive, un punto interrogativo viene anteporto alla stringa se non è già presente.

Le informazioni sulla query vengono precedute da un escape in base a RFC 2396.

Nota

Per aggiungere un valore alle informazioni di query esistenti in .NET Framework, è necessario rimuovere il punto interrogativo iniziale prima di impostare la proprietà con il nuovo valore. Questo perché .NET Framework antepone sempre il punto interrogativo quando si imposta la proprietà . .NET 5 (e .NET Core) e versioni successive sono tolleranti a un punto interrogativo iniziale e ne antepone solo uno, se necessario.

Vedi anche

• Uri
• Query