FtpWebRequest.ConnectionGroupName Özellik

Tanım

Geçerli isteği göndermek için kullanılan hizmet noktasını içeren bağlantı grubunun adını alır veya ayarlar.

public:
 virtual property System::String ^ ConnectionGroupName { System::String ^ get(); void set(System::String ^ value); };
public override string? ConnectionGroupName { get; set; }
public override string ConnectionGroupName { get; set; }
member this.ConnectionGroupName : string with get, set
Public Overrides Property ConnectionGroupName As String

Özellik Değeri

String Bağlantı grubu adı içeren bir değer.

Özel durumlar

Devam etmekte olan bir istek için bu özellik için yeni bir değer belirtildi.

Örnekler

Aşağıdaki kod örneği bu özelliğin değerini alır.

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
);

Açıklamalar

Bağlantı grupları, bir istek kümesini belirli bir bağlantı veya bağlantı kümesiyle ilişkilendirir. Bir bağlantı grubundaki bağlantılar, yalnızca istekteki kimlik bilgileri aynı olduğunda ve istek bağlantı grubu adını belirttiğinde, aynı uygulama etki alanındaki istekler tarafından yeniden kullanılabilir. İstek bir bağlantı grubu adı belirtmediğinde, istenen sunucuya bir bağlantı grubuyla ilişkili olmayan mevcut tüm bağlantılar kullanılabilir. Kimlik bilgileri aynı olmadığında, mevcut bağlantı kapatılır ve yeni isteğin yeniden kimlik doğrulaması yapılması gerekir.

Bir kullanıcının kimlik bilgileriyle kimliği doğrulanmış bağlantıyı yeniden kullanmasına izin verdiğinden, bağlantı gruplarının kullanılması performansı geliştirebilir.

ConnectionGroupName, , GetResponseBeginGetRequestStreamveya BeginGetResponse yöntemini çağırdıktan sonra özelliğin GetRequestStreamdeğiştirilmesi özel duruma InvalidOperationException neden olur.

Şunlara uygulanır

Ayrıca bkz.