XmlUrlResolver.Credentials Property

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

UnsupportedOSPlatformAttribute

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;  

Applies to

See also

• CredentialCache
• NetworkCredential