NetworkCredential Classe

Definição

Namespace:

System.Net

Assembly:

System.Net.Primitives.dll

Origem:

NetworkCredential.cs

Fornece credenciais para esquemas de autenticação baseada em senha como Básica, resumo, NTLM e 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

Herança

Object

NetworkCredential

Implementações

ICredentials ICredentialsByHost

Exemplos

O exemplo de código a seguir associa um NetworkCredential objeto a um conjunto de URIs (Uniform Resource Identifiers) em um CredentialCache. Em seguida, ele passa o CredentialCache para um HttpClient objeto , que o usa para autenticar solicitações para um servidor de 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
})

Comentários

A NetworkCredential classe é uma classe base que fornece credenciais em esquemas de autenticação baseados em senha, como básico, digest, NTLM e Kerberos. Classes que implementam a ICredentials interface, como a CredentialCache classe , retornam NetworkCredential objetos .

Essa classe não dá suporte a métodos de autenticação baseados em chave pública, como autenticação de cliente SSL (Secure Sockets Layer).

Construtores

NetworkCredential()	Inicializa uma nova instância da classe NetworkCredential.
NetworkCredential(String, SecureString)	Inicializa uma nova instância da classe NetworkCredential com o nome de usuário e senha especificados.
NetworkCredential(String, SecureString, String)	Inicializa uma nova instância da classe NetworkCredential com o nome de usuário, senha e domínio especificados.
NetworkCredential(String, String)	Inicializa uma nova instância da classe NetworkCredential com o nome de usuário e senha especificados.
NetworkCredential(String, String, String)	Inicializa uma nova instância da classe NetworkCredential com o nome de usuário, senha e domínio especificados.

Propriedades

Domain	Obtém ou define o nome de domínio ou do computador que verifica as credenciais.
Password	Obtém ou define a senha para o nome de usuário associado às credenciais.
SecurePassword	Obtém ou define a senha como uma instância SecureString.
UserName	Obtém ou define o nome de usuário associado às credenciais.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetCredential(String, Int32, String)	Retorna uma instância da classe NetworkCredential para o host, porta e tipo de autenticação especificados.
GetCredential(Uri, String)	Retorna uma instância da classe NetworkCredential do URI (Uniform Resource Identifier) e do tipo de autenticação.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)