UriBuilder.Query Propiedad

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

UriBuilder.cs

Obtiene o establece cualquier información de consulta incluida en el URI, incluido el carácter "?" inicial si no está vacío.

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

Valor de propiedad

String

Información de consulta incluida en la dirección URI.

Ejemplos

En el ejemplo siguiente se establece la Query propiedad .

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

Comentarios

La Query propiedad contiene cualquier información de consulta incluida en el URI. La información de consulta se separa de la información de ruta de acceso mediante un signo de interrogación (?) y continúa hasta el final del URI. La información de consulta que se devuelve incluye el signo de interrogación inicial. Al establecer la Query propiedad :

• En .NET Framework, un signo de interrogación siempre se antepone a la cadena, incluso si la cadena ya comienza con un signo de interrogación.
• En .NET 5 (y .NET Core) y versiones posteriores, se antepone un signo de interrogación a la cadena si aún no está presente.

La información de consulta se escapa según RFC 2396.

Nota

Para anexar un valor a la información de consulta existente en .NET Framework, debe quitar el signo de interrogación inicial antes de establecer la propiedad con el nuevo valor. Esto se debe a que .NET Framework siempre antepone el signo de interrogación al establecer la propiedad . .NET 5 (y .NET Core) y versiones posteriores son tolerantes a un signo de interrogación inicial y solo anteponerán uno si es necesario.

Consulte también

• Uri
• Query