CredentialCache.Add Metod

Definition

Namnområde:
System.Net
Sammansättningar:
System.dll, System.Net.Primitives.dll
Sammansättningar:
netstandard.dll, System.Net.Primitives.dll
Sammansättning:
System.Net.Primitives.dll
Sammansättning:
System.dll
Sammansättning:
netstandard.dll

Lägger till en NetworkCredential instans i cacheminnet för autentiseringsuppgifter.

Överlagringar

Name Description
Add(Uri, String, NetworkCredential)

Lägger till en NetworkCredential instans i cacheminnet för autentiseringsuppgifter för användning med andra protokoll än SMTP och associerar den med ett URI-prefix (Uniform Resource Identifier) och autentiseringsprotokoll.
Add(String, Int32, String, NetworkCredential)

Lägger till en NetworkCredential instans för användning med SMTP i cacheminnet för autentiseringsuppgifter och associerar den med en värddator, port och autentiseringsprotokoll. Autentiseringsuppgifter som läggs till med den här metoden är endast giltiga för SMTP. Den här metoden fungerar inte för HTTP- eller FTP-begäranden.

Add(Uri, String, NetworkCredential)

Källa:
CredentialCache.cs
Källa:
CredentialCache.cs
Källa:
CredentialCache.cs
Källa:
CredentialCache.cs
Källa:
CredentialCache.cs

Lägger till en NetworkCredential instans i cacheminnet för autentiseringsuppgifter för användning med andra protokoll än SMTP och associerar den med ett URI-prefix (Uniform Resource Identifier) och autentiseringsprotokoll.

public:
 void Add(Uri ^ uriPrefix, System::String ^ authType, System::Net::NetworkCredential ^ cred);
public void Add(Uri uriPrefix, string authType, System.Net.NetworkCredential cred);
member this.Add : Uri * string * System.Net.NetworkCredential -> unit
Public Sub Add (uriPrefix As Uri, authType As String, cred As NetworkCredential)

Parametrar

uriPrefix
Uri

En Uri som anger URI-prefixet för de resurser som autentiseringsuppgifterna ger åtkomst till.

authType
String

Autentiseringsschemat som används av resursen med namnet i uriPrefix.

cred
NetworkCredential

Att NetworkCredential lägga till i cacheminnet för autentiseringsuppgifter.

Undantag

ArgumentNullException

uriPrefix är null.

-eller-

authType är null.

ArgumentException

Samma autentiseringsuppgifter läggs till mer än en gång.

Exempel

I följande kodexempel initieras en CredentialCache med flera säkerhetsautentiseringsuppgifter och dessa autentiseringsuppgifter används med en WebRequest.

CredentialCache myCache = new CredentialCache();

myCache.Add(new Uri("http://www.contoso.com/"),"Basic",new NetworkCredential(UserName,SecurelyStoredPassword));
myCache.Add(new Uri("http://www.contoso.com/"),"Digest", new NetworkCredential(UserName,SecurelyStoredPassword,Domain));

wReq.Credentials = myCache;

Dim myCache As New CredentialCache()

myCache.Add(New Uri("http://www.contoso.com/"), "Basic", New NetworkCredential(UserName, SecurelyStoredPassword))
myCache.Add(New Uri("http://www.contoso.com/"), "Digest", New NetworkCredential(UserName, SecurelyStoredPassword, Domain))

wReq.Credentials = myCache

Kommentarer

Metoden Add placerar en NetworkCredential instans för användning med andra protokoll än SMTP i CredentialCache. Cacheminnet lagrar autentiseringsuppgifter i den ordning som de läggs till i den. GetCredential(Uri, String) När metoden anropas returneras rätt matchande NetworkCredential instans.

Gäller för

Add(String, Int32, String, NetworkCredential)

Källa:
CredentialCache.cs
Källa:
CredentialCache.cs
Källa:
CredentialCache.cs
Källa:
CredentialCache.cs
Källa:
CredentialCache.cs

Lägger till en NetworkCredential instans för användning med SMTP i cacheminnet för autentiseringsuppgifter och associerar den med en värddator, port och autentiseringsprotokoll. Autentiseringsuppgifter som läggs till med den här metoden är endast giltiga för SMTP. Den här metoden fungerar inte för HTTP- eller FTP-begäranden.

public:
 void Add(System::String ^ host, int port, System::String ^ authenticationType, System::Net::NetworkCredential ^ credential);
public void Add(string host, int port, string authenticationType, System.Net.NetworkCredential credential);
member this.Add : string * int * string * System.Net.NetworkCredential -> unit
Public Sub Add (host As String, port As Integer, authenticationType As String, credential As NetworkCredential)

Parametrar

host
String

En String som identifierar värddatorn.

port
Int32

En Int32 som anger porten som ska anslutas till på host.

authenticationType
String

En String som identifierar det autentiseringsschema som används vid anslutning till host med hjälp av credential.

credential
NetworkCredential

Att NetworkCredential lägga till i cacheminnet för autentiseringsuppgifter.

Undantag

ArgumentNullException

host är null.

-eller-

authenticationType är null.

ArgumentException

authenticationType inte ett godkänt värde.

ArgumentOutOfRangeException

port är mindre än noll.

Exempel

I följande kodexempel initieras en CredentialCache med flera säkerhetsautentiseringsuppgifter för användning med SMTP och använder en av dessa autentiseringsuppgifter med en SmtpClient.

SmtpClient client = new SmtpClient("ContosoMail", 45);
MailAddress from = new MailAddress("sender@SenderMailServerName.com", "Sender Name");
MailAddress to = new MailAddress("recepient@RecepientMailServerName.com", "Recepient Name");
MailMessage message = new MailMessage(from, to);

message.Body = "This is a test email message sent by an application. ";
message.Subject = "Test Email using Credentials";

NetworkCredential myCreds = new NetworkCredential("username", "password", "domain");
CredentialCache myCredentialCache = new CredentialCache();
try
{
    myCredentialCache.Add("ContoscoMail", 35, "Basic", myCreds);
    myCredentialCache.Add("ContoscoMail", 45, "NTLM", myCreds);

    client.Credentials = myCredentialCache.GetCredential("ContosoMail", 45, "NTLM");
    client.Send(message);
    Console.WriteLine("Goodbye.");
}
    catch(Exception e)
    {
          Console.WriteLine("Exception is raised. ");
          Console.WriteLine("Message: {0} ",e.Message);
    }

Dim client As New SmtpClient("ContosoMail", 45)
Dim from As New MailAddress("sender@SenderMailServerName.com", "Sender Name")
Dim sendTo As New MailAddress("recepient@RecepientMailServerName.com", "Recepient Name")
Dim message As New MailMessage(from, sendTo)

message.Body = "This is a test email message sent by an application. "
message.Subject = "Test Email using Credentials"

Dim myCreds As New NetworkCredential("username", "password", "domain")
DIm myCredentialCache As New CredentialCache()

Try 
    myCredentialCache.Add("ContoscoMail", 35, "Basic", myCreds)
    myCredentialCache.Add("ContoscoMail", 45, "NTLM", myCreds)

    client.Credentials = myCredentialCache.GetCredential("ContosoMail", 45, "NTLM")
    client.Send(message)
    Console.WriteLine("Goodbye.")
Catch e As Exception
    Console.WriteLine("Exception is raised. ")
    Console.WriteLine($"Message: {e.Message} ")
End Try

Kommentarer

Den här metoden placerar en NetworkCredential instans för användning med SMTP i CredentialCache. Cacheminnet lagrar autentiseringsuppgifter i den ordning som de läggs till i den. GetCredential(String, Int32, String) När metoden anropas returneras en NetworkCredential instans som har valts genom att matcha host, portoch authenticationType. Jämförelsen görs skiftlägesokänsligt.

De värden som stöds för authenticationType är "NTLM", "Digest", "Kerberos" och "Negotiate".

Autentiseringsuppgifter som har lagts till med den här metoden är endast giltiga för användning med SMTP. Den här metoden fungerar inte för HTTP- eller FTP-protokoll.

Gäller för