This documentation is archived and is not being maintained.

CredentialCache.GetEnumerator Method

Returns an enumerator that can iterate through the CredentialCache instance.

Namespace: System.Net
Assembly: System (in system.dll)

public:
virtual IEnumerator^ GetEnumerator () sealed
public final IEnumerator GetEnumerator ()
public final function GetEnumerator () : IEnumerator
Not applicable.

Return Value

An IEnumerator for the CredentialCache.

The following code example uses the GetEnumerator method to return an enumerator that can iterate through the CredentialCache instance.

void Display( NetworkCredential^ credential )
{
   Console::WriteLine( "\n\tUsername : {0} , Password : {1} , Domain : {2}", credential->UserName, credential->Password, credential->Domain );
}

void GetPage( String^ url, String^ userName, String^ password, String^ domainName )
{
   try
   {
      CredentialCache^ myCredentialCache = gcnew CredentialCache;

      // Dummy Credentials used here.
      myCredentialCache->Add( gcnew Uri( "http://microsoft.com/" ), "Basic", gcnew NetworkCredential( "user1","passwd1","domain1" ) );
      myCredentialCache->Add( gcnew Uri( "http://msdn.com/" ), "Basic", gcnew NetworkCredential( "user2","passwd2","domain2" ) );
      myCredentialCache->Add( gcnew Uri( url ), "Basic", gcnew NetworkCredential( userName,password,domainName ) );

      // Creates a webrequest with the specified url.
      WebRequest^ myWebRequest = WebRequest::Create( url );
      myWebRequest->Credentials = myCredentialCache;
      IEnumerator^ listCredentials = myCredentialCache->GetEnumerator();
      Console::WriteLine( "\nDisplaying credentials stored in CredentialCache: " );
      while ( listCredentials->MoveNext() )
            Display( dynamic_cast<NetworkCredential^>(listCredentials->Current) );
      Console::WriteLine( "\nNow Displaying the same using 'foreach' : " );

      // Can use foreach with CredentialCache(Since GetEnumerator function of IEnumerable* has been implemented by 'CredentialCache' class.
      IEnumerator^ myEnum = myCredentialCache->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         NetworkCredential^ credential = safe_cast<NetworkCredential^>(myEnum->Current);
         Display( credential );
      }
      WebResponse^ myWebResponse = myWebRequest->GetResponse();

      // Process response here.
      Console::WriteLine( "\nResponse Received." );
      myWebResponse->Close();
   }
   catch ( WebException^ e ) 
   {
      if ( e->Response != nullptr )
            Console::WriteLine( "\r\nFailed to obtain a response. The following error occured : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->StatusDescription );
      else
            Console::WriteLine( "\r\nFailed to obtain a response. The following error occured : {0}", e->Status );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "\nThe following exception was raised : {0}", e->Message );
   }
}

public static void GetPage(String url, String userName, String password, 
    String domainName)
{
    try {
        CredentialCache myCredentialCache = new CredentialCache();

        // Dummy Credentials used here.             
        myCredentialCache.Add(new Uri("http://microsoft.com/"), "Basic", 
            new NetworkCredential("user1", "passwd1", "domain1"));
        myCredentialCache.Add(new Uri("http://msdn.com/"), "Basic", 
            new NetworkCredential("user2", "passwd2", "domain2"));
        myCredentialCache.Add(new Uri(url), "Basic", 
            new NetworkCredential(userName, password, domainName));

        // Creates a webrequest with the specified url.                 
        WebRequest myWebRequest = WebRequest.Create(url);
        myWebRequest.set_Credentials(myCredentialCache);
        IEnumerator listCredentials = myCredentialCache.GetEnumerator();
        Console.WriteLine("\nDisplaying credentials stored in "
            + "CredentialCache: ");
        while (listCredentials.MoveNext()) {
            Display((NetworkCredential)listCredentials.get_Current());
        }
        Console.WriteLine("\nNow Displaying the same using 'foreach' : ");
        IEnumerator myEnumerator = myCredentialCache.GetEnumerator();
        while (myEnumerator.MoveNext()) {
            NetworkCredential credential = (NetworkCredential)myEnumerator.
                get_Current();

            // Can use foreach with CredentialCache(Since GetEnumerator 
            // function of IEnumerable has been implemented by 
            // 'CredentialCache' class.
            Display(credential);
        }

        // Send the request and waits for response.
        WebResponse myWebResponse = myWebRequest.GetResponse();

        // Process response here.
        Console.WriteLine("\nResponse Received.");
        myWebResponse.Close();
    }
    catch (WebException e) {
        if (e.get_Response() != null) {
            Console.WriteLine("\r\nFailed to obtain a response. "
                + "The following error occured : {0}", 
                ((HttpWebResponse)e.get_Response()).get_StatusDescription());
        }
        else {
            Console.WriteLine("\r\nFailed to obtain a response. "
                + "The following error occured : {0}", e.get_Status());
        }
    }
    catch (System.Exception e) {
        Console.WriteLine("\nThe following exception was raised : {0}", 
            e.get_Message());
    }
} //GetPage

public static void Display(NetworkCredential credential)
{
    Console.WriteLine("\n\tUsername : {0} ,Password : {1} ,Domain : {2}", 
        credential.get_UserName(), credential.get_Password(), credential.
        get_Domain());
} //Display

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0
Show: