CredentialCache.GetCredential Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.Primitives.dll

Belirtilen Tekdüzen NetworkCredential Kaynak Tanımlayıcısı (URI) veya ana bilgisayar ve kimlik doğrulama türüyle ilişkilendirilmiş bir örneği döndürür.

Aşırı Yüklemeler

GetCredential(Uri, String)	NetworkCredential Belirtilen Tekdüzen Kaynak Tanımlayıcısı (URI) ve kimlik doğrulama türüyle ilişkili örneği döndürür.
GetCredential(String, Int32, String)	NetworkCredential Belirtilen konak, bağlantı noktası ve kimlik doğrulama protokolüyle ilişkili örneği döndürür.

GetCredential(Uri, String)

Kaynak:

CredentialCache.cs

NetworkCredential Belirtilen Tekdüzen Kaynak Tanımlayıcısı (URI) ve kimlik doğrulama türüyle ilişkili örneği döndürür.

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

Parametreler

uriPrefix

Uri

Uri Kimlik bilgilerinin erişim izni veren kaynakların URI ön ekini belirten bir.

authType

String

içinde adlı uriPrefixkaynak tarafından kullanılan kimlik doğrulama şeması.

Döndürülenler

NetworkCredential

Veya NetworkCredential , önbellekte eşleşen bir kimlik bilgisi yoksa, null.

Uygulamalar

GetCredential(Uri, String)

Özel durumlar

ArgumentNullException

uriPrefix veya authType şeklindedir null.

Örnekler

Aşağıdaki kod örneği, belirtilen URI ve kimlik doğrulama türüyle ilişkili örneği döndürmek NetworkCredential için yöntemini kullanırGetCredential(Uri, String).

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

Açıklamalar

yöntemi, GetCredential(Uri, String) öğesini arar CredentialCache ve belirtilen URI ve yetkilendirme türü için örneği döndürür NetworkCredential . CredentialCache eşleşen NetworkCredential örnek içermiyorsa döndürülürnull.

GetCredential , bir yetkilendirme türü için döndürülecek kimlik bilgileri kümesini belirlemek için önbellekteki en uzun eşleşen URI ön ekini kullanır. Aşağıdaki tabloda örnekler gösterilmektedir.

URI Ön Eki	Eşleşmeler
http://www.contoso.com/portal/news.htm	Belirli Web sayfası news.htmiçin istekler.
http://www.contoso.com/portal/	yolu içindeki portal sayfa news.htmdışındaki tüm içerik için istekler.
http://www.contoso.com/	yolundakiler dışında konumundaki www.contoso.comtüm kaynaklar için istekler portal .

GetCredential(String, Int32, String)

Kaynak:

CredentialCache.cs

NetworkCredential Belirtilen konak, bağlantı noktası ve kimlik doğrulama protokolüyle ilişkili örneği döndürür.

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

Parametreler

host

String

String Ana bilgisayarı tanımlayan bir.

port

Int32

Int32 üzerinde hostbağlanacak bağlantı noktasını belirten bir.

authenticationType

String

String öğesine bağlanırken kullanılan kimlik doğrulama düzenini tanımlayan birhost.

Döndürülenler

NetworkCredential

Veya NetworkCredential , önbellekte eşleşen bir kimlik bilgisi yoksa, null.

Uygulamalar

GetCredential(String, Int32, String)

Özel durumlar

ArgumentNullException

host, null değeridir.

-veya-

authType, null değeridir.

ArgumentException

authType kabul edilen bir değer değildir.

-veya-

host boş dizeye ("") eşittir.

ArgumentOutOfRangeException

port, sıfırdan küçüktür.

Açıklamalar

Bu yöntem, belirtilen konak, bağlantı noktası ve yetkilendirme türü için öğesini arar CredentialCache ve örneğini döndürür NetworkCredential . hostBu yönteme geçirilen , portve authType değerleri, kimlik bilgileri yöntemleri kullanılarak Add öğesine eklendiğinde CredentialCache belirtilen değerlerle karşılaştırıldığında büyük/küçük harfe duyarlı değildir.

için authType desteklenen değerler "NTLM", "Digest", "Kerberos" ve "Negotiate" değerleridir.