XmlResolver.Credentials Property

Definition

When overridden in a derived class, sets the credentials used to authenticate web requests.

public:
 virtual property System::Net::ICredentials ^ Credentials {  void set(System::Net::ICredentials ^ value); };
public:
 abstract property System::Net::ICredentials ^ Credentials {  void set(System::Net::ICredentials ^ value); };
public virtual System.Net.ICredentials Credentials { set; }
public abstract System.Net.ICredentials Credentials { set; }
member this.Credentials : System.Net.ICredentials
Public Overridable Property Credentials As ICredentials
Public MustOverride Property Credentials As ICredentials

Property Value

The credentials to be used to authenticate web requests. If this property is not set, the value defaults to null; that is, the XmlResolver has no user credentials.

Examples

See XmlUrlResolver.Credentials for an example that uses this property.

Remarks

If the virtual directory does not require authentication, this property doesn't have to be set. Otherwise, the credentials of the user must be supplied.

The following C# code sets credentials on the XmlResolver object.

NetworkCredential nc = new NetworkCredential(UserName, SecurelyStoredPassword, Domain);
XmlUrlResolver resolver = new XmlUrlResolver();
resolver.Credentials = nc;

You can associate different credentials with different URIs and add them to a cache. You can then use the credentials to check authentication for different URIs regardless of the original source of the XML.

NetworkCredential myCred = new NetworkCredential(UserName, SecurelyStoredPassword, Domain);
CredentialCache myCache = new CredentialCache();
myCache.Add(new Uri("http://www.contoso.com/"), "Basic", myCred);
myCache.Add(new Uri("http://app.contoso.com/"), "Basic", myCred);
XmlUrlResolver resolver = new XmlUrlResolver();
resolver.Credentials = myCache;

Applies to

See also