UriBuilder.Query Propriété

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

UriBuilder.cs

Obtient ou définit toutes les 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'identificateur URI.

Exemples

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

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

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 jusqu’à 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 les versions ultérieures, un point d’interrogation est ajouté à la chaîne si elle n’est pas déjà présente.

Les informations de requête sont placées dans une séquence d’échappement selon RFC 2396.

Notes

Pour ajouter une valeur aux informations de requête existantes dans .NET Framework, vous devez supprimer le point d’interrogation de début avant de définir la propriété avec la nouvelle valeur. En effet, .NET Framework ajoute 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 ajouteront qu’un seul si nécessaire.

Voir aussi

• Uri
• Query