UriBuilder.Query Propiedad

Definición

Espacio de nombres:
System
Ensamblados:
System.dll, System.Runtime.Extensions.dll
Ensamblados:
netstandard.dll, System.Runtime.dll
Ensamblado:
System.Runtime.Extensions.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll
Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
Source:
UriBuilder.cs
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

La información de consulta incluida en el URI.

Ejemplos

En el ejemplo siguiente se establece la Query propiedad .

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 está separada de la información de ruta de acceso por 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.

Note

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.

Se aplica a

Consulte también