Compartilhar via


NetworkCredential Classe

Definição

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 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
Herança
NetworkCredential
Implementações

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)

Aplica-se a