FtpWebRequest.Credentials Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

FtpWebRequest.cs

Obtém ou define as credenciais usadas para se comunicar com o servidor 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

Valor da propriedade

ICredentials

Uma instância ICredentials; caso contrário, null se a propriedade não tiver sido definida.

Exceções

ArgumentNullException

O valor especificado para uma operação de definição é null.

ArgumentException

Um ICredentials de um tipo diferente de NetworkCredential foi especificado para uma operação definida.

InvalidOperationException

Um novo valor foi especificado para essa propriedade referente a uma solicitação já em andamento.

Exemplos

O exemplo de código a seguir recupera o valor dessa propriedade e o usa para exibir o nome de usuário.

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

Comentários

Você não precisa especificar credenciais ao se conectar usando logon anônimo. Você deve definir a Credentials propriedade usando uma credencial do tipo NetworkCredential; isso garante que o nome de usuário e a senha possam ser lidos e enviados para o servidor.

Cuidado

As informações de credenciais não são criptografadas quando transmitidas para o servidor, a menos que a EnableSsl propriedade esteja definida como true.

Alterar Credentials depois de chamar o GetRequestStreammétodo , BeginGetRequestStreamGetResponse, ou BeginGetResponse causa uma exceçãoInvalidOperationException.

Confira também

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