FtpWebRequest.Credentials プロパティ

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

FtpWebRequest.Credentials プロパティ

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

FTP サーバーとの通信に使用する資格情報を取得または設定します。

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

Visual Basic (宣言)

Public Overrides Property
 Credentials As ICredentials

Visual Basic (使用法)

Dim instance As FtpWebRequest
Dim value As ICredentials

value = instance.Credentials

instance.Credentials = value

C#

public override ICredentials Credentials { get;
 set; }

C++

public:
virtual property ICredentials^ Credentials {
    ICredentials^ get () override;
    void set (ICredentials^ value) override;
}

J#

/** @property */
public ICredentials get_Credentials ()

/** @property */
public void set_Credentials (ICredentials value)

JScript

public override function get
 Credentials () : ICredentials

public override function set
 Credentials (value : ICredentials)

プロパティ値
ICredentials インスタンス。プロパティが設定されていない場合は null 参照 (Visual Basic では Nothing)。

例外

例外の種類	条件
ArgumentNullException	設定操作に指定された値が null 参照 (Visual Basic では Nothing) です。
ArgumentException	NetworkCredential 以外の種類の ICredentials が、設定操作に指定されました。
InvalidOperationException	既に処理中の要求で、このプロパティに対して新しい値が指定されました。

解説

匿名ログオンを使用して接続する場合は、資格情報の指定は必要ありません。NetworkCredential の種類の資格情報を使用して Credentials プロパティを設定する必要があります。これによって、ユーザー名とパスワードが読み取られ、サーバーに確実に送信されます。

注意
資格情報は、EnableSsl プロパティが true に設定されない限り、サーバーへの送信時に暗号化されません。

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

使用例

このプロパティの値を取得し、それを使用してユーザー名を表示するコード例を次に示します。

C#

Console.WriteLine("User {0} {1}", 
    request.Credentials.GetCredential(request.RequestUri,"basic").UserName
,
    request.RequestUri
);

プラットフォーム

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