UriBuilder.Query Propriété

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

UriBuilder.cs

Obtient ou définit des informations de requête incluses dans l’URI, y compris le caractère « ? » de début, s’il n’est pas vide.

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

Valeur de propriété

String

Informations de requête incluses dans l’URI.

Exemples

L’exemple suivant définit la Query propriété.

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

Remarques

La Query propriété contient toutes les informations de requête incluses dans l’URI. Les informations de requête sont séparées des informations de chemin d’accès par un point d’interrogation ( ?) et continuent à la fin de l’URI. Les informations de requête retournées incluent le point d’interrogation principal. Lors de la définition de la Query propriété :

• Dans .NET Framework, un point d’interrogation est toujours ajouté à la chaîne, même si la chaîne commence déjà par un point d’interrogation.
• Dans .NET 5 (et .NET Core) et versions ultérieures, un point d'interrogation est ajouté à la chaîne s'il n'est pas déjà présent.

Les informations de requête sont échappées selon RFC 2396.

Note

Pour ajouter une valeur aux informations de requête existantes dans .NET Framework, vous devez supprimer le point d’interrogation principal avant de définir la propriété avec la nouvelle valeur. Cela est dû au fait que .NET Framework précède toujours le point d’interrogation lors de la définition de la propriété. .NET 5 (et .NET Core) et les versions ultérieures sont tolérants à un point d’interrogation de début, et n’en font qu’un si nécessaire.

Voir aussi

• Uri
• Query