NetworkCredential Clase

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.Primitives.dll

Source:

NetworkCredential.cs

Proporciona credenciales para esquemas de autenticación basados en contraseña, como la autenticación básica, implícita, NTLM y 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

Herencia

Object

NetworkCredential

Implementaciones

ICredentials ICredentialsByHost

Ejemplos

En el ejemplo de código siguiente se asocia un NetworkCredential objeto a un conjunto de identificadores uniformes de recursos (URI) en un CredentialCache. A continuación, pasa el CredentialCache objeto a un HttpClient objeto , que lo usa para autenticar las solicitudes en un 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
})

Comentarios

La NetworkCredential clase es una clase base que proporciona credenciales en esquemas de autenticación basados en contraseña, como basic, digest, NTLM y Kerberos. Las clases que implementan la ICredentials interfaz, como la CredentialCache clase , devuelven NetworkCredential objetos.

Esta clase no admite métodos de autenticación públicos basados en claves, como la autenticación de cliente de Capa de sockets seguros (SSL).

Constructores

NetworkCredential()	Inicializa una nueva instancia de la clase NetworkCredential.
NetworkCredential(String, SecureString)	Inicializa una nueva instancia de la clase NetworkCredential con el nombre de usuario y la contraseña especificados.
NetworkCredential(String, SecureString, String)	Inicializa una nueva instancia de la clase NetworkCredential con el nombre de usuario, la contraseña y el dominio especificados.
NetworkCredential(String, String)	Inicializa una nueva instancia de la clase NetworkCredential con el nombre de usuario y la contraseña especificados.
NetworkCredential(String, String, String)	Inicializa una nueva instancia de la clase NetworkCredential con el nombre de usuario, la contraseña y el dominio especificados.

Propiedades

Domain	Obtiene o establece el nombre de equipo o dominio que comprueba las credenciales.
Password	Obtiene o establece la contraseña del nombre de usuario asociada a las credenciales.
SecurePassword	Obtiene o establece la contraseña como una instancia de SecureString.
UserName	Obtiene o establece el nombre de usuario asociado a las credenciales.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetCredential(String, Int32, String)	Devuelve una instancia de la clase NetworkCredential para el host, el puerto y el tipo de autenticación especificados.
GetCredential(Uri, String)	Devuelve una instancia de la clase NetworkCredential para el identificador uniforme de recursos (URI) y el tipo de autenticación especificados.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)