UriBuilder.Query Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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, setPublic Property Query As StringValor de propiedad
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.
