FtpWebRequest.Credentials Eigenschaft

  • Referenz

Definition

Namespace:
System.Net
Assembly:
System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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, set
Public Overrides Property Credentials As ICredentials

Eigenschaftswert

ICredentials

Eine ICredentials-Instanz. Andernfalls null, wenn die Eigenschaft nicht festgelegt wurde.

Ausnahmen

ArgumentNullException

Der für einen SET-Vorgang festgelegte Wert ist null.

ArgumentException

Für einen set-Vorgang wurde ein ICredentials von einem anderen Typ als NetworkCredential angegeben.

InvalidOperationException

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 einer Anmeldeinformationen vom Typ 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 festgelegt true.

Das Ändern Credentials nach dem Aufrufen des GetRequestStream, BeginGetRequestStream, GetResponseoder BeginGetResponse der Methode verursacht eine InvalidOperationException Ausnahme.

Gilt für

Siehe auch