CredentialCache.GetCredential Methode

Referenz

Definition

Namespace:: System.Net

Assembly:: System.Net.Primitives.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt eine NetworkCredential-Instanz zurück, die einem angegebenen URI (Uniform Resource Identifier) oder Host und einem angegebenen Authentifizierungstyp zugeordnet ist.

Überlädt

GetCredential(Uri, String)	Gibt die dem angegebenen URI (Uniform Resource Identifier) und Authentifizierungstyp zugeordnete NetworkCredential-Instanz zurück.
GetCredential(String, Int32, String)	Gibt die NetworkCredential-Instanz zurück, die dem angegebenen Host, dem angegebenen Anschluss und dem angegebenen Authentifizierungsprotokoll zugeordnet ist.

GetCredential(Uri, String)

Quelle:: CredentialCache.cs

Quelle:: CredentialCache.cs

Quelle:: CredentialCache.cs

Gibt die dem angegebenen URI (Uniform Resource Identifier) und Authentifizierungstyp zugeordnete NetworkCredential-Instanz zurück.

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

Ein Uri, der das URI-Präfix der Ressource angibt, für die die Anmeldeinformationen Zugriff gewähren.

authType: String

Das von der in uriPrefix angegebenen Ressource verwendete Authentifizierungsschema.

Gibt zurück

NetworkCredential

NetworkCredential oder null, wenn keine übereinstimmenden Anmeldeinformationen im Cache vorhanden sind.

Implementiert

GetCredential(Uri, String)

Ausnahmen

ArgumentNullException

uriPrefix oder authType ist null.

Beispiele

Im folgenden Codebeispiel wird die GetCredential(Uri, String) -Methode verwendet, um die Instanz zurückzugeben, die NetworkCredential dem angegebenen URI und dem angegebenen Authentifizierungstyp zugeordnet ist.

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

Hinweise

Die GetCredential(Uri, String) -Methode durchsucht die CredentialCache Und gibt die NetworkCredential Instanz nach dem angegebenen URI und dem angegebenen Autorisierungstyp zurück. Wenn die CredentialCache keine übereinstimmende NetworkCredential Instanz enthält, null wird zurückgegeben.

GetCredential verwendet das längste übereinstimmende URI-Präfix im Cache, um zu bestimmen, welcher Satz von Anmeldeinformationen für einen Autorisierungstyp zurückgegeben werden soll. Die folgende Tabelle enthält Beispiele.

URI-Präfix	Treffer
`http://www.contoso.com/portal/news.htm`	Anforderungen für die bestimmte Webseite `news.htm`.
`http://www.contoso.com/portal/`	Anforderungen für alle Inhalte im `portal` Pfad, mit Ausnahme der Seite `news.htm`.
`http://www.contoso.com/`	Anforderungen für alle Ressourcen unter `www.contoso.com`, mit Ausnahme der Ressourcen im `portal` Pfad.

Gilt für:

GetCredential(String, Int32, String)

Quelle:: CredentialCache.cs

Quelle:: CredentialCache.cs

Quelle:: CredentialCache.cs

Gibt die NetworkCredential-Instanz zurück, die dem angegebenen Host, dem angegebenen Anschluss und dem angegebenen Authentifizierungsprotokoll zugeordnet ist.

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

Ein String, der den Hostcomputer bezeichnet.

port: Int32

Ein Int32, der den Anschluss angibt, mit dem auf dem host eine Verbindung hergestellt werden soll.

authenticationType: String

Ein String, der das Authentifizierungsschema bezeichnet, das beim Herstellen einer Verbindung mit dem host verwendet wird.

Gibt zurück

NetworkCredential

NetworkCredential oder null, wenn keine übereinstimmenden Anmeldeinformationen im Cache vorhanden sind.

Implementiert

GetCredential(String, Int32, String)

Ausnahmen

ArgumentNullException

host ist null.

- oder -

authType ist null.

ArgumentException

authType ist kein zulässiger Wert.

- oder -

host ist gleich der leeren Zeichenfolge ("").

ArgumentOutOfRangeException

port ist kleiner als Null.

Hinweise

Diese Methode durchsucht die CredentialCache und gibt die NetworkCredential Instanz nach dem angegebenen Host, Port und Autorisierungstyp zurück. Bei hostden an diese Methode übergebenen Werten , port, und authType wird die Groß-/Kleinschreibung nicht berücksichtigt, verglichen mit den Werten, die angegeben wurden, als die Anmeldeinformationen mithilfe der Add Methoden hinzugefügt CredentialCache wurden.

Die unterstützten Werte für authType sind "NTLM", "Digest", "Kerberos" und "Negotiate".

Gilt für:

Freigeben über

CredentialCache.GetCredential Methode

Definition

Überlädt

GetCredential(Uri, String)

Parameter

Gibt zurück

Implementiert

Ausnahmen

Beispiele

Hinweise

Gilt für:

GetCredential(String, Int32, String)

Parameter

Gibt zurück

Implementiert

Ausnahmen

Hinweise

Gilt für:

Zusätzliche Ressourcen