FtpWebRequest.ConnectionGroupName プロパティ

.NET Framework クラス ライブラリ リファレンス

FtpWebRequest.ConnectionGroupName プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在の要求を送信するために使用するサービス ポイントが含まれる接続グループの名前を取得または設定します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Overrides Property
 ConnectionGroupName As String

Visual Basic (使用法)

Dim instance As FtpWebRequest
Dim value As String

value = instance.ConnectionGroupName

instance.ConnectionGroupName = value

C#

public override string ConnectionGroupName
 { get; set; }

C++

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

J#

/** @property */
public String get_ConnectionGroupName ()

/** @property */
public void set_ConnectionGroupName (String
 value)

JScript

public override function get
 ConnectionGroupName () : String

public override function set
 ConnectionGroupName (value : String)

プロパティ値
接続グループ名を格納している String 値。

例外

例外の種類	条件
InvalidOperationException	既に処理中の要求で、このプロパティに対して新しい値が指定されました。

解説

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

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

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

使用例

このプロパティの値を取得するコード例を次に示します。

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
FtpWebRequest クラス
FtpWebRequest メンバ
System.Net 名前空間
FtpWebResponse
FtpStatusCode 列挙体
WebRequestMethods.Ftp
WebRequest
WebResponse
WebClient
その他の技術情報
接続の管理