FtpWebRequest.Credentials Propriedade
Definição
Obtém ou define as credenciais usadas para se comunicar com o servidor FTP.Gets or sets the credentials used to communicate with the FTP server.
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
Valor da propriedade
Uma instância ICredentials; caso contrário, null se a propriedade não tiver sido definida.An ICredentials instance; otherwise, null if the property has not been set.
Exceções
O valor especificado para uma operação de definição é null.The value specified for a set operation is null.
Um ICredentials de um tipo diferente de NetworkCredential foi especificado para uma operação definida.An ICredentials of a type other than NetworkCredential was specified for a set operation.
Um novo valor foi especificado para essa propriedade referente a uma solicitação já em andamento.A new value was specified for this property for a request that is already in progress.
Exemplos
O exemplo de código a seguir recupera o valor dessa propriedade e a usa para exibir o nome de usuário.The following code example retrieves the value of this property and uses it to display the user name.
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
Não é necessário especificar credenciais ao se conectar usando logon anônimo.You are not required to specify credentials when connecting using anonymous logon. 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 ao servidor.You must set the Credentials property by using a credential of type NetworkCredential; this ensures that the user name and password can be read and sent to the server.
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 .Credentials information is not encrypted when transmitted to the server unless the EnableSsl property is set to true.
Alterar Credentials depois de chamar GetRequestStream o BeginGetRequestStream método,, GetResponse ou BeginGetResponse causa uma InvalidOperationException exceção.Changing Credentials after calling the GetRequestStream, BeginGetRequestStream, GetResponse, or BeginGetResponse method causes an InvalidOperationException exception.