FtpWebRequest.Credentials Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece las credenciales usadas para la comunicación con el 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; }
public override System.Net.ICredentials Credentials { get; set; }
member this.Credentials : System.Net.ICredentials with get, set
Public Overrides Property Credentials As ICredentials
Valor de propiedad
Instancia de ICredentials; en caso contrario null
, si no se estableció la propiedad.
Excepciones
El valor especificado para una operación Set es null
.
Se especificó un objeto ICredentials de un tipo distinto de NetworkCredential para una operación de conjunto.
Se ha especificado un nuevo valor en esta propiedad para una solicitud que ya está en curso.
Ejemplos
En el ejemplo de código siguiente se recupera el valor de esta propiedad y se usa para mostrar el nombre de usuario.
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
);
Comentarios
No es necesario especificar las credenciales al conectarse mediante el inicio de sesión anónimo. Debe establecer la Credentials propiedad mediante una credencial de tipo NetworkCredential; esto garantiza que el nombre de usuario y la contraseña se puedan leer y enviar al servidor.
Precaución
La información de credenciales no se cifra cuando se transmite al servidor a menos que la EnableSsl propiedad esté establecida true
en .
El cambio después de Credentials llamar al GetRequestStreammétodo , BeginGetRequestStream, GetResponseo BeginGetResponse provoca una InvalidOperationException excepción.