CredentialCache.GetCredential Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce un'istanza di NetworkCredential associata a un URI (Uniform Resource Identifier) oppure a un host e a un tipo di autenticazione specificati.
Overload
GetCredential(Uri, String) |
Restituisce l'istanza NetworkCredential associata al tipo di autenticazione e all'URI specificati. |
GetCredential(String, Int32, String) |
Restituisce l'istanza di NetworkCredential associata all'host, alla porta e al protocollo di autenticazione specificati. |
GetCredential(Uri, String)
- Origine:
- CredentialCache.cs
- Origine:
- CredentialCache.cs
- Origine:
- CredentialCache.cs
Restituisce l'istanza NetworkCredential associata al tipo di autenticazione e all'URI specificati.
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
Parametri
- uriPrefix
- Uri
Un Uri che specifica il prefisso URI delle risorse a cui la credenziale concede l'accesso.
- authType
- String
Lo schema di autenticazione utilizzato dalla risorsa specificata in uriPrefix
.
Restituisce
Una NetworkCredential oppure null
se non esistono credenziali corrispondenti nella cache.
Implementazioni
Eccezioni
uriPrefix
o authType
è null
.
Esempio
Nell'esempio di codice seguente viene usato il metodo per restituire l'istanza GetCredential(Uri, String) associata all'URI NetworkCredential e al tipo di autenticazione specificati.
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
Commenti
Il GetCredential(Uri, String) metodo cerca e CredentialCache restituisce l'istanza per l'URI e il NetworkCredential tipo di autorizzazione specificati. Se l'istanza CredentialCache non contiene alcuna istanza corrispondente NetworkCredential , null
viene restituita.
GetCredential usa il prefisso URI corrispondente più lungo nella cache per determinare quale set di credenziali restituire per un tipo di autorizzazione. La tabella seguente mostra esempi.
Prefisso URI | Corrispondenze |
---|---|
http://www.contoso.com/portal/news.htm |
Richieste per la pagina news.htm Web specifica. |
http://www.contoso.com/portal/ |
Richieste per tutti i contenuti nel portal percorso, ad eccezione della pagina news.htm . |
http://www.contoso.com/ |
Richieste per tutte le risorse in www.contoso.com , ad eccezione di quelle nel portal percorso. |
Si applica a
GetCredential(String, Int32, String)
- Origine:
- CredentialCache.cs
- Origine:
- CredentialCache.cs
- Origine:
- CredentialCache.cs
Restituisce l'istanza di NetworkCredential associata all'host, alla porta e al protocollo di autenticazione specificati.
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
Parametri
- authenticationType
- String
Oggetto String che identifica lo schema di autenticazione utilizzato durante la connessione a host
.
Restituisce
Una NetworkCredential oppure null
se non esistono credenziali corrispondenti nella cache.
Implementazioni
Eccezioni
authType
non è un valore accettato.
-oppure-
host
è uguale alla stringa vuota ("").
port
è minore di zero.
Commenti
Questo metodo cerca e CredentialCache restituisce l'istanza NetworkCredential per il tipo di host, porta e autorizzazione specificato. I host
valori , port
e passati a questo metodo sono senza distinzione tra maiuscole e authType
minuscole rispetto ai valori specificati quando la credenziale è stata aggiunta ai CredentialCacheAdd metodi.
I valori supportati per authType
sono "NTLM", "Digest", "Kerberos" e "Negotiate".
Si applica a
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per