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

설명

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

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

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

적용 대상

추가 정보

• FtpWebResponse
• FtpStatusCode
• WebRequestMethods.Ftp
• WebRequest
• WebResponse
• WebClient
• 연결 관리