CredentialCache.GetCredential Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.Primitives.dll

NetworkCredential Zwraca wystąpienie skojarzone z określonym identyfikatorem URI (Uniform Resource Identifier) lub hostem oraz typem uwierzytelniania.

Przeciążenia

GetCredential(Uri, String)	NetworkCredential Zwraca wystąpienie skojarzone z określonym identyfikatorem URI (Uniform Resource Identifier) i typem uwierzytelniania.
GetCredential(String, Int32, String)	NetworkCredential Zwraca wystąpienie skojarzone z określonym hostem, portem i protokołem uwierzytelniania.

GetCredential(Uri, String)

Źródło:

CredentialCache.cs

NetworkCredential Zwraca wystąpienie skojarzone z określonym identyfikatorem URI (Uniform Resource Identifier) i typem uwierzytelniania.

public:
 virtual System::Net::NetworkCredential ^ GetCredential(Uri ^ uriPrefix, System::String ^ authType);

public System.Net.NetworkCredential? GetCredential (Uri uriPrefix, string authType);

abstract member GetCredential : Uri * string -> System.Net.NetworkCredential
override this.GetCredential : Uri * string -> System.Net.NetworkCredential

Public Function GetCredential (uriPrefix As Uri, authType As String) As NetworkCredential

Parametry

uriPrefix

Uri

Element Uri określający prefiks identyfikatora URI zasobów, do których poświadczenia udziela dostępu.

authType

String

Schemat uwierzytelniania używany przez zasób o nazwie w uriPrefix.

Zwraca

NetworkCredential

A NetworkCredential lub, jeśli w pamięci podręcznej nie ma pasujących poświadczeń, null.

Implementuje

GetCredential(Uri, String)

Wyjątki

ArgumentNullException

uriPrefix lub authType to null.

Przykłady

Poniższy przykład kodu używa metody , GetCredential(Uri, String) aby zwrócić NetworkCredential wystąpienie skojarzone z określonym identyfikatorem URI i typem uwierzytelniania.

void Display( NetworkCredential^ credential )
{
   Console::WriteLine( "\nThe credentials are:" );
   Console::WriteLine( "\nUsername : {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 names used as credentials.
      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 ) );

      // Create a webrequest with the specified url.
      WebRequest^ myWebRequest = WebRequest::Create( url );

      // Call 'GetCredential' to obtain the credentials specific to our Uri.
      NetworkCredential^ myCredential = myCredentialCache->GetCredential( gcnew Uri( url ), "Basic" );
      Display( myCredential );

      // Associating only our credentials.
      myWebRequest->Credentials = myCredential;

      // Sends the request and waits for response.
      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 occurred : {0}", (dynamic_cast<HttpWebResponse^>(e->Response))->StatusDescription );
      else
            Console::WriteLine( "\r\nFailed to obtain a response. The following error occurred : {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 names used as credentials.
          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));
          // Create a webrequest with the specified url.
       WebRequest myWebRequest = WebRequest.Create(url);
          // Call 'GetCredential' to obtain the credentials specific to our Uri.
          NetworkCredential myCredential = myCredentialCache.GetCredential(new Uri(url),"Basic");
          Display(myCredential);
       // Associating only our credentials.
          myWebRequest.Credentials = myCredential;
          // Sends the request and waits for response.
       WebResponse myWebResponse = myWebRequest.GetResponse();

          // Process response here.

       Console.WriteLine("\nResponse Received.");
          myWebResponse.Close();
      }
      catch(WebException e)
      {
          if (e.Response != null)
              Console.WriteLine("\r\nFailed to obtain a response. The following error occurred : {0}",((HttpWebResponse)(e.Response)).StatusDescription);
          else
              Console.WriteLine("\r\nFailed to obtain a response. The following error occurred : {0}",e.Status);
      }
      catch(Exception e)
      {
          Console.WriteLine("\nThe following exception was raised : {0}",e.Message);
      }
}
public static void Display(NetworkCredential credential)
{
  Console.WriteLine("\nThe credentials are:");
  Console.WriteLine("\nUsername : {0} ,Password : {1} ,Domain : {2}",credential.UserName,credential.Password,credential.Domain);
}

Public Shared Sub GetPage(url As String, userName As String, password As String, domainName As String)
    Try
        Dim myCredentialCache As New CredentialCache()
        ' Dummy names used as credentials    
        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. 
        Dim myWebRequest As WebRequest = WebRequest.Create(url)
        ' Call 'GetCredential' to obtain the credentials specific to our Uri.
        Dim myCredential As NetworkCredential = myCredentialCache.GetCredential(New Uri(url), "Basic")
        Display(myCredential)
        myWebRequest.Credentials = myCredential 'Associating only our credentials            
        ' Sends the request and waits for response.
        Dim myWebResponse As WebResponse = myWebRequest.GetResponse()
        ' Process response here.
        Console.WriteLine(ControlChars.Cr + "Response Received.")
        myWebResponse.Close()

    Catch e As WebException
        If Not (e.Response Is Nothing) Then
            Console.WriteLine(ControlChars.Lf + ControlChars.Cr + "Failed to obtain a response. The following error occurred : {0}", CType(e.Response, HttpWebResponse).StatusDescription)
        Else
            Console.WriteLine(ControlChars.Lf + ControlChars.Cr + "Failed to obtain a response. The following error occurred : {0}", e.Status)
        End If
    Catch e As Exception
        Console.WriteLine(ControlChars.Cr + "The following exception was raised : {0}", e.Message)
    End Try
End Sub

Public Shared Sub Display(ByVal credential As NetworkCredential)
    Console.WriteLine("The credentials are: ")
    Console.WriteLine(ControlChars.Cr + "Username : {0} ,Password : {1} ,Domain : {2}", credential.UserName, credential.Password, credential.Domain)
End Sub

Uwagi

Metoda GetCredential(Uri, String) wyszukuje i CredentialCache zwraca NetworkCredential wystąpienie określonego identyfikatora URI i typu autoryzacji. Jeśli obiekt CredentialCache nie zawiera pasującego NetworkCredential wystąpienia, null zostanie zwrócony.

GetCredential używa najdłuższego pasującego prefiksu identyfikatora URI w pamięci podręcznej, aby określić, który zestaw poświadczeń ma zostać zwrócony dla typu autoryzacji. W poniższej tabeli przedstawiono przykłady.

Prefiks identyfikatora URI	Jest zgodny z
http://www.contoso.com/portal/news.htm	Żądania dotyczące określonej strony news.htmsieci Web.
http://www.contoso.com/portal/	Żądania dotyczące całej zawartości w ścieżce portal , z wyjątkiem strony news.htm.
http://www.contoso.com/	Żądania dotyczące wszystkich zasobów w lokalizacji www.contoso.com, z wyjątkiem tych w ścieżce portal .

GetCredential(String, Int32, String)

Źródło:

CredentialCache.cs

NetworkCredential Zwraca wystąpienie skojarzone z określonym hostem, portem i protokołem uwierzytelniania.

public:
 virtual System::Net::NetworkCredential ^ GetCredential(System::String ^ host, int port, System::String ^ authenticationType);

public System.Net.NetworkCredential? GetCredential (string host, int port, string authenticationType);

abstract member GetCredential : string * int * string -> System.Net.NetworkCredential
override this.GetCredential : string * int * string -> System.Net.NetworkCredential

Public Function GetCredential (host As String, port As Integer, authenticationType As String) As NetworkCredential

Parametry

host

String

Element String identyfikujący komputer hosta.

port

Int32

Element Int32 określający port do nawiązania połączenia z usługą w systemie host.

authenticationType

String

Element String identyfikujący schemat uwierzytelniania używany podczas nawiązywania hostpołączenia z usługą .

Zwraca

NetworkCredential

A NetworkCredential lub, jeśli w pamięci podręcznej nie ma pasujących poświadczeń, null.

Implementuje

GetCredential(String, Int32, String)

Wyjątki

ArgumentNullException

host to null.

-lub-

authType to null.

ArgumentException

authType nie jest akceptowaną wartością.

-lub-

host jest równa pustemu ciągowi ("").

ArgumentOutOfRangeException

Parametr port ma wartość niższą niż zero.

Uwagi

Ta metoda wyszukuje i CredentialCache zwraca NetworkCredential wystąpienie określonego hosta, portu i typu autoryzacji. Wartości host, porti authType przekazane do tej metody są bez uwzględniania wielkości liter w porównaniu z wartościami określonymi podczas dodawania poświadczeń do CredentialCache metody przy użyciu Add metod.

Obsługiwane wartości authType to "NTLM", "Digest", "Kerberos" i "Negotiate".