次の方法で共有


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

注釈

接続グループは、一連の要求を特定の接続または接続のセットに関連付けます。 接続グループ内の接続は、要求の資格情報が同じで、要求で接続グループ名が指定されている場合に、同じアプリケーション ドメインから送信された要求によってのみ再利用できます。 要求で接続グループ名が指定されていない場合は、接続グループに関連付けられていない要求されたサーバーへの既存の接続を使用できます。 資格情報が同じでない場合は、既存の接続が閉じられ、新しい要求を再認証する必要があります。

接続グループを使用すると、ユーザーの資格情報で認証された接続をユーザーに対するすべての要求で再利用できるため、パフォーマンスが向上する可能性があります。

BeginGetRequestStreamGetResponse、または BeginGetResponse メソッドをConnectionGroupName呼び出した後に GetRequestStreamプロパティを変更すると、InvalidOperationException例外が発生します。

適用対象

こちらもご覧ください