AuthenticationManager.CredentialPolicy Właściwość

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.Requests.dll

Źródło:

AuthenticationManager.cs

Pobiera lub ustawia zasady poświadczeń, które mają być używane dla żądań zasobów wysyłanych przy użyciu HttpWebRequest klasy .

public:
 static property System::Net::ICredentialPolicy ^ CredentialPolicy { System::Net::ICredentialPolicy ^ get(); void set(System::Net::ICredentialPolicy ^ value); };

public static System.Net.ICredentialPolicy? CredentialPolicy { get; set; }

static member CredentialPolicy : System.Net.ICredentialPolicy with get, set

Public Shared Property CredentialPolicy As ICredentialPolicy

Wartość właściwości

ICredentialPolicy

Obiekt, który implementuje ICredentialPolicy interfejs, który określa, czy poświadczenia są wysyłane z żądaniami. Wartość domyślna to null.

Przykłady

W poniższym przykładzie kodu pokazano ustawienie zasad poświadczeń.

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

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

Uwagi

Zasady poświadczeń określają, czy wysyłać poświadczenia podczas wysyłania żądania dla zasobu sieciowego, takiego jak zawartość strony sieci Web. Jeśli poświadczenia są wysyłane, serwery wymagające uwierzytelniania klienta mogą podjąć próbę uwierzytelnienia klienta po odebraniu żądania zamiast wysyłania odpowiedzi wskazującej, że poświadczenia klienta są wymagane. Chociaż pozwala to zaoszczędzić rundy na serwerze, należy zrównoważyć ryzyko bezpieczeństwa związane z wysyłaniem poświadczeń w sieci. Jeśli serwer docelowy nie wymaga uwierzytelniania klienta, najlepiej nie wysyłać poświadczeń.

Zasady poświadczeń będą wywoływane tylko dla żądań, które określają poświadczenia lub używają obiektu określającego WebProxy poświadczenia.