UriBuilder.Query Properti

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

UriBuilder.cs

Mendapatkan atau mengatur informasi kueri apa pun yang disertakan dalam URI, termasuk karakter '?' utama jika tidak kosong.

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

Nilai Properti

String

Informasi kueri yang disertakan dalam URI.

Contoh

Contoh berikut mengatur Query properti .

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

Keterangan

Properti Query berisi informasi kueri apa pun yang disertakan dalam URI. Informasi kueri dipisahkan dari informasi jalur dengan tanda tanya (?) dan berlanjut ke akhir URI. Informasi kueri yang dikembalikan menyertakan tanda tanya utama. Saat mengatur Query properti:

• Dalam .NET Framework, tanda tanya selalu ditambahkan ke string, bahkan jika string sudah dimulai dengan tanda tanya.
• Dalam .NET 5 (dan .NET Core) dan versi yang lebih baru, tanda tanya telah ditambahkan ke string jika belum ada.

Informasi kueri lolos sesuai dengan RFC 2396.

Catatan

Untuk menambahkan nilai ke informasi kueri yang sudah ada di .NET Framework, Anda harus menghapus tanda tanya di awal sebelum mengatur properti dengan nilai baru. Ini karena .NET Framework selalu menambahkan tanda tanya saat mengatur properti . .NET 5 (dan .NET Core) dan versi yang lebih baru toleran terhadap tanda tanya terkemuka, dan hanya akan menambahkannya sebelumnya jika perlu.

Lihat juga

• Uri
• Query