HttpWebRequest.PreAuthenticate Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een autorisatieheader met de aanvraag moet worden verzonden.
public:
virtual property bool PreAuthenticate { bool get(); void set(bool value); };public override bool PreAuthenticate { get; set; }member this.PreAuthenticate : bool with get, setPublic Overrides Property PreAuthenticate As BooleanWaarde van eigenschap
true een HTTP-autorisatieheader met aanvragen te verzenden nadat verificatie heeft plaatsgevonden; anders, false. De standaardwaarde is false.
Opmerkingen
Caution
WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.
Nadat een clientaanvraag naar een specifieke Uri is geverifieerd, als PreAuthenticate dat het geval true is en referenties zijn opgegeven, wordt de autorisatieheader met elke aanvraag verzonden naar elke Uri aanvraag die overeenkomt met de specifieke Uri tot de laatste slash. Dus als de clientaanvraag is geverifieerd voor een specifieke Uri die het volgende bevat:
http://www.contoso.com/firstpath/
Vervolgens wordt de autorisatieheader voor verificatie vooraf verzonden met elke aanvraag naar een van de volgende Uri exemplaren:
http://www.contoso.com/firstpath/
http://www.contoso.com/firstpath/default
http://www.contoso.com/firstpath/default.html
http://www.contoso.com/firstpath/sample.html
De autorisatieheader wordt echter niet verzonden met aanvragen naar een van de volgende Uri exemplaren:
http://www.contoso.com/
http://www.contoso.com/firstpath
http://www.contoso.com/secondpath/
http://www.contoso.com/firstpath/thirdpath/
Als de clientaanvraag voor een specifieke Uri niet is geverifieerd, gebruikt de aanvraag standaardverificatieprocedures.
Met uitzondering van de eerste aanvraag geeft de PreAuthenticate eigenschap aan of verificatiegegevens moeten worden verzonden met volgende aanvragen naar een Uri die overeenkomt met de specifieke Uri slash tot aan de laatste slash zonder te wachten om te worden gevraagd door de server.
Het volgende dialoogvenster tussen client en server illustreert het effect van deze eigenschap. In het dialoogvenster wordt ervan uitgegaan dat basisverificatie wordt gebruikt.
PreAuthenticate is false:
Client: GET someUrl
Server: 401 WWW-Authenticate Basic
Client: GET met autorisatieheaders
Server: 200 OK
Client: GET someUrl
Server: 401 WWW-Authenticate Basic
Client: GET met autorisatieheaders
Server: 200 OK
PreAuthenticate is true:
Client: GET someUrl
Server: 401 WWW-Authenticate Basic
Client: GET met autorisatieheaders
Server: 200 OK
Client: GET someUrl with Authorization headers
Als het verificatieschema geen ondersteuning biedt voor verificatie vooraf, wordt de waarde van deze eigenschap genegeerd.