FtpWebRequest.Credentials Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta le credenziali usate per comunicare con il server 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
Valore della proprietà
Istanza di ICredentials; in caso contrario, null
se la proprietà non è stata impostata.
Eccezioni
Il valore specificato per un'operazione set è null
.
Istanza di ICredentials di un tipo diverso dalla classe NetworkCredential specificata per un'operazione d'impostazione.
È stato specificato un nuovo valore per questa proprietà per una richiesta già in corso.
Esempio
Nell'esempio di codice seguente viene recuperato il valore di questa proprietà e viene utilizzato per visualizzare il nome utente.
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
);
Commenti
Non è necessario specificare le credenziali quando ci si connette usando l'accesso anonimo. È necessario impostare la Credentials proprietà usando una credenziale di tipo NetworkCredential. In questo modo si garantisce che il nome utente e la password possano essere letti e inviati al server.
Attenzione
Le informazioni sulle credenziali non vengono crittografate quando vengono trasmesse al server a meno che la EnableSsl proprietà non sia impostata su true
.
La modifica Credentials dopo la chiamata al GetRequestStreammetodo , BeginGetRequestStreamGetResponse, o BeginGetResponse causa un'eccezioneInvalidOperationException.