다음을 통해 공유


FtpWebRequest.ConnectionGroupName 속성

정의

현재 요청을 보내는 데 사용되는 서비스 지점이 들어 있는 연결 그룹의 이름을 가져오거나 설정합니다.

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

속성 값

연결 그룹의 이름이 들어 있는 String 값입니다.

예외

이미 진행 중인 요청의 이 속성에 새 값이 지정된 경우

예제

다음 코드 예제에서는이 속성의 값을 검색 합니다.

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

설명

연결 그룹은 요청 집합을 특정 연결 또는 연결 집합과 연결합니다. 연결 그룹 이름을 지정 하는 요청 및 요청에 자격 증명이 동일한 경우 동일한 애플리케이션 도메인에서 시작 된 요청에 의해서만 연결 그룹의 연결을 재사용할 수 있습니다. 요청이 연결 그룹 이름을 지정하지 않으면 연결 그룹과 연결되지 않은 요청된 서버에 대한 기존 연결을 사용할 수 있습니다. 자격 증명이 동일하지 않으면 기존 연결이 닫혀 있고 새 요청을 다시 인증해야 합니다.

연결 그룹을 사용하면 모든 사용자가 사용자의 자격 증명으로 인증된 연결을 다시 사용할 수 있으므로 성능이 향상될 수 있습니다.

, , BeginGetRequestStream또는 메서드를 ConnectionGroupName 호출한 GetRequestStream후 속성을 변경하면 예외가 발생합니다InvalidOperationException.BeginGetResponseGetResponse

적용 대상

추가 정보