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

ICredentials

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.

Aplica-se a

Confira também