FtpWebRequest.Credentials Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die für die Kommunikation mit dem FTP-Server verwendeten Anmeldeinformationen ab oder legt diese fest.
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, setPublic Overrides Property Credentials As ICredentialsEigenschaftswert
Eine ICredentials-Instanz. Andernfalls null, wenn die Eigenschaft nicht festgelegt wurde.
Ausnahmen
Der für einen SET-Vorgang festgelegte Wert ist null.
Für einen set-Vorgang wurde ein ICredentials von einem anderen Typ als NetworkCredential angegeben.
Für diese Eigenschaft wurde ein neuer Wert für eine Anforderung angegeben, die bereits ausgeführt wird.
Beispiele
Im folgenden Codebeispiel wird der Wert dieser Eigenschaft abgerufen und zum Anzeigen des Benutzernamens verwendet.
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
);
Hinweise
Sie müssen keine Anmeldeinformationen angeben, wenn Sie eine Verbindung mit anonymer Anmeldung herstellen. Sie müssen die Credentials Eigenschaft mithilfe eines Anmeldeinformationstyps NetworkCredentialfestlegen. Dadurch wird sichergestellt, dass der Benutzername und das Kennwort gelesen und an den Server gesendet werden können.
Achtung
Anmeldeinformationen werden beim Übertragen an den Server nicht verschlüsselt, es sei denn, die EnableSsl Eigenschaft ist auf truefestgelegt.
Das Ändern Credentials nach dem Aufrufen der GetRequestStreamMethode , BeginGetRequestStream, GetResponseoder BeginGetResponse führt zu einer InvalidOperationException Ausnahme.
