FtpWebRequest.Credentials Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает учетные данные, используемые для связи с 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; }
public override System.Net.ICredentials Credentials { get; set; }
member this.Credentials : System.Net.ICredentials with get, set
Public Overrides Property Credentials As ICredentials
Значение свойства
Экземпляр ICredentials; в противном случае — null
, если свойство не было задано.
Исключения
Для операции задания указано значение null
.
Для операции присвоения был указан тип ICredentials, отличный от NetworkCredential.
Для этого свойства задано новое значение для уже выполняющегося запроса.
Примеры
В следующем примере кода извлекается значение этого свойства и оно используется для отображения имени пользователя.
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 исключение.