NetworkCredential Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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://zcusa.951200.xyz/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://zcusa.951200.xyz/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://zcusa.951200.xyz/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) |