FtpWebRequest.ConnectionGroupName Properti

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.Requests.dll

Sumber:

FtpWebRequest.cs

Mendapatkan atau mengatur nama grup koneksi yang berisi titik layanan yang digunakan untuk mengirim permintaan saat ini.

public:
 virtual property System::String ^ ConnectionGroupName { System::String ^ get(); void set(System::String ^ value); };

public override string? ConnectionGroupName { get; set; }

member this.ConnectionGroupName : string with get, set

Public Overrides Property ConnectionGroupName As String

Nilai Properti

String

String Nilai yang berisi nama grup koneksi.

Pengecualian

InvalidOperationException

Nilai baru ditentukan untuk properti ini untuk permintaan yang sudah berlangsung.

Contoh

Contoh kode berikut mengambil nilai properti ini.

IWebProxy^ proxy = request->Proxy;
if ( proxy )
{
   Console::WriteLine( "Proxy: {0}", proxy->GetProxy( request->RequestUri ) );
}
else
{
   Console::WriteLine( "Proxy: (none)" );
}

Console::WriteLine( "ConnectionGroup: {0}", request->ConnectionGroupName == nullptr ? "none" : request->ConnectionGroupName );

IWebProxy proxy = request.Proxy;
if (proxy != null)
{
    Console.WriteLine("Proxy: {0}", proxy.GetProxy(request.RequestUri));
}
else
{
    Console.WriteLine("Proxy: (none)");
}

Console.WriteLine("ConnectionGroup: {0}",
    request.ConnectionGroupName == null ? "none" : request.ConnectionGroupName
);

Keterangan

Grup koneksi mengaitkan sekumpulan permintaan dengan koneksi atau sekumpulan koneksi tertentu. Koneksi dalam grup koneksi hanya dapat digunakan kembali dengan permintaan yang berasal dari domain aplikasi yang sama, ketika kredensial pada permintaan sama dan permintaan menentukan nama grup koneksi. Ketika permintaan tidak menentukan nama grup koneksi, koneksi apa pun yang ada ke server yang diminta yang tidak terkait dengan grup koneksi dapat digunakan. Ketika kredensial tidak sama, koneksi yang ada ditutup dan permintaan baru harus diautentikasi ulang.

Menggunakan grup koneksi dapat meningkatkan performa karena ini memungkinkan semua permintaan bagi pengguna untuk menggunakan kembali koneksi yang diautentikasi dengan kredensial pengguna.

Mengubah ConnectionGroupName properti setelah memanggil GetRequestStreammetode , , BeginGetRequestStreamGetResponse, atau BeginGetResponse menyebabkan InvalidOperationException pengecualian.

Lihat juga

• FtpWebResponse
• FtpStatusCode
• WebRequestMethods.Ftp
• WebRequest
• WebResponse
• WebClient
• Mengelola Koneksi