IntranetZoneCredentialPolicy Klasse

Definition

Definiert eine Anmeldeinformationsrichtlinie für Ressourcenanforderungen, die mithilfe von WebRequest und den daraus abgeleiteten Klassen erstellt werden.Defines a credential policy to be used for resource requests that are made using WebRequest and its derived classes.

public ref class IntranetZoneCredentialPolicy : System::Net::ICredentialPolicy
public class IntranetZoneCredentialPolicy : System.Net.ICredentialPolicy
type IntranetZoneCredentialPolicy = class
    interface ICredentialPolicy
Public Class IntranetZoneCredentialPolicy
Implements ICredentialPolicy
Vererbung
IntranetZoneCredentialPolicy
Implementiert

Beispiele

Im folgenden Codebeispiel wird das Erstellen einer Instanz IntranetZoneCredentialPolicy von und deren Verwendung zum Festlegen der Richtlinie für die Anmelde Informationen für die Anwendungsdomäne veranschaulicht.The following code example demonstrates creating an instance of IntranetZoneCredentialPolicy and using it to set the credential policy for the application domain.

static void UseIntranetCredentialPolicy()
{
   IntranetZoneCredentialPolicy^ policy = gcnew IntranetZoneCredentialPolicy;
   AuthenticationManager::CredentialPolicy = policy;
}
 public static void UseIntranetCredentialPolicy()
{
    IntranetZoneCredentialPolicy  policy = new IntranetZoneCredentialPolicy();
    AuthenticationManager.CredentialPolicy = policy;
}

Hinweise

Mit dieser Richtlinie können Anmelde Informationen nur gesendet werden, wenn sich die angeforderte Ressource in derselben Domäne befindet wie der Client, der die Anforderung sendet.This policy allows credentials to be sent only if the requested resource is in the same domain as the client that is making the request. Bei vielen Anwendungen ist dies die optimale Richtlinie, da Sie verhindert, dass Netzwerk Anmelde Informationen mit Anforderungen für Ressourcen gesendet werden, die sich nicht im Intranet befinden.For many applications this is the optimal policy because it prevents network credentials from being sent with requests for resources that are not on the intranet.

Hinweis

ICredentialPolicyRichtlinien werden nur aufgerufen, WebRequest wenn der WebProxy oder der, der der Anforderung zugeordnet ist, über Anmelde nullInformationen verfügt, die nicht sind.ICredentialPolicy policies are invoked only if the WebRequest or the WebProxy that is associated with the request has credentials that are not null. Das Festlegen dieser Richtlinie wirkt sich nicht auf Anforderungen aus, die keine Anmelde Informationen angeben.Setting this policy has no effect on requests that do not specify credentials.

Verwenden Sie AuthenticationManager.CredentialPolicy die-Eigenschaft zum IntranetZoneCredentialPolicy Festlegen der Richtlinie.Use the AuthenticationManager.CredentialPolicy property to set the IntranetZoneCredentialPolicy policy. Der IAuthenticationModule , der die Authentifizierung für die Anforderung verarbeitet, ShouldSendCredential Ruft die-Methode auf, bevor die Authentifizierung durchgeführt wird.The IAuthenticationModule that handles authentication for the request will invoke the ShouldSendCredential method before performing the authentication. Wenn sich die angeforderte Ressource in einer anderen Domäne als der Client befindet ShouldSendCredential , gibt falsedie Methode zurück, und die Authentifizierung wird nicht durchgeführt.If the requested resource is in a different domain than the client, the ShouldSendCredential method returns false, and authentication is not performed.

Diese Richtlinie betrifft alle Instanzen WebRequest von mit Anmelde Informationen, die nicht NULL sind, in der aktuellen Anwendungsdomäne.This policy affects all instances of WebRequest with non-null credentials in the current application domain. Die Richtlinie kann nicht für einzelne Anforderungen überschrieben werden.The policy cannot be overridden on individual requests.

Konstruktoren

IntranetZoneCredentialPolicy()

Initialisiert eine neue Instanz der IntranetZoneCredentialPolicy-Klasse.Initializes a new instance of the IntranetZoneCredentialPolicy class.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ShouldSendCredential(Uri, WebRequest, NetworkCredential, IAuthenticationModule)

Gibt einen Boolean zurück, der angibt, ob die Anmeldeinformationen des Clients mit einer Ressourcenanforderung gesendet werden, die anhand eines WebRequest erstellt wurde.Returns a Boolean that indicates whether the client's credentials are sent with a request for a resource that was made using WebRequest.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für: