CredentialCache.GetCredential Metódus

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.Primitives.dll

NetworkCredential Egy megadott egységes erőforrás-azonosítóhoz (URI) vagy gazdagéphez és hitelesítési típushoz társított példányt ad vissza.

Túlterhelések

Name	Description
GetCredential(Uri, String)	NetworkCredential A megadott egységes erőforrás-azonosítóhoz (URI) és hitelesítési típushoz társított példányt adja vissza.
GetCredential(String, Int32, String)	NetworkCredential A megadott gazdagéphez, porthoz és hitelesítési protokollhoz társított példányt adja vissza.

GetCredential(Uri, String)

Forrás:

CredentialCache.cs

NetworkCredential A megadott egységes erőforrás-azonosítóhoz (URI) és hitelesítési típushoz társított példányt adja vissza.

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

Paraméterek

uriPrefix

Uri

Azoknak Uri az erőforrásoknak az URI-előtagját adja meg, amelyekhez a hitelesítő adat hozzáférést biztosít.

authType

String

A nevű erőforrás uriPrefixáltal használt hitelesítési séma.

Válaszok

NetworkCredential

A NetworkCredential vagy, ha nincs egyező hitelesítő adat a gyorsítótárban, null.

Megvalósítás

GetCredential(Uri, String)

Kivételek

ArgumentNullException

uriPrefix vagy authType az null.

Példák

Az alábbi példakód a GetCredential(Uri, String) metódus használatával adja vissza a NetworkCredential megadott URI- és hitelesítési típushoz társított példányt.

  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

Megjegyzések

A GetCredential(Uri, String) metódus megkeresi a CredentialCache példányt, és visszaadja a NetworkCredential megadott URI- és engedélyezési típust. Ha a CredentialCache program nem tartalmaz egyező NetworkCredential példányt, null a függvény visszaadja.

GetCredential A gyorsítótárban a leghosszabb egyező URI-előtaggal határozza meg, hogy melyik hitelesítő adatkészletet adja vissza egy engedélyezési típushoz. Az alábbi táblázat példákat mutat be.

URI-előtag	Egyezések
http://www.contoso.com/portal/news.htm	Az adott weblapra news.htmvonatkozó kérések.
http://www.contoso.com/portal/	Az elérési út összes tartalmára portal vonatkozó kérések, kivéve a lapot news.htm.
http://www.contoso.com/	Az összes erőforrásra vonatkozó kérések az www.contoso.comelérési úton lévők portal kivételével.

GetCredential(String, Int32, String)

Forrás:

CredentialCache.cs

NetworkCredential A megadott gazdagéphez, porthoz és hitelesítési protokollhoz társított példányt adja vissza.

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

Paraméterek

host

String

A String gazdaszámítógépet azonosító fájl.

port

Int32

Az Int32 a port, amelyhez csatlakozni hostszeretne.

authenticationType

String

A String rendszer azonosítja a csatlakozáskor használt hitelesítési sémát host.

Válaszok

NetworkCredential

A NetworkCredential vagy, ha nincs egyező hitelesítő adat a gyorsítótárban, null.

Megvalósítás

GetCredential(String, Int32, String)

Kivételek

ArgumentNullException

host az null.

-vagy-

authenticationType az null.

ArgumentException

authenticationType nem elfogadott érték.

-vagy-

host egyenlő az üres sztringgel ("").

ArgumentOutOfRangeException

port kisebb, mint nulla.

Megjegyzések

Ez a metódus megkeresi a CredentialCache megadott gazdagépet, portot és engedélyezési típust, és visszaadja a NetworkCredential példányt. A hostmetódusnak átadott , portés értékek kis- és authenticationType nagybetűket nem érzéketlenül hasonlítják össze a hitelesítő adatoknak a CredentialCache metódusok használatával való hozzáadásakor Add megadott értékekkel.

A támogatott értékek a következők: authenticationType "NTLM", "Digest", "Kerberos" és "Negotiate".