XmlUrlResolver.Credentials Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Sets credentials used to authenticate web requests.
public:
virtual property System::Net::ICredentials ^ Credentials { void set(System::Net::ICredentials ^ value); };
public override System.Net.ICredentials Credentials { set; }
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public override System.Net.ICredentials Credentials { set; }
member this.Credentials : System.Net.ICredentials
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.Credentials : System.Net.ICredentials
Public Overrides 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 XmlUrlResolver
has no user credentials.
- Attributes
Examples
The following example creates an XmlUrlResolver object with credentials. The XmlReader uses the credentials on the XmlUrlResolver object to access a network resource.
// Create a resolver and specify the necessary credentials.
XmlUrlResolver resolver = new XmlUrlResolver();
System.Net.NetworkCredential myCred;
myCred = new System.Net.NetworkCredential(UserName,SecurelyStoredPassword,Domain);
resolver.Credentials = myCred;
' Create a resolver and specify the necessary credentials.
Dim resolver As New XmlUrlResolver()
Dim myCred As System.Net.NetworkCredential
myCred = New System.Net.NetworkCredential(UserName, SecurelyStoredPassword, Domain)
resolver.Credentials = myCred
Remarks
If the virtual directory does not require authentication, this property does not need to be set. Otherwise, the credentials of the user must be supplied.
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.
The following C# code shows how to set the Credentials property to a credential cache.
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;