NetworkCredential Kelas

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.Primitives.dll

Sumber:

NetworkCredential.cs

Menyediakan kredensial untuk skema autentikasi berbasis kata sandi seperti autentikasi dasar, hash, NTLM, dan Kerberos.

public ref class NetworkCredential : System::Net::ICredentials, System::Net::ICredentialsByHost

public class NetworkCredential : System.Net.ICredentials, System.Net.ICredentialsByHost

type NetworkCredential = class
    interface ICredentials
    interface ICredentialsByHost

Public Class NetworkCredential
Implements ICredentials, ICredentialsByHost

Warisan

Object

NetworkCredential

Penerapan

ICredentials ICredentialsByHost

Contoh

Contoh kode berikut mengaitkan NetworkCredential objek dengan sekumpulan Pengidentifikasi Sumber Daya Seragam (URI) dalam CredentialCache. Kemudian meneruskan CredentialCache ke HttpClient objek , yang menggunakannya untuk mengautentikasi permintaan ke server Internet.

NetworkCredential^ myCred = gcnew NetworkCredential(
   SecurelyStoredUserName,SecurelyStoredPassword,SecurelyStoredDomain );

CredentialCache^ myCache = gcnew CredentialCache;

myCache->Add( gcnew Uri( "http://www.contoso.com" ), "Basic", myCred );
myCache->Add( gcnew Uri( "http://app.contoso.com" ), "Basic", myCred );

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClientHandler^ handler = gcnew HttpClientHandler();
handler->Credentials = myCache;
HttpClient^ client = gcnew HttpClient(handler);

NetworkCredential myCred = new NetworkCredential(
    SecurelyStoredUserName,SecurelyStoredPassword,SecurelyStoredDomain);

CredentialCache myCache = new CredentialCache();

myCache.Add(new Uri("http://www.contoso.com"), "Basic", myCred);
myCache.Add(new Uri("http://app.contoso.com"), "Basic", myCred);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
    Credentials = myCache
});

Dim myCred As New NetworkCredential(SecurelyStoredUserName, SecurelyStoredPassword, SecurelyStoredDomain)

Dim myCache As New CredentialCache()

myCache.Add(New Uri("http://www.contoso.com"), "Basic", myCred)
myCache.Add(New Uri("http://app.contoso.com"), "Basic", myCred)
       
' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
    .Credentials = myCache
})

Keterangan

Kelas NetworkCredential adalah kelas dasar yang memasok kredensial dalam skema autentikasi berbasis kata sandi seperti dasar, hash, NTLM, dan Kerberos. Kelas yang mengimplementasikan ICredentials antarmuka, seperti CredentialCache kelas, mengembalikan NetworkCredential objek.

Kelas ini tidak mendukung metode autentikasi berbasis kunci publik seperti autentikasi klien Secure Sockets Layer (SSL).

Konstruktor

NetworkCredential()	Menginisialisasi instans baru kelas NetworkCredential.
NetworkCredential(String, SecureString)	Menginisialisasi instans NetworkCredential baru kelas dengan nama pengguna dan kata sandi yang ditentukan.
NetworkCredential(String, SecureString, String)	Menginisialisasi instans NetworkCredential baru kelas dengan nama pengguna, kata sandi, dan domain yang ditentukan.
NetworkCredential(String, String)	Menginisialisasi instans NetworkCredential baru kelas dengan nama pengguna dan kata sandi yang ditentukan.
NetworkCredential(String, String, String)	Menginisialisasi instans NetworkCredential baru kelas dengan nama pengguna, kata sandi, dan domain yang ditentukan.

Properti

Domain	Mendapatkan atau mengatur domain atau nama komputer yang memverifikasi kredensial.
Password	Mendapatkan atau mengatur kata sandi untuk nama pengguna yang terkait dengan kredensial.
SecurePassword	Mendapatkan atau mengatur kata sandi sebagai SecureString instans.
UserName	Mendapatkan atau mengatur nama pengguna yang terkait dengan kredensial.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetCredential(String, Int32, String)	Mengembalikan instans NetworkCredential kelas untuk host, port, dan jenis autentikasi yang ditentukan.
GetCredential(Uri, String)	Mengembalikan instans NetworkCredential kelas untuk Pengidentifikasi Sumber Daya Seragam (URI) dan jenis autentikasi yang ditentukan.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)