CredentialCache.GetCredential Metode

Referensi

Definisi

Ruang nama:: System.Net

Rakitan:: System.Net.Primitives.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengembalikan instans yang NetworkCredential terkait dengan Pengidentifikasi Sumber Daya Seragam (URI) atau host tertentu, dan jenis autentikasi.

Overload

GetCredential(Uri, String)	Mengembalikan instans yang NetworkCredential terkait dengan Uniform Resource Identifier (URI) dan jenis autentikasi yang ditentukan.
GetCredential(String, Int32, String)	Mengembalikan instans yang NetworkCredential terkait dengan host, port, dan protokol autentikasi yang ditentukan.

GetCredential(Uri, String)

Sumber:: CredentialCache.cs

Sumber:: CredentialCache.cs

Sumber:: CredentialCache.cs

Mengembalikan instans yang NetworkCredential terkait dengan Uniform Resource Identifier (URI) dan jenis autentikasi yang ditentukan.

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

public System.Net.NetworkCredential GetCredential (Uri uriPrefix, 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

Parameter

uriPrefix: Uri

Uri yang menentukan awalan URI sumber daya yang diberikan kredensial akses.

authType: String

Skema autentikasi yang digunakan oleh sumber daya bernama di uriPrefix.

Mengembalikan

NetworkCredential

A NetworkCredential atau, jika tidak ada kredensial yang cocok di cache, null.

Penerapan

GetCredential(Uri, String)

Pengecualian

ArgumentNullException

uriPrefix atau authType adalah null.

Contoh

Contoh kode berikut menggunakan metode untuk mengembalikan instans GetCredential(Uri, String) yang NetworkCredential terkait dengan URI dan jenis autentikasi yang ditentukan.

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

Keterangan

Metode GetCredential(Uri, String) mencari CredentialCache dan mengembalikan instans NetworkCredential untuk URI dan jenis otorisasi yang ditentukan. Jika tidak berisi instans yang CredentialCache NetworkCredential cocok, null dikembalikan.

GetCredential menggunakan awalan URI pencocokan terpanjang dalam cache untuk menentukan set kredensial mana yang akan dikembalikan untuk jenis otorisasi. Tabel berikut ini memperlihatkan contoh.

Awalan URI	Cocok
`http://www.contoso.com/portal/news.htm`	Permintaan untuk halaman `news.htm`Web tertentu .
`http://www.contoso.com/portal/`	Permintaan untuk semua konten di `portal` jalur, kecuali halaman `news.htm`.
`http://www.contoso.com/`	Permintaan untuk semua sumber daya di `www.contoso.com`, kecuali yang ada `portal` di jalur.

Berlaku untuk

GetCredential(String, Int32, String)

Sumber:: CredentialCache.cs

Sumber:: CredentialCache.cs

Sumber:: CredentialCache.cs

Mengembalikan instans yang NetworkCredential terkait dengan host, port, dan protokol autentikasi yang ditentukan.

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);

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

Parameter

host: String

String Yang mengidentifikasi komputer host.

port: Int32

Int32 yang menentukan port yang akan disambungkan pada host.

authenticationType: String

String Yang mengidentifikasi skema autentikasi yang digunakan saat menyambungkan ke host.

Mengembalikan

NetworkCredential

A NetworkCredential atau, jika tidak ada kredensial yang cocok di cache, null.

Penerapan

GetCredential(String, Int32, String)

Pengecualian

ArgumentNullException

hostadalah null.

-atau-

authTypeadalah null.

ArgumentException

authType bukan nilai yang diterima.

-atau-

host sama dengan string kosong ("").

ArgumentOutOfRangeException

port kurang dari nol.

Keterangan

Metode ini mencari CredentialCache dan mengembalikan instans NetworkCredential untuk host, port, dan jenis otorisasi yang ditentukan. Nilai host, port, dan authType yang diteruskan ke metode ini tidak peka huruf besar/kecil dibandingkan dengan nilai yang ditentukan ketika kredensial ditambahkan ke CredentialCache menggunakan Add metode .

Nilai yang didukung untuk authType adalah "NTLM", "Digest", "Kerberos", dan "Negosiasi".

Berlaku untuk

Bagikan melalui

CredentialCache.GetCredential Metode

Definisi

Overload

GetCredential(Uri, String)

Parameter

Mengembalikan

Penerapan

Pengecualian

Contoh

Keterangan

Berlaku untuk

GetCredential(String, Int32, String)

Parameter

Mengembalikan

Penerapan

Pengecualian

Keterangan

Berlaku untuk

Sumber Daya Tambahan: