FtpWebRequest.Credentials 屬性

定義

取得或設定用來與 FTP 伺服器通訊的認證。

C#
public override System.Net.ICredentials? Credentials { get; set; }
C#
public override System.Net.ICredentials Credentials { get; set; }

屬性值

ICredentials 執行個體;如果屬性尚未設定,則為 null

例外狀況

為設定作業指定的值為 null

為設定作業,指定 ICredentials 型別以外的 NetworkCredential

由於已經在進行的要求,已為這個屬性指定新的值。

範例

下列程式代碼範例會擷取這個屬性的值,並使用它來顯示用戶名稱。

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

備註

使用匿名登錄進行連線時,您不需要指定認證。 您必須使用 類型的NetworkCredential認證來設定 Credentials 屬性;這可確保使用者名稱和密碼可以讀取並傳送至伺服器。

注意

除非 屬性設定true為 ,EnableSsl否則傳送至伺服器時,認證資訊不會加密。

呼叫、 或方法之後變更Credentials會導致例外狀況。BeginGetRequestStreamBeginGetResponseGetResponseGetRequestStreamInvalidOperationException

適用於

產品 版本
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

另請參閱