NetworkCredential Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje přihlašovací údaje pro schémata ověřování založeného na heslech, jako je základní ověřování, ověřování hodnotou hash, protokolem NTLM a protokolem Kerberos.
public ref class NetworkCredential : System::Net::ICredentials, System::Net::ICredentialsByHost
public ref class NetworkCredential : System::Net::ICredentials
public class NetworkCredential : System.Net.ICredentials, System.Net.ICredentialsByHost
public class NetworkCredential : System.Net.ICredentials
type NetworkCredential = class
interface ICredentials
interface ICredentialsByHost
type NetworkCredential = class
interface ICredentials
Public Class NetworkCredential
Implements ICredentials, ICredentialsByHost
Public Class NetworkCredential
Implements ICredentials
- Dědičnost
-
NetworkCredential
- Implementuje
Příklady
Následující příklad kódu přidruží NetworkCredential objekt k sadě identifikátorů URI (Uniform Resource Identifier) v objektu CredentialCache. Poté předá CredentialCache objektu , který ho HttpClient používá k ověřování požadavků na internetový server.
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://video2.skills-academy.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://video2.skills-academy.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://video2.skills-academy.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
.Credentials = myCache
})
Poznámky
Třída NetworkCredential je základní třída, která poskytuje přihlašovací údaje ve schématech ověřování založených na heslech, jako jsou základní, digest, PROTOKOL NTLM a Kerberos. Třídy, které implementují ICredentials rozhraní, jako CredentialCache je například třída , vrací NetworkCredential objekty.
Tato třída nepodporuje metody ověřování založené na veřejných klíčích, jako je ověřování klientů ssl (Secure Sockets Layer).
Konstruktory
NetworkCredential() |
Inicializuje novou instanci NetworkCredential třídy . |
NetworkCredential(String, SecureString) |
Inicializuje novou instanci NetworkCredential třídy se zadaným uživatelským jménem a heslem. |
NetworkCredential(String, SecureString, String) |
Inicializuje novou instanci NetworkCredential třídy se zadaným uživatelským jménem, heslem a doménou. |
NetworkCredential(String, String) |
Inicializuje novou instanci NetworkCredential třídy se zadaným uživatelským jménem a heslem. |
NetworkCredential(String, String, String) |
Inicializuje novou instanci NetworkCredential třídy se zadaným uživatelským jménem, heslem a doménou. |
Vlastnosti
Domain |
Získá nebo nastaví název domény nebo počítače, který ověřuje pověření. |
Password |
Získá nebo nastaví heslo pro uživatelské jméno přidružené k přihlašovacím údajům. |
SecurePassword |
Získá nebo nastaví heslo jako SecureString instanci. |
UserName |
Získá nebo nastaví uživatelské jméno přidružené k přihlašovacím údajům. |
Metody
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
GetCredential(String, Int32, String) |
Vrátí instanci NetworkCredential třídy pro zadaného hostitele, port a typ ověřování. |
GetCredential(Uri, String) |
Vrátí instanci NetworkCredential třídy pro zadaný identifikátor URI (Uniform Resource Identifier) a typ ověřování. |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |