FtpWebRequest.Credentials Свойство

Определение

Пространство имен:

System.Net

Сборка:

System.Net.Requests.dll

Исходный код:

FtpWebRequest.cs

Возвращает или задает учетные данные, используемые для связи с FTP-сервером.

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

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

member this.Credentials : System.Net.ICredentials with get, set

Public Overrides Property Credentials As ICredentials

Значение свойства

ICredentials

Экземпляр ICredentials; в противном случае — null, если свойство не было задано.

Исключения

ArgumentNullException

Для операции задания указано значение null.

ArgumentException

Для операции присвоения был указан тип ICredentials, отличный от NetworkCredential.

InvalidOperationException

Для этого свойства задано новое значение для уже выполняющегося запроса.

Примеры

В следующем примере кода извлекается значение этого свойства и оно используется для отображения имени пользователя.

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

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

Комментарии

При подключении с помощью анонимного входа указывать учетные данные не требуется. Свойство необходимо задать Credentials с помощью учетных данных типа NetworkCredential. Это гарантирует, что имя пользователя и пароль можно прочитать и отправить на сервер.

Внимание!

Данные учетных данных не шифруются при передаче на сервер, если EnableSsl свойство не имеет значение true.

Изменение Credentials после вызова GetRequestStreamметода , BeginGetRequestStream, GetResponseили BeginGetResponse вызывает InvalidOperationException исключение.

См. также раздел

• FtpWebResponse
• FtpStatusCode
• WebRequestMethods.Ftp
• WebRequest
• WebResponse
• WebClient